Modeling Options Inputs

The following inputs describe the options available in the modeling_options file. This example is from the 02_reference_turbines case in the examples directory.

# Generic modeling options file to run standard WISDEM case
General:
    verbosity: False  # When set to True, the code prints to screen many infos
WISDEM:
    RotorSE:
        flag: True
        spar_cap_ss: Spar_Cap_SS # Name in the yaml of the spar cap laminate on the suction side
        spar_cap_ps: Spar_Cap_PS # Name in the yaml of the spar cap laminate on the suction side
        te_ss: TE_reinforcement_SS # Name in the yaml of the spar cap laminate on the suction side
        te_ps: TE_reinforcement_PS # Name in the yaml of the spar cap laminate on the suction side
    DriveSE:
        flag: True
    TowerSE:             # Options of TowerSE module
        flag: True
    FixedBottomSE:
        flag: True
        soil_springs: True
    BOS:
        flag: True

General

verbosityBoolean

Prints additional outputs to screen (and to a file log in the future)

Default = False

RotorSE

flagBoolean

Whether or not to run RotorSE and ServoSE

Default = False

n_aoaInteger

Number of angles of attack in a common grid to define polars

Default = 200

n_xyInteger

Number of coordinate point used to define airfoils

Default = 200

n_spanInteger

Number of spanwise stations in a common grid used to define blade properties

Default = 30

n_pcInteger

Number of wind speeds to compute the power curve

Default = 20

n_pc_splineInteger

Number of wind speeds to spline the power curve

Default = 200

n_pitch_perf_surfacesInteger

Number of pitch angles to determine the Cp-Ct-Cq-surfaces

Default = 20

min_pitch_perf_surfacesFloat

Min pitch angle of the Cp-Ct-Cq-surfaces

Default = -5.0

max_pitch_perf_surfacesFloat

Max pitch angle of the Cp-Ct-Cq-surfaces

Default = 30.0

n_tsr_perf_surfacesInteger

Number of tsr values to determine the Cp-Ct-Cq-surfaces

Default = 20

min_tsr_perf_surfacesFloat

Min TSR of the Cp-Ct-Cq-surfaces

Default = 2.0

max_tsr_perf_surfacesFloat

Max TSR of the Cp-Ct-Cq-surfaces

Default = 12.0

n_U_perf_surfacesInteger

Number of wind speeds to determine the Cp-Ct-Cq-surfaces

Default = 1

regulation_reg_IIIBoolean

Flag to derive the regulation trajectory in region III in terms of pitch and TSR

Default = False

spar_cap_ssString

Composite layer modeling the spar cap on the suction side in the geometry yaml. This entry is used to compute ultimate strains and it is linked to the design variable spar_cap_ss.

Default = none

spar_cap_psString

Composite layer modeling the spar cap on the pressure side in the geometry yaml. This entry is used to compute ultimate strains and it is linked to the design variable spar_cap_ps.

Default = none

te_ssString

Composite layer modeling the trailing edge reinforcement on the suction side in the geometry yaml. This entry is used to compute ultimate strains and it is linked to the design variable te_ss.

Default = none

te_psString

Composite layer modeling the trailing edge reinforcement on the pressure side in the geometry yaml. This entry is used to compute ultimate strains and it is linked to the design variable te_ps.

Default = none

gamma_freqFloat

Partial safety factor for modal frequencies

Default = 1.1

Minimum = 1.0 Maximum = 5.0

gust_stdFloat

Number of standard deviations for strength of gust

Default = 3.0

Minimum = 0.0 Maximum = 5.0

root_fastener_s_fFloat

Safety factor for the max stress of blade root fasteners

Default = 2.5

Minimum = 0.1 Maximum = 1.e+2

DriveSE

flagBoolean

Whether or not to run RotorSE and ServoSE

Default = False

model_generatorBoolean

Whether or not to do detailed generator modeling using tools formerly in GeneratorSE

Default = False

gamma_fFloat

Partial safety factor on loads

Default = 1.35

Minimum = 1.0 Maximum = 5.0

gamma_mFloat

Partial safety factor for materials

Default = 1.3

Minimum = 1.0 Maximum = 5.0

gamma_nFloat

Partial safety factor for consequence of failure

Default = 1.0

Minimum = 1.0 Maximum = 5.0

hub

hub_gammaFloat

Partial safety factor for hub sizing

Default = 2.0

Minimum = 1.0 Maximum = 5.0

spinner_gammaFloat

Partial safety factor for spinner sizing

Default = 1.5

Minimum = 1.0 Maximum = 5.0

TowerSE

flagBoolean

Whether or not to run RotorSE and ServoSE

Default = False

nLCInteger

Number of load cases

Default = 1

windString from, [‘PowerWind’, ‘LogisticWind’]

Wind scaling relationship with height

Default = PowerWind

gamma_fFloat

Partial safety factor on loads

Default = 1.35

Minimum = 1.0 Maximum = 5.0

gamma_mFloat

Partial safety factor for materials

Default = 1.3

Minimum = 1.0 Maximum = 5.0

gamma_nFloat

Partial safety factor for consequence of failure

Default = 1.0

Minimum = 1.0 Maximum = 5.0

gamma_bFloat

Partial safety factor for buckling

Default = 1.1

Minimum = 1.0 Maximum = 5.0

gamma_freqFloat

Partial safety factor for modal frequencies

Default = 1.1

Minimum = 1.0 Maximum = 5.0

gamma_fatigueFloat

Partial safety factor for fatigue failure

Default = 1.0

Minimum = 1.0 Maximum = 5.0

buckling_lengthFloat, m

Buckling length factor in Eurocode safety check

Default = 1.0

Minimum = 1.0 Maximum = 100.0

frame3dd

Set of Frame3DD options used for tower analysis

shearBoolean

Inclusion of shear area for symmetric sections

Default = True

geomBoolean

Inclusion of shear stiffening through axial loading

Default = True

nMInteger

Number of tower eigenvalue modes to calculate

Default = 6

Minimum = 0 Maximum = 20

tolFloat

Convergence tolerance for modal eigenvalue solution

Default = 1e-09

Minimum = 1e-12 Maximum = 0.1

BOS

flagBoolean

Whether or not to run balance of station cost models (LandBOSSE or ORBIT)

Default = False

FloatingSE

flagBoolean

Whether or not to run the floating design modules (FloatingSE)

Default = False

Loading

This is only used if not running the full WISDEM turbine Group and you need to input the mass properties, forces, and moments for a tower-only or nacelle-only analysis

massFloat, kilogram

Mass at external boundary of the system. For the tower, this would be the RNA mass.

Default = 0.0

center_of_massArray of Floats, meter

Distance from system boundary to center of mass of the applied load. For the tower, this would be the RNA center of mass in tower-top coordinates.

Default = [0.0, 0.0, 0.0]

moment_of_inertiaArray of Floats, kg*m^2

Moment of inertia of external mass in coordinate system at the system boundary. For the tower, this would be the RNA MoI in tower-top coordinates.

Default = [0.0, 0.0, 0.0, 0.0, 0.0, 0.0]

loads

forceArray of Floats, Newton

Force vector applied at system boundary

Default = [0.0, 0.0, 0.0]

momentArray of Floats, N*m

Force vector applied at system boundary

Default = [0.0, 0.0, 0.0]

velocityFloat, meter

Applied wind reference velocity, if necessary

Default = 0.0