windpowerlib.wind_speed.logarithmic_profile

windpowerlib.wind_speed.logarithmic_profile(wind_speed, wind_speed_height, hub_height, roughness_length, obstacle_height=0.0)[source]

Calculates the wind speed at hub height using a logarithmic wind profile.

The logarithmic height equation is used. There is the possibility of including the height of the surrounding obstacles in the calculation. This function is carried out when the parameter wind_speed_model of an instance of the ModelChain class is ‘logarithmic’.

Parameters:
  • wind_speed (pandas.Series or numpy.array) – Wind speed time series.

  • wind_speed_height (float) – Height for which the parameter wind_speed applies.

  • hub_height (float) – Hub height of wind turbine.

  • roughness_length (pandas.Series or numpy.array or float) – Roughness length.

  • obstacle_height (float) – Height of obstacles in the surrounding area of the wind turbine. Set obstacle_height to zero for widespread obstacles. Default: 0.

Returns:

Wind speed at hub height. Data type depends on type of wind_speed.

Return type:

pandas.Series or numpy.array

Notes

The following equation is used [1] [2] [3]:

v_{wind,hub}=v_{wind,data}\cdot
\frac{\ln\left(\frac{h_{hub}-d}{z_{0}}\right)}{\ln\left(
\frac{h_{data}-d}{z_{0}}\right)}

with:

v: wind speed, h: height, z_{0}: roughness length, d: boundary layer offset (estimated by d=0.7 * obstacle_height)

For d=0 it results in the following equation [2] [3]:

v_{wind,hub}=v_{wind,data}\cdot\frac{\ln\left(\frac{h_{hub}}
{z_{0}}\right)}{\ln\left(\frac{h_{data}}{z_{0}}\right)}

h_{data} is the height at which the wind speed v_{wind,data} is measured and v_{wind,hub} is the wind speed at hub height h_{hub} of the wind turbine.

Parameters wind_speed_height, roughness_length, hub_height and obstacle_height have to be of the same unit.

References