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

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

This descriptor contains active and inactive tags. Active tags are currently implemented in the tool. Inactive tags allow for future expansion and functionality of the tool.

Active tags

childOf tag*

The childOf tag names the direct parent. For the eesDescriptor implementation this is esDescriptorimplementation.

eesSrcTime tag

The eesSrcTime tag is the minimum amount of time that the ees must be able to discharge for at the current level of SRC that it is supplying.

Attributes:

value: Default is 120 s.

Unit: Seconds.

eesUnderSrcLimit tag

The 'eesUnderSrcLimit' tag describes the maximum energy measured under the required SRC that is allowed before raising a flag. Units are in kWs. It is measured over the past period of time indicated by eesUnderSrcTime.

Attributes:

value: Default is 500.

Unit: kWs.

eesUnderSrcTime tag

The eesUnderSrcTime tag is the amount of time that eesUnderSrcLimit is measured over.

Attributes:

value: Default is 300 s.

unit: s.

eesDispatchTime tag

The 'eesDispatchTime' tag is the minimum amount of time that the ESS must be able to supply the load for in order to be considered as an active discharge option in the diesel schedule. Units are in seconds. Default is 18000 s (5 hours).

Attributes:

value: Default is 18000.

unit: s.

prevEesTime tag

The prevEesTime tag defines how far back is used to assess what percentage of the current EES charge came from the diesel generator. This is used in the dispatch schedule to determine the cost of discharging the EES to supply the load for peak shaving or load leveling purposes.

Attributes:

value: Default is 86400 s (24hr).

unit: s.

Inactive Tags

isDCBus tag

This tag describes if the connection interface for this EESS is a DC or AC bus. Normally this would be a DC bus except for some kinetic energy storage systems.

Attributes:

value: boolean. TRUE if system has DC bus. Default is TRUE.

buildingBlockVNom tag

This tag describes the nominal voltage of the smallest practical building block of the EESS.

Attributes:

value: the nominal voltage. Default is 500 V.

unit: units are V. Check 'isDCBus' to ascertain if AC or DC.

buildingBlockVMax tag

This tag describes the maximum non-destructive voltage possible for the building block.

Attributes:

value: the maximum possible voltage. Default is 500 V.

unit: units are V. Check 'isDCBus' to ascertain if AC or DC.

buildingBlockVMinOp tag

This tag describes the lowest voltage at which the unit is still operational, i.e., can still deliver power. There is an important distinction between buildingBlockVMinOp and buildingBlockVMin, where the latter is the lowest voltage the unit can be taken to without destruction. This can have implications regarding the requirement for a pre-charge circuit on the power electronics.

Attributes:

value: the minimum operating voltage. Default is 500 V.

unit: units are V. Check 'isDCBus' to ascertain if AC or DC.

buildingBlockVMin tag

This tag describes the lowest voltage the unit can be taken to with destruction. This is different from the lowest voltage at which the unit remains operational (buildingBlockVMinOp).

Attributes:

value: the absolute minimum voltage. Default is 500 V.

unit: units are V. Check 'isDCBus' to ascertain if AC or DC.

buildingBlockIMax tag

This tag describes the maximum current available from the unit.

Attributes:

value: the maximum current. Default is 0 A.

unit: units are A.

isSerializable tag

This boolean tag describes if multiple units may be put in series.

Attributes:

value: boolean. TRUE if units can be put in series. Default is TRUE.

seriesUnitsMax tag

This tag describes the maximum number of units that may be put in series.

Attributes:

value: the maximum number of units that could be arranged in series. Default is 5.

seriesUnitsAct tag

This tag describes the actual number of units that are in series.

Attributes:

value: the actual number of units that could be arranged in series. Default is 1.

isParallelizable tag

This boolean tag describes if multiple units may be put in parallel.

Attributes:

value: boolean. TRUE if units can be put in parallel. Default is TRUE.

parallelUnitsMax tag

This tag describes the maximum number of units that may be put in parallel.

Attributes:

value: the maximum number of units that could be arranged in parallel. Default is 5.

parallelUnitsAct tag

This tag describes the actual number of units that are in parallel.

Attributes:

value: the actual number of units that could be arranged in parallel. Default is 1.

unit: Hours.

eesCost tag

The eesCost tag is the cost of discharging the EES that is above the fuel cost that went into charging it. It is stated as a fuel consumption per kWh, kg/kWh. It is added to the effective fuel consumption of discharging the EES resulting from chargning it with the diesel generators. The cost is used to account for non-fuel costs of discharging the EES including maintenance and lifetime costs. This should be updated to avoid overuse of the EES.

Attributes:

value: Default is 0.

unit: kg/kWh.