floris.turbine_library.turbine_utilities

floris.turbine_library.turbine_utilities#

Functions

build_cosine_loss_turbine_dict(...[, ...])

Tool for formatting a full turbine dict from data formatted as a dictionary.

check_smooth_power_curve(power[, tolerance])

Check whether there are "wiggles" in the power signal.

floris.turbine_library.turbine_utilities.build_cosine_loss_turbine_dict(turbine_data_dict, turbine_name, file_name=None, generator_efficiency=None, hub_height=90.0, cosine_loss_exponent_yaw=1.88, cosine_loss_exponent_tilt=1.88, rotor_diameter=125.88, TSR=8.0, ref_air_density=1.225, ref_tilt=5.0)[source]#

Tool for formatting a full turbine dict from data formatted as a dictionary.

Default value for turbine physical parameters are from the NREL 5MW reference wind turbine.

Returns a turbine dictionary object as expected by FLORIS. Optionally, prints the dictionary to a yaml to be included in a FLORIS wake model yaml.

turbine_data is a dictionary that contains keys specifying the turbine power and thrust as a function of wind speed. The following keys are possible: - wind_speed [m/s] - power [kW] - power_coefficient [-] - thrust [kN] - thrust_coefficient [-] Of these, wind_speed is required. One of power and power_coefficient must be specified; and one of thrust and thrust_coefficient must be specified. If both (absolute) and _coefficient versions are specified, the (absolute) power will be used along with the thrust_coefficient, with the other entries ignored.

Args:
turbine_data_dict (dict): Dictionary containing performance of the wind

turbine as a function of wind speed. Described in more detail above.

turbine_name (string): Name of the turbine, which will be used for the

turbine_type field as well as the filename.

file_name (): Name for the produced yaml, including possibly path.

Defaults to None, in which case no yaml is written.

generator_efficiency (float): Generator efficiency [-]. Unused if power is specified

in absolute terms in the turbine_data_dict. Must be specified if power not specified and power_coefficient specified instead. Defaults to None.

hub_height (float): Hub height [m]. Defaults to 90.0. cosine_loss_exponent_yaw (float): Cosine exponent for power loss to yaw [-].

Defaults to 1.88.

cosine_loss_exponent_tilt (float): Cosine exponent for thrust loss to yaw [-].

Defaults to 1.88.

rotor_diameter (float). Rotor diameter [m]. Defaults to 126.0. TSR (float). Turbine optimal tip-speed ratio [-]. Defaults to 8.0. ref_air_density (float). Air density used to specify power and thrust

curves [kg/m^3]. Defaults to 1.225.

ref_tilt (float). Rotor tilt (due to shaft tilt and/or platform

tilt) used when defining the power and thrust curves [deg]. Defaults to 5.0.

Returns:

turbine_dict (dict): Formatted turbine dictionary as expected by FLORIS.

floris.turbine_library.turbine_utilities.check_smooth_power_curve(power, tolerance=0.001)[source]#

Check whether there are "wiggles" in the power signal.