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 implemented yet but allow for future functionality and expansion.

Active tags

childOf tag*

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

type tag*

Diesel generators are generally classified as a source.

Attributes:

value: this is a component that provides electric energy to the grid. A source may be connected to a form of energy storage that cannot be replenished by the grid, e.g., a fuel tank, or may use a 'fleeting' resource to provide power, e.g., wind or solar power.

fuelCurve

Describes the fuel consumption of the diesel generator as per its power output.

Attributes:

pPu: a power value in P.U. of nameplate capacity.

massFlow: is the fuel consumption value corresponding to the power output in kg/s.

maxDiesCapCharge tag

The maxDiesCapCharge tag is the maximum capacity that charging the ESS can increase the diesel loading to. It depends on the state of charge of the ESS. It is defined by the tuple 'mdcc' which is the maximum diesel loading and the tuple 'soc' which is the corresponding state of charge of the ESS. Units for 'mdcc' are P.U. of nameplate capacity of the diesel generator. Units for 'soc' are P.U. of ESS nameplate energy capacity. Default values for 'mdcc' are 0.65, 0.75, 0.85 and 0.9. The corresponding default values for 'soc' are 1, 0.3, 0.1 and 0.

Attributes:

mdcc

value: Default values are 0.65, 0.75, 0.85 and 0.9.

unit: Per unit of diesel nameplate capacity.

e

value: Default values that correspond to the values for mdcc are 1, 0.3, 0.1 and 0.

unit: Per unit of energy storage energy capacity.

mol tag

The mol tag describes the minimum optimal loading.

Attributes:

value: Default value is 0.4 pu.

unit: Per unit diesel generator capacity.

molLimit tag

The 'molLimit' tag describes the maximum energy measured under minimum optimal loading allowed before raising a flag. Units are in P.U. of nameplate capacity times seconds. It is measured over the past period of time indicated by checkLoadingTime.

Attributes:

value: Default value is 1 pu*s.

unit: integral of Per unit diesel generator capacity and time, PU*s.

mel tag

The 'mel' tag describes the minimum efficient loading. Minimum Efficient Loading is the lower limit on what the ideal loading on the diesel generator is for efficiency purposes. The diesel generator is allowed to run down to the MOL, which is lower than MEL, in normal operation. However, if it is running below MEL for more than melLimit in the past checkLoadingTime, the generator scheduler will look for a more efficient diesel generator combination to run online. Units are in P.U. of nameplate capacity.

Attributes:

value: Default value is 0.5 pu.

unit: Per unit diesel generator capacity and time, PU.

melLimit tag

The 'melLimit' tag describes the maximum energy measured under minimum efficient loading allowed before raising a flag. Units are in P.U. of nameplate capacity times seconds. It is measured over the past period of time indicated by checkLoadingTime.

Attributes:

value: Default value is 10 pu*s.

unit: Time integratl of per unit diesel generator capacity and time, PU*s.

upperNormalLoading tag

The 'upperNormalLoading' tag describes the the normal upper operating range of the diesel generator. If it operates more than the upperNormalLoadingLimit above the upperNormalLoading in the time defined in checkLoadingTime, then a flag is set.

Attributes:

value: Default value is 0.9 pu.

unit: Per unit diesel generator capacity and time, PU.

upperNormalLoadingLimit tag

The upperNormalLoadingLimit tag describes the maximum energy measured over upperNormalLoading allowed before raising a flag. Units are in P.U. of nameplate capacity times seconds. It is measured over the past period of time indicated by checkLoadingTime.

Attributes:

value: Default value is 1 pu*s.

unit: Time integral of per unit diesel generator capacity and time, PU*s.

checkLoadingTime tag

The 'checkLoadingTime' tag is the amount of time that upperNormalLoadingLimit and molLimit are measured over.

Attributes:

value: Default value is 300 s.

unit: seconds.

checkLoadingTime tag

The 'checkLoadingTime' tag is the amount of time that upperNormalLoadingLimit and molLimit are measured over.

Attributes:

value: Default value is 300 s.

unit: seconds.

lowerLimit tag

The lowerLimit is the lower loading limit below which a flag is immediately raised.

Attributes:

value: Default is 0.1 pu.

unit: Generator capacity per unit, PU.

upperLimit tag

The upperLimit is the upper loading limit above which a flag is immediately raised.

Attributes:

value: Default is 1 pu.

unit: Generator capacity per unit, PU.

minRunTime tag

The minRunTime tag is the minimum amount of time that the diesel generator should run online for before being brought offline. This will be followed except in situations which require the unit to be brought offline earlier to avoid critical situations. Default is 3600 s (1 hr).

Attributes:

value: Default is 3600 s.

unit: seconds.

startTime tag

The startTime tag is the amount of time it takes a hot diesel generator to be brought online. This means cranking, synchronizing, connecting and ramping to full load capability.

Attributes:

value: Default is 30.

unit: Seconds.

ntaps tag

The ntaps tag describes the number of FIR filter taps to smooth the loading on the diesel generator using energy storage. This is used in conjunction with FIR filter parameters specified in generalControlParametersInterface.xml. A value of 0 indicates no filtering.

Attributes:

value: The number of taps. Default is 0.

unit: NONE.

Inactive tags

startCost tag

The startCost tag is is the equivalent of the cost associated with starting the diesel generator in kg of diesel. This is used in the dispatch schedule to decide whether to switch or not. Default is 0. This should be updated to minimize diesel switching. This will be divied by the 'minRunTime' to get an kg/s value that will be added to the predicted fuel consumption of the diesel generators.

Attributes:

value: Default is 0.

unit: kg.