Geometry Inputs

Significant effort has been invested to develop an _ontology_ for wind turbines systems analysis by the IEA Wind Task 37 on Systems Engineering, which ran between 2016 and 2022, and IEA Wind Task 55 on Reference Wind Turbines and Wind Plants <https://iea-wind.org/task55/>`_ in its windIO project. WISDEM uses the windIO turbine ontology for the physical description of the turbine, and its components, and the required level of fidelity for systems analysis.

Full documentation of windIO can be found at the windIO documentation

Note that in some turbine components WISDEM takes as input more fields than what listed in windIO. This is especially true for the drivetrain components.

The extra inputs are documented below.

WISDEM wind turbine ontology

WISDEM wind turbine ontology

Type: object

Ontology definition for wind turbines as defined in WP1 of IEA Wind Task 37 - Phase II

root components
Type: object Default: {}

root components hub
Type: object

The following properties are required:

  • diameter
  • cone_angle

root components hub flange_t2shell_t
Type: number Default: 6.0

Ratio of flange thickness to shell thickness

Value must be greater or equal to 0 and lesser or equal to 20.0

root components hub flange_OD2hub_D
Type: number Default: 0.6

Ratio of flange outer diameter to hub diameter

Value must be greater or equal to 0 and lesser or equal to 10.0

root components hub flange_ID2OD
Type: number Default: 0.8

Check this

Value must be greater or equal to 0 and lesser or equal to 10.0

root components hub hub_blade_spacing_margin
Type: number Default: 1.2

Ratio of flange thickness to shell thickness

Value must be greater or equal to 0 and lesser or equal to 20.0

root components hub hub_stress_concentration
Type: number Default: 3.0

Stress concentration factor. Stress concentration occurs at all fillets,notches, lifting lugs, hatches and are accounted for by assigning a stress concentration factor

Value must be greater or equal to 0 and lesser or equal to 20.0

root components hub n_front_brackets
Type: integer Default: 5

Number of front spinner brackets

Value must be greater or equal to 0 and lesser or equal to 20

root components hub n_rear_brackets
Type: integer Default: 5

Number of rear spinner brackets

Value must be greater or equal to 0 and lesser or equal to 20

root components hub clearance_hub_spinner
Type: number Default: 0.5

Clearance between spinner and hub

Value must be greater or equal to 0 and lesser or equal to 20.0

root components hub spin_hole_incr
Type: number Default: 1.2

Ratio between access hole diameter in the spinner and blade root diameter. Typical value 1.2

Value must be greater or equal to 0 and lesser or equal to 20.0

root components hub pitch_system_scaling_factor
Type: number Default: 0.54

Scaling factor to tune the total mass (0.54 is recommended for modern designs)

Value must be greater or equal to 0 and lesser or equal to 2.0

root components hub hub_material
Type: string

Material of the shell of the hub

root components hub spinner_material
Type: string

Material of the spinner

root components hub hub_shell_mass_user
Type: number Default: 0.0

User input override of hub shell mass calculation

Value must be greater or equal to 0.0

root components hub spinner_mass_user
Type: number Default: 0.0

User input override of hub shell mass calculation

Value must be greater or equal to 0.0

root components hub pitch_system_mass_user
Type: number Default: 0.0

Override regular regression-based calculation of pitch system mass with this value

Value must be greater or equal to 0.0

root components hub hub_system_mass_user
Type: number Default: 0.0

User input override of full hub system mass calculation

Value must be greater or equal to 0.0

root components drivetrain
Type: object

root components drivetrain bedplate
Type: object

root components drivetrain bedplate mass_user
Type: number Default: 0.0

Override regular calculation of bedplate mass with this value

Value must be greater or equal to 0.0

root components drivetrain lss
Type: object

root components drivetrain lss mass_user
Type: number Default: 0.0

User override of low speed shaft mass.

Value must be greater or equal to 0.0

root components drivetrain hss
Type: object

root components drivetrain hss mass_user
Type: number Default: 0.0

User override of high speed shaft mass.

Value must be greater or equal to 0.0

root components drivetrain other_components
Type: object

Inputs describing all other drivetrain components, the assembly of brake, hvac, converter, transformer, and main bearings

root components drivetrain other_components mb1_mass_user
Type: number Default: 0.0

Override regular regression-based calculation of first main bearing mass with this value

Value must be greater or equal to 0.0

root components drivetrain other_components mb2_mass_user
Type: number Default: 0.0

Override regular regression-based calculation of second main bearing mass with this value

Value must be greater or equal to 0.0

root components drivetrain other_components converter_mass_user
Type: number Default: 0.0

Override regular regression-based calculation of converter mass with this value

Value must be greater or equal to 0.0

root components drivetrain other_components transformer_mass_user
Type: number Default: 0.0

Override regular regression-based calculation of transformer mass with this value

Value must be greater or equal to 0.0

root components drivetrain other_components platform_mass_user
Type: number Default: 0.0

Override regular regression-based calculation of platform mass with this value

Value must be greater or equal to 0.0

