ambient

class off.ambient.AmbientCorrector(settings_cor: dict, nT: int, states_name: List[str])

Bases: object

update(t: float)

updates the corrector buffer

Parameters:

t (float) – current time in s

class off.ambient.AmbientStates(number_of_time_steps: int, number_of_states: int, state_names: list)

Bases: States, ABC

abstract create_interpolated_state(index1: int, index2: int, w1, w2)

Creates an AmbientStates object of its own kind with only one state entry, based on two weighted states. The returned object then still has access to functions such as get_turbine_wind_dir()

Parameters:
  • index1 (int) – Index of the first state

  • index2 (int) – Index of the second state

  • w1 (float) – Weight for first index (has to be w1 = 1 - w2, and [0,1])

  • w2 (float) – Weight for second index (has to be w2 = 1 - w1, and [0,1])

Returns:

ambient state object with single entry

Return type:

AmbientStates

abstract get_turbine_wind_dir() float

Returns wind direction at the turbine location

Returns:

wind direction (deg)

Return type:

float

abstract get_turbine_wind_speed() ndarray

Returns u,v component wind speed at the turbine location

Returns:

1 x 2 vector of [u,v] wind speeds in m/s

Return type:

np.ndarray

abstract get_turbine_wind_speed_abs() float

Returns the absolute wind speed at the turbine location (first entry)

Returns:

absolute wind speed

Return type:

float

abstract get_turbine_wind_speed_u() float

Returns the u component of the wind speed (x direction) at the turbine location

Returns:

u wind speed

Return type:

float

abstract get_turbine_wind_speed_v() float

Returns the v component of the wind speed (y direction) at the turbine location

Returns:

v wind speed

Return type:

float

abstract get_wind_dir() ndarray

Returns all wind directions

Returns:

m x 1 vector of wind direction states in deg

Return type:

np.ndarray

abstract get_wind_dir_ind(ind: int)

Returns wind directions at an index

Parameters:

ind (int) – Index

Returns:

m x 1 vector of wind direction states in deg

Return type:

np.ndarray

abstract get_wind_speed() ndarray

Returns u,v component of all wind speeds

Returns:

m x 2 matrix of [u,v] wind speeds in m/s

Return type:

np.ndarray

abstract get_wind_speed_abs() ndarray

Returns the absolute wind speed

Returns:

m x 1 vector of the absolute wind speed in m/s

Return type:

np.ndarray

abstract get_wind_speed_u() ndarray

Returns the u component of the wind speed (x direction)

Returns:

m x 1 vector of the u wind speed in m/s

Return type:

np.ndarray

abstract get_wind_speed_v() ndarray

Returns the v component of the wind speed (y direction)

Returns:

m x 1 vector of the v wind speed in m/s

Return type:

np.ndarray

class off.ambient.FLORIDynAmbient(number_of_time_steps: int)

Bases: AmbientStates

create_interpolated_state(index1: int, index2: int, w1, w2)

Creates an AmbientStates object of its own kind with only one state entry, based on two weighted states. The returned object then still has access to functions such as get_turbine_wind_dir()

Parameters:
  • index1 (int) – Index of the first state

  • index2 (int) – Index of the second state

  • w1 (float) – Weight for first index (has to be w1 = 1 - w2, and [0,1])

  • w2 (float) – Weight for second index (has to be w2 = 1 - w1, and [0,1])

Returns:

ambient state object with single entry

Return type:

AmbientStates

get_turbine_wind_dir() float

Returns all wind directions

Returns:

float of wind direction state at the turbine location in deg

get_turbine_wind_speed() ndarray

Returns u,v component of u & v wind speed at the turbine location

Returns:

1 x 2 matrix of [u,v] wind speeds in m/s

Return type:

np.ndarray

get_turbine_wind_speed_abs() float

Returns the absolute wind speed at the turbine location (first entry)

Returns:

absolute wind speed

Return type:

float

get_turbine_wind_speed_u() float

Returns the u component of the wind speed (x direction) at the turbine location

Returns:

u wind speed

Return type:

float

get_turbine_wind_speed_v() float

Returns the v component of the wind speed (y direction) at the turbine location

Returns:

v wind speed

Return type:

float

get_wind_dir() ndarray

Returns all stored wind directions

Returns:

m x 1 vector of wind direction states in deg

get_wind_dir_ind(ind: int)

Returns wind directions at an index

Parameters:

ind (int) – Index

Returns:

m x 1 vector of wind direction states in deg

Return type:

np.ndarray

get_wind_direction_at(location: ndarray, op_coord: ndarray)

Returns the wind direction at a requested location

Parameters:
  • location (np.ndarray) – m x 3 matrix where the columns are [x,y,z] locations in m

  • op_coord (np.ndarray) – n x 3 matrix of the OP world coordinate states in m

Returns:

m x 1 vector with absolute wind speeds in deg

Return type:

np.ndarray

get_wind_speed() ndarray

Returns u,v component of all wind speeds

Returns:

m x 2 matrix of [u,v] wind speeds in m/s

Return type:

np.ndarray

get_wind_speed_abs() ndarray

Returns the absolute wind speed

Returns:

m x 1 vector of the absolute wind speed in m/s

Return type:

np.ndarray

get_wind_speed_at(location: ndarray, op_coord: ndarray) ndarray

Returns the absolute wind speed at a requested location

Parameters:
  • location (np.ndarray) – m x 3 matrix where the columns are [x,y,z] locations in m

  • op_coord (np.ndarray) – n x 3 matrix of the OP world coordinate states in m

Returns:

m x 1 vector with absolute wind speeds in m/s

Return type:

np.ndarray

get_wind_speed_u() ndarray

Returns the u component of the wind speed (x direction)

Returns:

m x 1 vector of the u wind speed in m/s

Return type:

np.ndarray

get_wind_speed_v() ndarray

Returns the v component of the wind speed (y direction)

Returns:

m x 1 vector of the v wind speed in m/s

Return type:

np.ndarray