kynema::interfaces::components::TurbineInput Struct Reference

Complete input specification for a turbine. More...

#include <turbine_input.hpp>

Public Attributes
std::vector< BeamInput >	blades
	Configuration for the turbine blades.
BeamInput	tower
	Configuration for the tower structure.
std::array< std::array< double, 6 >, 6 >	yaw_bearing_inertia_matrix {}
	Yaw bearing inertia matrix (6x6)
bool	yaw_bearing_inertia_matrix_set {false}
	Flag indicating if yaw_bearing inertia matrix has been set.
std::array< std::array< double, 6 >, 6 >	hub_inertia_matrix {}
	Hub inertia matrix (6x6)
std::array< std::array< double, 6 >, 6 >	nacelle_inertia_matrix {}
	Nacelle inertia matrix (6x6)
bool	nacelle_inertia_matrix_set {false}
	Flag indicating if nacelle inertia matrix has been set.
std::array< double, 3 >	nacelle_cm_offset {}
	Nacelle center of mass offset from the yaw bearing (meters)
std::array< double, 7 >	tower_base_position {0., 0., 0., 1., 0., 0., 0.}
	Position of the tower base node in the global coordinate system.
double	tower_axis_to_rotor_apex {0.}
	Horizontal distance between the tower axis -> rotor apex (meters)
double	tower_top_to_rotor_apex {0.}
	Vertical distance between the tower top -> rotor apex (meters)
double	rotor_apex_to_hub {0.}
	Distance from rotor apex -> hub center of mass (meters)
double	hub_diameter {1e-7}
	Hub diameter (meters)
double	nacelle_yaw_angle {0.}
	Initial nacelle yaw angle (radians)
double	shaft_tilt_angle {0.}
	Shaft tilt angle (radians)
double	cone_angle {0.}
	Blade cone angle (radians)
double	blade_pitch_angle {0.}
	Initial blade pitch angle (radians)
double	azimuth_angle {0.}
	Current rotor azimuth angle (radians)
double	rotor_speed {0.}
	Initial rotor rotational speed (rad/s)
double	gear_box_ratio {1.}
	Gearbox ratio of the turbine (-)
double	generator_efficiency {1.}
	Generator efficiency (-)
double	generator_power {0.}
	Initial generator power (W)
double	hub_wind_speed {0.}
	Hub height wind speed (m/s)

Detailed Description

Complete input specification for a turbine.

This structure defines all necessary parameters to configure a complete wind turbine model including the structural components (blades, tower, hub, nacelle), geometric relationships, inertial properties, and initial operating conditions.

Member Data Documentation

azimuth_angle

double kynema::interfaces::components::TurbineInput::azimuth_angle {0.}

Current rotor azimuth angle (radians)

Angular position of rotor about shaft axis. 0 means blade 1 is at 12 o'clock position.

blade_pitch_angle

double kynema::interfaces::components::TurbineInput::blade_pitch_angle {0.}

Initial blade pitch angle (radians)

Rotation of blades about their longitudinal/pitch axis. 0 means blades are parallel to the tower.

blades

std::vector<BeamInput> kynema::interfaces::components::TurbineInput::blades

Configuration for the turbine blades.

Each blade is represented as a flexible beam. Vector contains BeamInput for each blade of the turbine.

cone_angle

double kynema::interfaces::components::TurbineInput::cone_angle {0.}

Blade cone angle (radians)

Angle between the blade and the plane perpendicular to shaft

gear_box_ratio

double kynema::interfaces::components::TurbineInput::gear_box_ratio {1.}

Gearbox ratio of the turbine (-)

Ratio between generator speed and rotor speed

generator_efficiency

double kynema::interfaces::components::TurbineInput::generator_efficiency {1.}

Generator efficiency (-)

Ratio of mechanical power output to electrical power output

generator_power

double kynema::interfaces::components::TurbineInput::generator_power {0.}

Initial generator power (W)

Power output of the generator

hub_diameter

double kynema::interfaces::components::TurbineInput::hub_diameter {1e-7}

Hub diameter (meters)

Distance from rotor apex to blade root node.

Note

Default value is near-zero to avoid singularities

hub_inertia_matrix

std::array<std::array<double, 6>, 6> kynema::interfaces::components::TurbineInput::hub_inertia_matrix {}

Hub inertia matrix (6x6)

Includes hub assembly mass and inertia properties

hub_wind_speed

double kynema::interfaces::components::TurbineInput::hub_wind_speed {0.}

Hub height wind speed (m/s)

Wind speed at the hub height

nacelle_cm_offset

std::array<double, 3> kynema::interfaces::components::TurbineInput::nacelle_cm_offset {}

Nacelle center of mass offset from the yaw bearing (meters)

nacelle_inertia_matrix

std::array<std::array<double, 6>, 6> kynema::interfaces::components::TurbineInput::nacelle_inertia_matrix {}

Nacelle inertia matrix (6x6)

Includes nacelle mass and inertia properties

nacelle_inertia_matrix_set

bool kynema::interfaces::components::TurbineInput::nacelle_inertia_matrix_set {false}

Flag indicating if nacelle inertia matrix has been set.

nacelle_yaw_angle

double kynema::interfaces::components::TurbineInput::nacelle_yaw_angle {0.}

Initial nacelle yaw angle (radians)

Rotation of nacelle about the tower/yaw axis.

rotor_apex_to_hub

double kynema::interfaces::components::TurbineInput::rotor_apex_to_hub {0.}

Distance from rotor apex -> hub center of mass (meters)

Along the rotor shaft axis, accounts for hub geometry. Also known as HubCM.

rotor_speed

double kynema::interfaces::components::TurbineInput::rotor_speed {0.}

Initial rotor rotational speed (rad/s)

Rotational velocity about the shaft axis

shaft_tilt_angle

double kynema::interfaces::components::TurbineInput::shaft_tilt_angle {0.}

Shaft tilt angle (radians)

Angle between the rotor shaft and the horizontal plane. Positive angle tilts shaft up.

tower

BeamInput kynema::interfaces::components::TurbineInput::tower

Configuration for the tower structure.

Defines the tower as a beam element from base to top

tower_axis_to_rotor_apex

double kynema::interfaces::components::TurbineInput::tower_axis_to_rotor_apex {0.}

Horizontal distance between the tower axis -> rotor apex (meters)

tower_base_position

std::array<double, 7> kynema::interfaces::components::TurbineInput::tower_base_position {0., 0., 0., 1., 0., 0., 0.}

Position of the tower base node in the global coordinate system.

Defines the initial location/orientation of the entire turbine.

tower_top_to_rotor_apex

double kynema::interfaces::components::TurbineInput::tower_top_to_rotor_apex {0.}

Vertical distance between the tower top -> rotor apex (meters)

yaw_bearing_inertia_matrix

std::array<std::array<double, 6>, 6> kynema::interfaces::components::TurbineInput::yaw_bearing_inertia_matrix {}

Yaw bearing inertia matrix (6x6)

Includes yaw bearing and nacelle mass with inertia about yaw bearing

yaw_bearing_inertia_matrix_set

bool kynema::interfaces::components::TurbineInput::yaw_bearing_inertia_matrix_set {false}

Flag indicating if yaw_bearing inertia matrix has been set.

---

The documentation for this struct was generated from the following file:

• /home/runner/work/kynema/kynema/kynema/src/interfaces/components/turbine_input.hpp