root components drivetrain other_components cover_mass_user
Type: number Default: 0.0

Override regular regression-based calculation of cover mass with this value

Value must be greater or equal to 0.0

root components drivetrain elastic_properties
Type: object

root components drivetrain elastic_properties spring_constant_user
Type: number Default: 0.0

Override regular calculation of drivetrain spring constant with this value

Value must be greater or equal to 0.0

root components drivetrain elastic_properties damping_coefficient_user
Type: number Default: 0.0

Override regular calculation of drivetrain damping coefficient with this value

Value must be greater or equal to 0.0

root components drivetrain generator
Type: object

root components drivetrain generator generator_type
Type: enum (of string) Default: "DFIG"

Must be one of:

  • "DFIG"
  • "dfig"
  • "EESG"
  • "eesg"
  • "SCIG"
  • "scig"
  • "PMSG_Arms"
  • "PMSG_ARMS"
  • "pmsg_arms"
  • "PMSG_Disc"
  • "PMSG_Disk"
  • "PMSG_DISC"
  • "PMSG_DISK"
  • "pmsg_disk"
  • "pmsg_disc"
  • "PMSG_Outer"
  • "PMSG_OUTER"
  • "pmsg_outer"

root components drivetrain generator B_r
Type: number Default: 1.2

Words

Value must be greater or equal to 0.0

root components drivetrain generator P_Fe0e
Type: number Default: 1.0

Words

Value must be greater or equal to 0.0 and lesser or equal to 1000.0

root components drivetrain generator P_Fe0h
Type: number Default: 4.0

Words

Value must be greater or equal to 0.0 and lesser or equal to 1000.0

root components drivetrain generator S_N
Type: number Default: -0.002

Words

Value must be greater or equal to -100.0 and lesser or equal to 0.0

root components drivetrain generator S_Nmax
Type: number Default: -0.2

Words

Value must be greater or equal to -100.0 and lesser or equal to 0.0

root components drivetrain generator alpha_p
Type: number Default: 1.0995574287564276

Words

Value must be greater or equal to 0.0 and lesser or equal to 100.0

root components drivetrain generator b_r_tau_r
Type: number Default: 0.45

Words

Value must be greater or equal to 0.0 and lesser or equal to 100.0

root components drivetrain generator b_ro
Type: number Default: 0.004

Words

Value must be greater or equal to 0.0 and lesser or equal to 100.0

root components drivetrain generator b_s_tau_s
Type: number Default: 0.45

Words

Value must be greater or equal to 0.0 and lesser or equal to 100.0

root components drivetrain generator b_so
Type: number Default: 0.004

Words

Value must be greater or equal to 0.0 and lesser or equal to 100.0

root components drivetrain generator cofi
Type: number Default: 0.85

Words

Value must be greater or equal to 0.0 and lesser or equal to 100.0

root components drivetrain generator freq
Type: number Default: 60.0

Words

Value must be greater or equal to 1.0 and lesser or equal to 1000.0

root components drivetrain generator h_i
Type: number Default: 0.001

Words

Value must be greater or equal to 0.0 and lesser or equal to 1.0

root components drivetrain generator h_sy0
Type: number Default: 0.0

Words

Value must be greater or equal to 0.0 and lesser or equal to 100.0

root components drivetrain generator h_w
Type: number Default: 0.005

Words

Value must be greater or equal to 0.0 and lesser or equal to 1.0

root components drivetrain generator k_fes
Type: number Default: 0.9

Words

Value must be greater or equal to 0.0 and lesser or equal to 100.0

root components drivetrain generator k_fillr
Type: number Default: 0.7

Words

Value must be greater or equal to 0.0 and lesser or equal to 100.0

root components drivetrain generator k_fills
Type: number Default: 0.65

Words

Value must be greater or equal to 0.0 and lesser or equal to 100.0

root components drivetrain generator k_s
Type: number Default: 0.2

Words

Value must be greater or equal to 0.0 and lesser or equal to 100.0

root components drivetrain generator m
Type: integer Default: 3

Words

Value must be greater or equal to 0 and lesser or equal to 100

root components drivetrain generator mu_0
Type: number Default: 1.2566370614359173e-06

Permittivity of free space

Value must be greater or equal to 0.0 and lesser or equal to 1.0

root components drivetrain generator mu_r
Type: number Default: 1.06

Words

Value must be greater or equal to 0.0 and lesser or equal to 100.0

root components drivetrain generator p
Type: number Default: 3.0

Words

Value must be greater or equal to 0.0 and lesser or equal to 100.0

root components drivetrain generator phi
Type: number Default: 90

Words

Value must be greater or equal to 0.0 and lesser or equal to 180.0

root components drivetrain generator q1
Type: integer Default: 6

Words

Value must be greater or equal to 0 and lesser or equal to 100

root components drivetrain generator q3
Type: integer Default: 4

Words

Value must be greater or equal to 0 and lesser or equal to 100

root components drivetrain generator ratio_mw2pp
Type: number Default: 0.7

Words

Value must be greater or equal to 0.0 and lesser or equal to 100.0

