Turbine Library Interface#

FLORIS allows users to select from a set of pre-defined turbines as well as load an external library of turbines. This reference demonstrates how to load, compare, and interact with the basic turbine properties prior to wake modeling.

Setup#

import numpy as np
from floris.turbine_library import TurbineInterface, TurbineLibrary

Interacting With A Single Turbine#

There are a few different ways that a TurbineInterface object can be created as demonstrated below. For convenience, we'll only consider the object created from the internal library (option 3).

  • Option 1: Load from a Turbine object: ti = TurbineInterface(turbine_obj)

  • Option 2: Load from a turbine configuration dictionary: ti = TurbineInterface.from_turbine_dict(turbine_dict)

  • Option 3a: Load a file from the internal turbine library: ti = TurbineInterface.from_library("internal", "iea_15MW.yaml")

  • Option 3b: Load a file from the internal turbine library: ti = TurbineInterface.from_internal_library("iea_15MW.yaml")

  • Option 4: Load a file from an external turbine library: ti = TurbineInterface.from_library("path/to/user/library", "iea_15MW.yaml")

  • Option 5: Load a file from anywhere: ti = TurbineInterface.from_yaml("path/to/turbine.yaml")

Single Dimensional Turbine#

ti = TurbineInterface.from_library("internal", "iea_15MW.yaml")

Plot the core attributes#

For TurbineInterface, the core functionality is the power and thrust computation and plotting.

ti.plot_power_curve()
_images/b29a4c5541cf6b309b91cb99a025662669f36a65c2d006377456b2d48f1b2c7a.png
ti.plot_thrust_coefficient_curve()
_images/0cf2d441c297b4c240c0b9d5c707a054f92df72c650fdec11dcf3fd0f0320d3c.png

Interacting With A Multi-Dimensional Turbine#

ti_md = TurbineInterface.from_library("internal", "iea_15MW_multi_dim_cp_ct.yaml")

Plot the core attributes#

In this example, we'll demonstrate how the usage for a multi-dimensional turbine is exactly the same, and how to produce cleaner figures.

ti_md.plot_power_curve(
    fig_kwargs={"figsize": (6, 3)},  # The legend is a bit wider, so we'll need to change the dimensions
    legend_kwargs={"fontsize": 6},  # The labels are quite long, so let's shrink the font
)
_images/bedd2671027e9bfe966f91b021ec732b73bfc5b8778b465ea3a817c1d8a4923a.png
ti_md.plot_thrust_coefficient_curve(
    legend_kwargs={"fontsize": 6},  # The labels are quite long, so let's shrink the font
)
_images/e23a851209340b286e683ef50640b92f597c523647b4f3e98a4d6228bc777227.png

Compare multiple turbines#

The other class provided by the turbine library is the TurbineLibrary object, which allows users to simultaneously load internal and external turbine library configurations and compare them.

Note that turbine names can overlap between the internal and external turbine libraries in this interface, so a little more care is required. This is distinct from how turbine inputs are treated through FlorisInterface via floris.simulation.farm where duplicate turbine names will raise an error.

Loading the libraries#

Loading a turbine library is a 2 or more step process depending on how many turbine libraries are going to be compared.

# Initialize the turbine library (no definitions required!)
tl = TurbineLibrary()

# Load the internal library, except the IEA 15MW turbine
tl.load_internal_library(exclude=["iea_15MW.yaml"])
for turbine in tl.turbine_map:
    print(turbine)
iea_15MW_multi_dim_cp_ct
nrel_5MW
iea_10MW
iea_15MW_floating

In addition to the load_internal_library method, there is a load_external_library method with the same parameterizations, but with an argument for a new library file path.

We can also override previously ignored or loaded files by rerunning the load method again. Notice how we use which=["x_20MW.yaml"] to now include the file. This makes it so we only load the one turbine configuration, however, the same could be achieved by specifying none of the keyword arguments.

tl.load_internal_library(which=["iea_15MW.yaml"])
for turbine in tl.turbine_map:
    print(turbine)
iea_15MW_multi_dim_cp_ct
nrel_5MW
iea_10MW
iea_15MW_floating
iea_15MW

Notice that the "iea_15MW" turbine is now loaded.

Comparing turbines#

There are a number of methods that will plot the varying properties for each turbine against each other, but here the primary output will be displayed.

It should be noted that the 15MW turbines are all variations of each other, and so the multi-dimensional example is removed in favor the of the floating 15MW turbine to highlight a multi-dimensional turbine in relation to the standard 15 MW example.

tl.plot_comparison(
    exclude=["iea_15MW_multi_dim_cp_ct"],  # Remove a turbine just for demonstration
    wind_speeds=np.linspace(0, 30, 61),  # 0 -> 30 m/s, every 0.5 m/s
    fig_kwargs={"figsize": (8, 8)},  # Size the figure appropriately for the docs page
    plot_kwargs={"linewidth": 1},  # Ensure the line plots look nice
    legend_kwargs={"fontsize": 5},  # Ensure all the legend items fit
)
_images/915f735637200ebbb40b82eb206fc6028c348eabc5581f1ffd7384a25373275e.png

Alternatively, these can all be ploted individually with:

  • plot_power_curves()

  • plot_Ct_curves()

  • plot_rotor_diameters()

  • plot_hub_heights()

For a text based approach, we can access the attributes like the following:

header = f"\
{'Turbine':>25} | \
{'Rotor Diameter (m)':>18} | \
{'Hub Height (m)':>14} | \
{'TSR':>6} | \
{'Air Density (ρ)':>15} | \
{'Tilt (º)':>8}\
"
print(header)
print("-" * len(header))
for name, t in tl.turbine_map.items():
    print(f"{name:>25}", end=" | ")
    print(f"{t.turbine.rotor_diameter:>18,.2f}", end=" | ")
    print(f"{t.turbine.hub_height:>14,.1f}", end=" | ")
    print(f"{t.turbine.TSR:>6,.1f}", end=" | ")
    if t.turbine.multi_dimensional_cp_ct:
        condition_keys = list(t.turbine.power_thrust_table.keys())
        print(f"{t.turbine.power_thrust_table[condition_keys[0]]['ref_air_density']:>15,.3f}", end=" | ")
        print(f"{t.turbine.power_thrust_table[condition_keys[0]]['ref_tilt']:>8,.3f}")
    else:
        print(f"{t.turbine.power_thrust_table['ref_air_density']:>15,.3f}", end=" | ")
        print(f"{t.turbine.power_thrust_table['ref_tilt']:>8,.3f}")
                  Turbine | Rotor Diameter (m) | Hub Height (m) |    TSR | Air Density (ρ) | Tilt (º)
-----------------------------------------------------------------------------------------------------
 iea_15MW_multi_dim_cp_ct |             242.24 |          150.0 |    8.0 |           1.225 |    6.000
                 nrel_5MW |             125.88 |           90.0 |    8.0 |           1.225 |    5.000
                 iea_10MW |             198.00 |          119.0 |    8.0 |           1.225 |    6.000
        iea_15MW_floating |             242.24 |          150.0 |    8.0 |           1.225 |    6.000
                 iea_15MW |             242.24 |          150.0 |    8.0 |           1.225 |    6.000