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:	name (str or None) – Name of the wind turbine cluster. wind_farms (list (`WindFarm`)) – List of wind farms in cluster. coordinates (list(float) or None (optional)) – List with coordinates [lat, lon] of location. Default: None.

name¶

Name of the wind turbine cluster.

Type:	str or None

wind_farms¶

List of wind farms in cluster.

Type:	list (`WindFarm`)

coordinates¶

List with coordinates [lat, lon] of location. Default: None.

Type:	list(float) or None

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]:

$h_{WTC} = e^{\sum\limits_{k}{ln(h_{WF,k})} \frac{P_{N,k}}{\sum\limits_{k}{P_{N,k}}}}$

with:: $h_{WTC}$ : mean hub height of wind turbine cluster, $h_{WF,k}$ : hub height of the k-th wind farm of the cluster, $P_{N,k}$ : 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:	`WindTurbineCluster`