Turbine Input File Reference

Turbine Input File Reference#

The turbine input file is an optional input used to define a custom turbine type. The file must be YAML format with either "yaml" or "yml" extension. See for more information on inspecting and creating the turbine definition.

turbine_type

An ID for this type of turbine definition. This is not currently used, but it will be enabled in the future. This should typically match the root name of the file.

hub_height

Hub height.

rotor_diameter

Rotor diameter.

TSR

Tip speed ratio defined as linear blade tip speed normalized by the incoming wind speed.

operation_model

Model for power and thrust curve interpretation.

power_thrust_table

ref_air_density: The air density at which the power and thrust_coefficient curves are defined.
ref_tilt: The tilt angle at which the Cp and Ct curves are defined. This is used to capture the effects of a floating platform on a turbine's power and wake.
cosine_loss_exponent_tilt: Cosine exponent for power loss due to tilt.
cosine_loss_exponent_yaw: Cosine exponent for power loss due to yaw misalignment.
helix_a: Helix parameters
peak_shaving_fraction: Fraction of peak thrust by which to reduce
wind_speed: wind speeds for look-up tables of power and thrust_coefficient
power: power values (specified in kW) for lookup by wind speed
thrust_coefficient: thrust coefficient values (unitless) for lookup by wind speed

multi_dimensional_cp_ct

A boolean flag used when the user wants FLORIS to use the user-supplied multi-dimensional Cp/Ct information.

power_thrust_data_file

The path to the .csv file that contains the multi-dimensional Cp/Ct data. The format of this file is such that any external conditions, such as wave height or wave period, that the Cp/Ct data is dependent on come first, in column format. The last three columns of the .csv file must be ws, Cp, and Ct, in that order. An example of fictional data is given in floris/turbine_library/iea_15MW_multi_dim_Tp_Hs.csv.