Wind Turbine Translation#

Translation between windIO wind farm data and windkit turbine structures.

Wind Turbine Layouts#

from windkit.io.windio import read_plant, write_plant
from windkit.io.windio import wind_turbines_from_windio, wind_turbines_to_windio

# Import
turbines = wind_turbines_from_windio(read_plant("wind_farm.yaml"), crs="EPSG:32632")

# Export
write_plant(wind_turbines_to_windio(turbines), "output.yaml")

Field mapping:

windIO

windkit

layouts[0].coordinates.x

west_east

layouts[0].coordinates.y

south_north

layouts[0].coordinates.z

height (or from turbine_types[].hub_height)

layouts[0].turbine_types

wtg_key

turbine_identifiers

turbine_id

Wind Turbine Generators (WTG)#

from windkit.io.windio import read_plant, read_turbine, write_turbine
from windkit.io.windio import wtg_from_windio, wtg_from_windio_turbine, wtg_to_windio

# From plant data (by index)
wtg = wtg_from_windio(read_plant("wind_farm.yaml"), turbine_type=0)

# From standalone turbine file
wtg = wtg_from_windio_turbine(read_turbine("IEA-15-240-RWT.yaml"))

# Export
write_turbine(wtg_to_windio(wtg), "my_turbine.yaml")

Use wtg_dict_from_windio(plant_data) to extract all turbine types as a dictionary.

Power and Thrust Curves#

windkit handles all windIO curve formats automatically:

  • Direct: power_values / power_wind_speeds

  • Cp-based: Cp_values / Cp_wind_speeds (power coefficient)

  • Ct curve: Ct_values / Ct_wind_speeds (thrust coefficient)

For Cp-based curves, specify air density: wtg_from_windio_turbine(data, air_density=1.225)

API Reference#