windpowerlib.wind_turbine_cluster.WindTurbineCluster¶
-
class
windpowerlib.wind_turbine_cluster.
WindTurbineCluster
(name, wind_farms, coordinates=None, **kwargs)[source]¶ Defines a standard set of wind turbine cluster attributes.
Parameters: -
hub_height
¶ The calculated average hub height of the wind turbine cluster. See
mean_hub_height()
for more information.Type: float
-
nominal_power
¶ The nominal power is the sum of the nominal power of all turbines in the wind turbine cluster in W.
Type: float
-
installed_power
¶ Installed nominal power of the wind turbine cluster in W. Deprecated! Use
nominal_power
instead.Type: float
-
power_curve
¶ The calculated power curve of the wind turbine cluster. See
assign_power_curve()
for more information.Type: pandas.DataFrame or None
-
power_output
¶ The calculated power output of the wind turbine cluster.
Type: pandas.Series
-
installed_power
The installed nominal power of the wind turbine cluster. (Deprecated!)
-
nominal_power
The nominal power of the wind turbine cluster.
See
nominal_power
for further information.Parameters: nominal_power (float) – Nominal power of the wind turbine cluster in w. Returns: Nominal power of the wind turbine cluster in w. Return type: float
-
mean_hub_height
()[source]¶ Calculates the mean hub height of the wind turbine cluster.
The mean hub height of a wind turbine cluster is necessary for power output calculations with an aggregated wind turbine cluster power curve. Hub heights of wind farms with higher nominal power weigh more than others. After the calculations the mean hub height is assigned to the attribute
hub_height
.Returns: self Return type: WindTurbineCluster
Notes
The following equation is used [1]:
- with:
- : mean hub height of wind turbine cluster, : hub height of the k-th wind farm of the cluster, : installed power of the k-th wind farm
References
[1] Knorr, K.: “Modellierung von raum-zeitlichen Eigenschaften der Windenergieeinspeisung für wetterdatenbasierte Windleistungssimulationen”. Universität Kassel, Diss., 2016, p. 35
-
get_installed_power
()[source]¶ Calculates the
nominal_power
of a wind turbine cluster.Returns: Nominal power of the wind farm in W. See nominal_power
for further information.Return type: float
-
assign_power_curve
(wake_losses_model='power_efficiency_curve', smoothing=False, block_width=0.5, standard_deviation_method='turbulence_intensity', smoothing_order='wind_farm_power_curves', turbulence_intensity=None, **kwargs)[source]¶ Calculates the power curve of a wind turbine cluster.
The turbine cluster power curve is calculated by aggregating the wind farm power curves of wind farms within the turbine cluster. Depending on the parameters the power curves are smoothed (before or after the aggregation) and/or a wind farm efficiency is applied before the aggregation. After the calculations the power curve is assigned to the attribute
power_curve
.Parameters: - wake_losses_model (str) – Defines the method for taking wake losses within the farm into consideration. Options: ‘power_efficiency_curve’, ‘constant_efficiency’ or None. Default: ‘power_efficiency_curve’.
- smoothing (bool) – If True the power curves will be smoothed before or after the aggregation of power curves depending on smoothing_order. Default: False.
- block_width (float) – Width between the wind speeds in the sum of the equation in
smooth_power_curve()
. Default: 0.5. - standard_deviation_method (str) – Method for calculating the standard deviation for the Gauss distribution. Options: ‘turbulence_intensity’, ‘Staffell_Pfenninger’. Default: ‘turbulence_intensity’.
- smoothing_order (str) – Defines when the smoothing takes place if smoothing is True. Options: ‘turbine_power_curves’ (to the single turbine power curves), ‘wind_farm_power_curves’. Default: ‘wind_farm_power_curves’.
- turbulence_intensity (float) – Turbulence intensity at hub height of the wind farm or wind turbine cluster for power curve smoothing with ‘turbulence_intensity’ method. Can be calculated from roughness_length instead. Default: None.
- roughness_length (float (optional)) – Roughness length. If standard_deviation_method is ‘turbulence_intensity’ and turbulence_intensity is not given the turbulence intensity is calculated via the roughness length.
Returns: self
Return type:
-