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.

All these tags are used in the tool.

Active tags

childOf tag*

The childOf tag names the direct parent. For the esDescriptor implementation this is componentDescriptorInterfaceimplementation.

type tag*

Electrical energy storage systems are "sink-source".

Attributes:

value: "sink-source"

lossMap tag

The lossMap tag describes the loss experienced by the energy storage system for each state of power, energy and ambient temperature. They are described by the tuples 'pPu' for power, 'ePu' for the state of charge, 'tempAmb' for the ambient (outside) temperature and 'lossRate' for the loss.

Attributes:

pPu

value: The power flow of the energy storage in per unit of nameplate power capacity. Positive values of power are used for discharging and negative values for charging. Default values are -1, 0 and 1 pu.

unit: pu.

ePu

value: The energy stored in the energy storage in per unit of nameplate energy capacity. Default values are 0 and 1.

unit: pu.

tempAmb

value: The ambient (outside) temperature in Kelvin. Default value is 298 K.

unit: K.

loss

value: The loss rate of the energy storage in kW. It should include all losses including secondary systems. The Default value is 0.

unit: kW.

chargeRate tag

The chargeRate tag is the fraction of power that it would take to fully charge or discharge the ESS that is the maximum charge or discharge power. This creates charging and discharging curves that exponentially approach full and zero charge. 'value' should be between 0 and 1.

Attributes:

value: A fraction between 0 and 1. The default value is 0.1.

unit: NONE.