windpowerlib.modelchain.Modelchain¶

class windpowerlib.modelchain.Modelchain(wind_turbine, obstacle_height=0, wind_model='logarithmic', rho_model='barometric', temperature_model='gradient', power_output_model='cp_values', density_corr=False, hellman_exp=None, hellman_z0=None)[source]¶

Model to determine the output of a wind turbine

Parameters:

wind_turbine (WindTurbine) – A WindTurbine object representing the wind turbine.
obstacle_height (float) – Height of obstacles in the surrounding area of the wind turbine in m. Set obstacle_height to zero for wide spread obstacles. Default: 0.
wind_model (string) – Parameter to define which model to use to calculate the wind speed at hub height. Valid options are ‘logarithmic’ and ‘hellman’. Default: ‘logarithmic’.
rho_model (string) – Parameter to define which model to use to calculate the density of air at hub height. Valid options are ‘barometric’ and ‘ideal_gas’. Default: ‘barometric’.
temperature_model (string) – Parameter to define which model to use to calculate the temperature at hub height. Valid options are ‘gradient’ and ‘interpolation’. Default: ‘gradient’.
power_output_model (string) – Parameter to define which model to use to calculate the turbine power output. Valid options are ‘cp_values’ and ‘p_values’. Default: ‘cp_values’.
density_corr (boolean) – If the parameter is True the density corrected power curve is used for the calculation of the turbine power output. Default: False.
hellman_exp (float) – The Hellman exponent, which combines the increase in wind speed due to stability of atmospheric conditions and surface roughness into one constant. Default: None.
hellman_z0 (float) – Roughness length. Default: None.

wind_turbine¶: WindTurbine – A WindTurbine object representing the wind turbine.

obstacle_height¶: float – Height of obstacles in the surrounding area of the wind turbine in m. Set obstacle_height to zero for wide spread obstacles. Default: 0.

wind_model¶: string – Parameter to define which model to use to calculate the wind speed at hub height. Valid options are ‘logarithmic’ and ‘hellman’. Default: ‘logarithmic’.

rho_model¶: string – Parameter to define which model to use to calculate the density of air at hub height. Valid options are ‘barometric’ and ‘ideal_gas’. Default: ‘barometric’.

temperature_model¶: string – Parameter to define which model to use to calculate the temperature at hub height. Valid options are ‘gradient’ and ‘interpolation’. Default: ‘gradient’.

power_output_model¶: string – Parameter to define which model to use to calculate the turbine power output. Valid options are ‘cp_values’ and ‘p_values’. Default: ‘cp_values’.

density_corr¶: boolean – If the parameter is True the density corrected power curve is used for the calculation of the turbine power output. Default: False.

hellman_exp¶: float – The Hellman exponent, which combines the increase in wind speed due to stability of atmospheric conditions and surface roughness into one constant. Default: None.

hellman_z0¶: float – Roughness length. Default: None.

power_output¶: pandas.Series – Electrical power output of the wind turbine in W.

Examples

>>> from windpowerlib import modelchain
>>> from windpowerlib import wind_turbine
>>> enerconE126 = {
...    'hub_height': 135,
...    'd_rotor': 127,
...    'wind_conv_type': 'ENERCON E 126 7500'}
>>> e126 = wind_turbine.WindTurbine(**enerconE126)
>>> modelchain_data = {'rho_model': 'ideal_gas',
...    'temperature_model': 'interpolation'}
>>> e126_md = modelchain.Modelchain(e126, **modelchain_data)
>>> print(e126.d_rotor)
127

__init__(wind_turbine, obstacle_height=0, wind_model='logarithmic', rho_model='barometric', temperature_model='gradient', power_output_model='cp_values', density_corr=False, hellman_exp=None, hellman_z0=None)[source]¶

Methods

`__init__`(wind_turbine[, obstacle_height, ...])
`rho_hub`(weather, data_height)	Calculates the density of air at hub height.
`run_model`(weather, data_height)	Runs the model.
`turbine_power_output`(v_wind, rho_hub)	Calculates the power output of the wind turbine.
`v_wind_hub`(weather, data_height)	Calculates the wind speed at hub height.