wtgDescriptor.xml : Wind Turbine Generator - acep-uaf/MiGRIDS GitHub Wiki

For inherited tags that have not been modified please see the componentDescriptorInterface.xml documentation.

If a tag is inherited, but has been modified or limited in its use it is denoted with an * in the title.

There are active tags that are implemented in the tool and inactive tags that are not yet implemented but allow for future expansion and increased functionality.

Active tags

childOf tag*

The childOf tag names the direct parent. For the wtgDescriptor implementation this is componentDescriptorInterface.

type tag*

Wind turbine generators are generally classified as a source.

powerCurveDataPoints tag

This, together with cutInWindSpeed, cutOutWindSpeedMax, and cutOutWindSpeedMin, describes the power output of the wind turbine as a function of wind speed. The data is organized in tuples of a wind speed and power value. A minimum of two tuples is required, more is better. Building of a continuous power curve will be handled by wtgPowerCurveAssembler.py.

ws and p tags

These tags a nodes in the powerCurveDataPoints tag. They always have to appear in tuples. There always has to be a minimum of two tuples. Each tag contains a value attribute. The ws value attributed contains a wind speed value with units m/s (in unit attribute). The default value is zero. The p value attribute contains a wind turbine power output with units kW (in unit attribute). The default value is zero.

checkWindTime tag

The 'checkWindTime' tag is the amount of time that windSpillLimit is measured over. Units are s. Default is 300.

Attributes:

value: 300 s.

unit: seconds.

spilledWindLimit tag

The 'spilledWindLimit' tag is the amount of spilled wind power that is the limit before a flag is set to initiate cheduling new diesel and energy storage units. Units are in PU of nameplate capacity times seconds. It is measured over the period of time indicated by checkWindTime. Default is 60 PU*s.

Attributes:

value: 60 pu*s.

unit: Time integral of spilled wind power, PU*s.

recalculateWtgPAvail tag

The recalculateWtgPAvail tag specifies whether to recalculate the available windpower from the base case. Default is False.

Attributes:

value: False.

minSrcCover tag

The 'minSrcCover' tag indicates the minimum percentage of wind power that needs to be covered by SRC. Units are in PU of instantaneous grid import. Default value is 0.75.

Attributes:

value: 0.75 pu.

unit: Per unit of wind import into the grid.

Inactive tags

cutInWindSpeed tag

This describes the minimum wind speed required for a wind turbine to begin producing power. Note that this value can and should be higher that the minimum wind speed a wtg will produce power at, which is described in cutOutWindSpeedMin.

Attributes:

value: the cut in wind speed. Default value 0.

unit: units are m/s.

cutOutWindSpeedMin tag

This describes the minimum wind speed at which a turbine produces power.

Attributes:

value: the minimum cutout wind speed. Default value 0.

unit: units are m/s.

Inactive tags

cutOutWindSpeedMax tag

This describes the maximum wind speed at which a turbine produces power. Beyond this the turbine shuts off for self-protection.

Attributes:

value: the maximum cutout wind speed. Units: m/s. Default value 0.

unit: units are m/s.