windkit.io.windio.read_layout#

windkit.io.windio.read_layout(path, resolve=False)[source]#

Parse a windIO layout YAML file and wrap in plant structure.

Warning

windIO support is experimental. API may change in future versions.

This function reads a standalone layout file (with coordinates and turbine_types) and wraps it in a minimal plant structure so it can be used with the from_windio translation functions.

Parameters:

  • path (str or pathlib.Path) – Path to windIO layout YAML file.

  • resolve (bool, optional) – If True, eagerly resolve all !include markers. Default is False (markers are preserved for lazy resolution).

Returns:

Plant-like dictionary with the layout data.

Return type:

dict

Raises:

FileNotFoundError – If file does not exist.

Examples

>>> from windkit.io.windio import read_layout
>>> from windkit.io.windio.translate import wind_turbines_from_windio
>>> plant_data = read_layout("layout.yaml")
>>> turbines = wind_turbines_from_windio(plant_data, crs="EPSG:32632")
On this page