root components drivetrain generator resist_Cu
Type: number Default: 2.52

Resistiity of copper

Value must be greater or equal to 0.0 and lesser or equal to 100.0

root components drivetrain generator sigma
Type: number Default: 40000.0

Maximum allowable shear stress

Value must be greater or equal to 0.0 and lesser or equal to 100000000.0

root components drivetrain generator y_tau_p
Type: number Default: 1.0

Words

Value must be greater or equal to 0.0 and lesser or equal to 100.0

root components drivetrain generator y_tau_pr
Type: number Default: 0.83333333

Words

Value must be greater or equal to 0.0 and lesser or equal to 100.0

root components drivetrain generator I_0
Type: number Default: 0.0

Words

Value must be greater or equal to 0.0 and lesser or equal to 100.0

root components drivetrain generator d_r
Type: number Default: 0.0

Words

Value must be greater or equal to 0.0 and lesser or equal to 100.0

root components drivetrain generator h_m
Type: number Default: 0.0

Words

Value must be greater or equal to 0.0 and lesser or equal to 100.0

root components drivetrain generator h_0
Type: number Default: 0.0

Words

Value must be greater or equal to 0.0 and lesser or equal to 100.0

root components drivetrain generator h_s
Type: number Default: 0.0

Words

Value must be greater or equal to 0.0 and lesser or equal to 100.0

root components drivetrain generator len_s
Type: number Default: 0.0

Words

Value must be greater or equal to 0.0 and lesser or equal to 100.0

root components drivetrain generator n_r
Type: number Default: 0.0

Words

Value must be greater or equal to 0.0 and lesser or equal to 100.0

root components drivetrain generator rad_ag
Type: number Default: 0.0

Words

Value must be greater or equal to 0.0 and lesser or equal to 100.0

root components drivetrain generator t_wr
Type: number Default: 0.0

Words

Value must be greater or equal to 0.0 and lesser or equal to 100.0

root components drivetrain generator n_s
Type: number Default: 0.0

Words

Value must be greater or equal to 0.0 and lesser or equal to 100.0

root components drivetrain generator b_st
Type: number Default: 0.0

Words

Value must be greater or equal to 0.0 and lesser or equal to 100.0

root components drivetrain generator d_s
Type: number Default: 0.0

Words

Value must be greater or equal to 0.0 and lesser or equal to 100.0

root components drivetrain generator t_ws
Type: number Default: 0.0

Words

Value must be greater or equal to 0.0 and lesser or equal to 100.0

root components drivetrain generator rho_Copper
Type: number Default: 8900.0

Copper ensity

Value must be greater or equal to 0.0 and lesser or equal to 100000.0

root components drivetrain generator rho_Fe
Type: number Default: 7700.0

Structural steel density

Value must be greater or equal to 0.0 and lesser or equal to 100000.0

root components drivetrain generator rho_Fes
Type: number Default: 7850.0

Electrical steel density

Value must be greater or equal to 0.0 and lesser or equal to 100000.0

root components drivetrain generator rho_PM
Type: number Default: 7450.0

Permanent magnet density

Value must be greater or equal to 0.0 and lesser or equal to 100000.0

root components drivetrain generator C_Cu
Type: number Default: 4.786

Copper cost

Value must be greater or equal to 0.0 and lesser or equal to 100.0

root components drivetrain generator C_Fe
Type: number Default: 0.556

Structural steel cost

Value must be greater or equal to 0.0 and lesser or equal to 100.0

root components drivetrain generator C_Fes
Type: number Default: 0.50139

Electrical steel cost

Value must be greater or equal to 0.0 and lesser or equal to 100.0

root components drivetrain generator C_PM
Type: number Default: 50.0

Permanent magnet cost

Value must be greater or equal to 0.0 and lesser or equal to 100.0

root components yaw
Type: object Default: {}

root components yaw yaw_system_mass_user
Type: number Default: 0.0

Override regular regression-based calculation of yaw mass with this value

Value must be greater or equal to 0.0

root components floating_platform
Type: object

root components floating_platform members
Type: array of object
No Additional Items

Each item of this array must be:

root components floating_platform members members items
Type: object

root components floating_platform members members items member_mass_user
Type: number Default: 0.0

Override bottom-up calculation of total member mass with this value

Value must be greater or equal to 0.0

root components floating_platform members members items no_intersect
Type: boolean Default: false

This member is parallel to another and intersecting "ghost nodes" should not be calculated. An example is a heave plate.

root components jacket
Type: object

root components jacket jacket_mass_user
Type: number Default: 0.0

Override bottom-up calculation of total jacket mass with this value

Value must be greater or equal to 0.0

root control
Type: object Default: {}

root control max_allowable_blade_tip_speed
Type: number Default: 0.0

Maximum allowable blade tip speed in m/s. If zero, no tip speed limit is enforced.

root control peak_thrust_shaving
Type: number Default: 0.8

Scalar applied to the max thrust within RotorSE for peak thrust shaving. If 1, no shaving is applied.

Value must be greater or equal to 0.0 and lesser or equal to 1.0