Wind Farm Components

Wind Farm Components#

Wind_MesoToPower#

Wind_MesoToPower is a comprehensive wind farm simulator that focuses on meso-scale phenomena by applying a separate wind speed time signal to each turbine model derived from data. It combines FLORIS wake modeling with detailed turbine dynamics for long-term wind farm performance analysis.

Wind_MesoToPowerPrecomFloris#

Wind_MesoToPowerPrecomFloris is an optimized variant of Wind_MesoToPower that pre-computes FLORIS wake deficits for improved simulation performance. This approach trades some accuracy for significant speed improvements in specific operating scenarios.

Overview#

Both wind farm components integrate FLORIS for wake effects with individual turbine models to simulate wind farm behavior over extended periods. They support both simple filter-based turbine models and 1-degree-of-freedom (1-DOF) turbine dynamics.

Precomputed FLORIS Approach#

Wind_MesoToPowerPrecomFloris pre-computes wake deficits using a fixed cadence determined by floris_update_time_s. At initialization, FLORIS is evaluated at that cadence using right-aligned time-window averages of wind speed, wind direction, and turbulence intensity. The resulting wake deficits are then held constant between evaluations and applied to the per-turbine inflow time series.

This approach is valid when the wind farm operates under these conditions:

  • All turbines operating normally

  • All turbines off

  • Following a wind-farm wide derating level

Important: This model is not appropriate when turbines are partially derated below the curtailment level or not uniformly curtailed. In such cases, use the standard Wind_MesoToPower class instead.

Configuration#

Common Required Parameters#

Required parameters for both components in h_dict (see timing for time-related parameters):

  • floris_input_file: FLORIS farm configuration

  • wind_input_filename: Wind resource data file

  • turbine_file_name: Turbine model configuration

Wind_MesoToPower Specific Parameters#

Required parameters for Wind_MesoToPower:

  • floris_update_time_s: How often to update FLORIS (the last floris_update_time_s seconds are averaged as input)

Required parameters for Wind_MesoToPower:

  • logging_option: Logging level. Options are:

    • "base": Log basic outputs (power, wind_speed, wind_direction, wind_speed_waked)

    • "turb_subset": Base outputs plus 3 random turbines’ waked_velocities, turbine_powers, and turbine_power_setpoints

    • "all": All available outputs including floris_wind_speed, floris_wind_direction, floris_ti, unwaked_velocities, waked_velocities, turbine_powers, turbine_power_setpoints

Wind_MesoToPowerPrecomFloris Specific Parameters#

Required parameters for Wind_MesoToPowerPrecomFloris:

  • floris_update_time_s: Determines the cadence of wake precomputation. At each cadence tick, the last floris_update_time_s seconds are averaged and used to evaluate FLORIS. The computed wake deficits are then applied until the next cadence tick.

  • logging_option: Logging level. Options are:

    • "base": Log basic outputs (power, wind_speed, wind_direction, wind_speed_waked)

    • "turb_subset": Base outputs plus 3 random turbines’ waked_velocities, turbine_powers, and turbine_power_setpoints

    • "all": All available outputs including floris_wind_speed, floris_wind_direction, floris_ti, unwaked_velocities, waked_velocities, turbine_powers, turbine_power_setpoints

Turbine Models#

Filter Model#

Simple first-order filter for power output smoothing with configurable time constants.

1-DOF Model#

Advanced model with rotor dynamics, pitch control, and generator torque control.

Outputs#

Common Outputs#

Both components provide these outputs:

  • power: Total wind farm power

  • turbine_powers: Individual turbine power outputs

  • turbine_power_setpoints: Current power setpoint values

  • wind_speed, wind_direction: Farm-level wind conditions

Logging Options#

The logging behavior depends on the logging_option setting:

Base Logging (logging_option: "base")#

  • power: Total wind farm power

  • wind_speed, wind_direction: Farm-level wind conditions

  • wind_speed_waked: Average waked wind speed across the farm

Turbine Subset Logging (logging_option: "turb_subset")#

Includes all base outputs plus:

  • waked_velocities_turb_XXX: Waked velocities for 3 randomly selected turbines

  • turbine_powers_turb_XXX: Power outputs for 3 randomly selected turbines

  • turbine_power_setpoints_turb_XXX: Power setpoints for 3 randomly selected turbines

Full Logging (logging_option: "all")#

Includes all base outputs plus:

  • turbine_powers: Individual turbine power outputs

  • turbine_power_setpoints: Current power setpoint values

  • floris_wind_speed: Wind speed used in FLORIS calculations

  • floris_wind_direction: Wind direction used in FLORIS calculations

  • floris_ti: Turbulence intensity values

  • unwaked_velocities: Wind speeds without wake effects

  • waked_velocities: Wind speeds with wake effects applied

Contents