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

Parameters needed to evaluate the power and thrust produced by the turbine.

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

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.