EnergyConnection

Type: object

A connection of energy generation or consumption on the power system model.

Type: object

A type of conducting equipment that can regulate a quantity (i.e. voltage or flow) at a specific point in the network.

Type: object

A connection to the AC network for energy production or consumption that uses power electronics rather than rotating machines.

Type: array

An AC electrical connection point to a piece of conducting equipment. Terminals are connected at physical connection points called connectivity nodes.

No Additional Items

Each item of this array must be:

Type: object

An AC electrical connection point to a piece of conducting equipment. Terminals are connected at physical connection points called connectivity nodes.

Type: boolean

The connected status is related to a bus-branch model and the topological node to terminal relation. True implies the terminal is connected to the related topological node and false implies it is not.
In a bus-branch model, the connected status is used to tell if equipment is disconnected without having to change the connectivity described by the topological node to terminal relation. A valid case is that conducting equipment can be connected in one end and open in the other. In particular for an AC line segment, where the reactive line charging can be significant, this is a relevant case.

Type: enum (of string)

Represents the normal network phasing condition. If the attribute is missing, three phases (ABC) shall be assumed, except for terminals of grounding classes (specializations of EarthFaultCompensator, GroundDisconnector, and Ground) which will be assumed to be N. Therefore, phase code ABCN is explicitly declared when needed, e.g. for star point grounding equipment.
The phase code on terminals connecting same ConnectivityNode or same TopologicalNode as well as for equipment between two terminals shall be consistent.

Must be one of:

  • "ABCN"
  • "ABC"
  • "ABN"
  • "ACN"
  • "BCN"
  • "AB"
  • "AC"
  • "BC"
  • "AN"
  • "BN"
  • "CN"
  • "A"
  • "B"
  • "C"
  • "N"
  • "s1N"
  • "s2N"
  • "s12N"
  • "s1"
  • "s2"
  • "s12"
  • "none"
  • "X"
  • "XY"
  • "XN"
  • "XYN"

Type: integer

The orientation of the terminal connections for a multiple terminal conducting equipment. The sequence numbering starts with 1 and additional terminals should follow in increasing order. The first terminal is the "starting point" for a two terminal branch.

Type: string

The description is a free human readable text describing or naming the object. It may be non unique and may not correlate to a naming hierarchy.

Type: string

The aliasName is free text human readable name of the object alternative to IdentifiedObject.name. It may be non unique and may not correlate to a naming hierarchy.
The attribute aliasName is retained because of backwards compatibility between CIM relases. It is however recommended to replace aliasName with the Name class as aliasName is planned for retirement at a future time.

Type: string

Master resource identifier issued by a model authority. The mRID is unique within an exchange context. Global uniqueness is easily achieved by using a UUID, as specified in RFC 4122, for the mRID. The use of UUID is strongly recommended.
For CIMXML data files in RDF syntax conforming to IEC 61970-552, the mRID is mapped to rdf:ID or rdf:about attributes that identify CIM object elements.

Type: string

The name is any free human readable and possibly non unique text naming the object.

Type: object

A generating unit or battery or aggregation that connects to the AC network using power electronics rather than rotating machines.

Type: object

An electrochemical energy storage device.

Type: object

nan

Type: enum (of string)

nan

Must be one of:

  • "constantPFixedV"
  • "constantAdmittance"
  • "constantPConstantQCurrentLimited"
  • "constantPF"
  • "constantPFixedQ"
  • "constantPFixedQConstantReactance"

Type: object or number

Full energy storage capacity of the battery. The attribute shall be a positive value.

Type: enum (of string) Default: "none"

nan

Must be one of:

  • "p"
  • "n"
  • "micro"
  • "m"
  • "c"
  • "d"
  • "k"
  • "M"
  • "G"
  • "T"
  • "none"
  • "y"
  • "z"
  • "a"
  • "f"
  • "da"
  • "h"
  • "P"
  • "E"
  • "Z"
  • "Y"

Type: enum (of string) Default: "Wh"

nan

Must be one of:

  • "none"
  • "m"
  • "kg"
  • "s"
  • "A"
  • "K"
  • "mol"
  • "cd"
  • "deg"
  • "rad"
  • "sr"
  • "Gy"
  • "Bq"
  • "degC"
  • "Sv"
  • "F"
  • "C"
  • "S"
  • "H"
  • "V"
  • "ohm"
  • "J"
  • "N"
  • "Hz"
  • "lx"
  • "lm"
  • "Wb"
  • "T"
  • "W"
  • "Pa"
  • "m2"
  • "m3"
  • "mPers"
  • "mPers2"
  • "m3Pers"
  • "mPerm3"
  • "kgm"
  • "kgPerm3"
  • "WPermK"
  • "JPerK"
  • "ppm"
  • "rotPers"
  • "radPers"
  • "VA"
  • "VAr"
  • "cosPhi"
  • "Vs"
  • "V2"
  • "As"
  • "A2"
  • "A2s"
  • "VAh"
  • "Wh"
  • "VArh"
  • "VPerHz"
  • "HzPers"
  • "character"
  • "charPers"
  • "kgm2"
  • "dB"
  • "WPers"
  • "lPers"
  • "dBm"
  • "h"
  • "min"
  • "Q"
  • "Qh"
  • "ohmm"
  • "APerm"
  • "V2h"
  • "A2h"
  • "Ah"
  • "count"
  • "ft3"
  • "m3Perh"
  • "gal"
  • "Btu"
  • "l"
  • "lPerh"
  • "lPerl"
  • "gPerg"
  • "molPerm3"
  • "molPermol"
  • "molPerkg"
  • "sPers"
  • "HzPerHz"
  • "VPerV"
  • "APerA"
  • "VPerVA"
  • "rev"
  • "kat"
  • "JPerkg"
  • "m3Uncompensated"
  • "m3Compensated"
  • "WPerW"
  • "therm"
  • "onePerm"
  • "m3Perkg"
  • "Pas"
  • "Nm"
  • "NPerm"
  • "radPers2"
  • "WPerm2"
  • "JPerkgK"
  • "JPerm3"
  • "VPerm"
  • "CPerm3"
  • "CPerm2"
  • "FPerm"
  • "HPerm"
  • "JPermol"
  • "JPermolK"
  • "CPerkg"
  • "GyPers"
  • "WPersr"
  • "WPerm2sr"
  • "katPerm3"
  • "d"
  • "anglemin"
  • "anglesec"
  • "ha"
  • "tonne"
  • "bar"
  • "mmHg"
  • "M"
  • "kn"
  • "Vh"
  • "Mx"
  • "G"
  • "Oe"
  • "WPerA"
  • "SPerm"
  • "onePerHz"
  • "VPerVAr"
  • "ohmPerm"
  • "kgPerJ"
  • "JPers"
  • "m2Pers"
  • "JPerm2"
  • "KPers"
  • "PaPers"

Type: object or number

Amount of energy currently stored. The attribute shall be a positive value or zero and lower than BatteryUnit.ratedE.

Same definition as BatteryUnit.ratedE

Type: boolean

The aggregate flag provides an alternative way of representing an aggregated (equivalent) element. It is applicable in cases when the dedicated classes for equivalent equipment do not have all of the attributes necessary to represent the required level of detail. In case the flag is set to “true” the single instance of equipment represents multiple pieces of equipment that have been modelled together as an aggregate equivalent obtained by a network reduction procedure. Examples would be power transformers or synchronous machines operating in parallel modelled as a single aggregate power transformer or aggregate synchronous machine.
The attribute is not used for EquivalentBranch, EquivalentShunt and EquivalentInjection.

Type: boolean

The equipment is enabled to participate in network analysis. If unspecified, the value is assumed to be true.

Type: boolean

Specifies the availability of the equipment under normal operating conditions. True means the equipment is available for topology processing, which determines if the equipment is energized or not. False means that the equipment is treated by network applications as if it is not in the model.

Type: enum (of string)

The current state of the battery (charging, full, etc.).

Must be one of:

  • "discharging"
  • "waiting"
  • "full"
  • "empty"
  • "charging"

Type: boolean

Specifies the availability of the equipment. True means the equipment is available for topology processing, which determines if the equipment is energized or not. False means that the equipment is treated by network applications as if it is not in the model.

Type: string

The description is a free human readable text describing or naming the object. It may be non unique and may not correlate to a naming hierarchy.

Type: string

The aliasName is free text human readable name of the object alternative to IdentifiedObject.name. It may be non unique and may not correlate to a naming hierarchy.
The attribute aliasName is retained because of backwards compatibility between CIM relases. It is however recommended to replace aliasName with the Name class as aliasName is planned for retirement at a future time.

Type: string

Master resource identifier issued by a model authority. The mRID is unique within an exchange context. Global uniqueness is easily achieved by using a UUID, as specified in RFC 4122, for the mRID. The use of UUID is strongly recommended.
For CIMXML data files in RDF syntax conforming to IEC 61970-552, the mRID is mapped to rdf:ID or rdf:about attributes that identify CIM object elements.

Type: string

The name is any free human readable and possibly non unique text naming the object.

Type: object

A photovoltaic device or an aggregation of such devices.

Type: boolean

The aggregate flag provides an alternative way of representing an aggregated (equivalent) element. It is applicable in cases when the dedicated classes for equivalent equipment do not have all of the attributes necessary to represent the required level of detail. In case the flag is set to “true” the single instance of equipment represents multiple pieces of equipment that have been modelled together as an aggregate equivalent obtained by a network reduction procedure. Examples would be power transformers or synchronous machines operating in parallel modelled as a single aggregate power transformer or aggregate synchronous machine.
The attribute is not used for EquivalentBranch, EquivalentShunt and EquivalentInjection.

Type: boolean

The equipment is enabled to participate in network analysis. If unspecified, the value is assumed to be true.

Type: boolean

Specifies the availability of the equipment under normal operating conditions. True means the equipment is available for topology processing, which determines if the equipment is energized or not. False means that the equipment is treated by network applications as if it is not in the model.

Type: boolean

Specifies the availability of the equipment. True means the equipment is available for topology processing, which determines if the equipment is energized or not. False means that the equipment is treated by network applications as if it is not in the model.

Type: string

The description is a free human readable text describing or naming the object. It may be non unique and may not correlate to a naming hierarchy.

Type: string

The aliasName is free text human readable name of the object alternative to IdentifiedObject.name. It may be non unique and may not correlate to a naming hierarchy.
The attribute aliasName is retained because of backwards compatibility between CIM relases. It is however recommended to replace aliasName with the Name class as aliasName is planned for retirement at a future time.

Type: string

Master resource identifier issued by a model authority. The mRID is unique within an exchange context. Global uniqueness is easily achieved by using a UUID, as specified in RFC 4122, for the mRID. The use of UUID is strongly recommended.
For CIMXML data files in RDF syntax conforming to IEC 61970-552, the mRID is mapped to rdf:ID or rdf:about attributes that identify CIM object elements.

Type: string

The name is any free human readable and possibly non unique text naming the object.

Type: object

A wind generating unit that connects to the AC network with power electronics rather than rotating machines or an aggregation of such units.

Type: boolean

The aggregate flag provides an alternative way of representing an aggregated (equivalent) element. It is applicable in cases when the dedicated classes for equivalent equipment do not have all of the attributes necessary to represent the required level of detail. In case the flag is set to “true” the single instance of equipment represents multiple pieces of equipment that have been modelled together as an aggregate equivalent obtained by a network reduction procedure. Examples would be power transformers or synchronous machines operating in parallel modelled as a single aggregate power transformer or aggregate synchronous machine.
The attribute is not used for EquivalentBranch, EquivalentShunt and EquivalentInjection.

Type: boolean

The equipment is enabled to participate in network analysis. If unspecified, the value is assumed to be true.

Type: boolean

Specifies the availability of the equipment under normal operating conditions. True means the equipment is available for topology processing, which determines if the equipment is energized or not. False means that the equipment is treated by network applications as if it is not in the model.

Type: boolean

Specifies the availability of the equipment. True means the equipment is available for topology processing, which determines if the equipment is energized or not. False means that the equipment is treated by network applications as if it is not in the model.

Type: string

The description is a free human readable text describing or naming the object. It may be non unique and may not correlate to a naming hierarchy.

Type: string

The aliasName is free text human readable name of the object alternative to IdentifiedObject.name. It may be non unique and may not correlate to a naming hierarchy.
The attribute aliasName is retained because of backwards compatibility between CIM relases. It is however recommended to replace aliasName with the Name class as aliasName is planned for retirement at a future time.

Type: string

Master resource identifier issued by a model authority. The mRID is unique within an exchange context. Global uniqueness is easily achieved by using a UUID, as specified in RFC 4122, for the mRID. The use of UUID is strongly recommended.
For CIMXML data files in RDF syntax conforming to IEC 61970-552, the mRID is mapped to rdf:ID or rdf:about attributes that identify CIM object elements.

Type: string

The name is any free human readable and possibly non unique text naming the object.

Type: string

Defines a system base voltage which is referenced.

Type: array

A single phase of a power electronics connection.

No Additional Items

Each item of this array must be:

Type: object

A single phase of a power electronics connection.

Type: enum (of string)

Phase of this energy producer component. If the energy producer is wye connected, the connection is from the indicated phase to the central ground or neutral point. If the energy producer is delta connected, the phase indicates an energy producer connected from the indicated phase to the next logical non-neutral phase.

Must be one of:

  • "A"
  • "B"
  • "C"
  • "N"
  • "s1"
  • "s2"

Type: object or number

Active power injection. Load sign convention is used, i.e. positive sign means flow into the equipment from the network.

Same definition as PowerElectronicsUnit.maxP

Type: string

The description is a free human readable text describing or naming the object. It may be non unique and may not correlate to a naming hierarchy.

Type: string

The aliasName is free text human readable name of the object alternative to IdentifiedObject.name. It may be non unique and may not correlate to a naming hierarchy.
The attribute aliasName is retained because of backwards compatibility between CIM relases. It is however recommended to replace aliasName with the Name class as aliasName is planned for retirement at a future time.

Type: string

Master resource identifier issued by a model authority. The mRID is unique within an exchange context. Global uniqueness is easily achieved by using a UUID, as specified in RFC 4122, for the mRID. The use of UUID is strongly recommended.
For CIMXML data files in RDF syntax conforming to IEC 61970-552, the mRID is mapped to rdf:ID or rdf:about attributes that identify CIM object elements.

Type: string

The name is any free human readable and possibly non unique text naming the object.

Type: array

State variable for status.

No Additional Items

Each item of this array must be:

Type: object

State variable for status.

Type: boolean

The in service status as a result of topology processing. It indicates if the equipment is considered as energized by the power flow. It reflects if the equipment is connected within a solvable island. It does not necessarily reflect whether or not the island was solved by the power flow.

Type: enum (of string)

The individual phase status. If the attribute is unspecified, then three phase model is assumed.

Same definition as PowerElectronicsConnectionPhase.phase

Type: string

The description is a free human readable text describing or naming the object. It may be non unique and may not correlate to a naming hierarchy.

Type: boolean

Specifies the regulation status of the equipment. True is regulating, false is not regulating.

Type: boolean

The aggregate flag provides an alternative way of representing an aggregated (equivalent) element. It is applicable in cases when the dedicated classes for equivalent equipment do not have all of the attributes necessary to represent the required level of detail. In case the flag is set to “true” the single instance of equipment represents multiple pieces of equipment that have been modelled together as an aggregate equivalent obtained by a network reduction procedure. Examples would be power transformers or synchronous machines operating in parallel modelled as a single aggregate power transformer or aggregate synchronous machine.
The attribute is not used for EquivalentBranch, EquivalentShunt and EquivalentInjection.

Type: boolean

The equipment is enabled to participate in network analysis. If unspecified, the value is assumed to be true.

Type: boolean

Specifies the availability of the equipment under normal operating conditions. True means the equipment is available for topology processing, which determines if the equipment is energized or not. False means that the equipment is treated by network applications as if it is not in the model.

Type: object or number

Maximum fault current this device will contribute, in per-unit of rated current, before the converter protection will trip or bypass.

Type: boolean

Specifies the availability of the equipment. True means the equipment is available for topology processing, which determines if the equipment is energized or not. False means that the equipment is treated by network applications as if it is not in the model.

Type: object or number

Maximum reactive power limit. This is the maximum (nameplate) limit for the unit.

Same definition as PowerElectronicsConnectionPhase.q

Type: object or number

Minimum reactive power limit for the unit. This is the minimum (nameplate) limit for the unit.

Same definition as PowerElectronicsConnectionPhase.q

Type: object or number

Active power injection. Load sign convention is used, i.e. positive sign means flow out from a node.
Starting value for a steady state solution.

Same definition as PowerElectronicsUnit.maxP

Type: object or number

Reactive power injection. Load sign convention is used, i.e. positive sign means flow out from a node.
Starting value for a steady state solution.

Same definition as PowerElectronicsConnectionPhase.q

Type: object or number

Equivalent resistance (RG) of generator. RG is considered for the calculation of all currents, except for the calculation of the peak current ip. Used for short circuit data exchange according to IEC 60909.

Type: object or number

Zero sequence resistance of the synchronous machine.

Same definition as PowerElectronicsConnection.r

Type: object or number

Nameplate apparent power rating for the unit.
The attribute shall have a positive value.

Type: object or number

Rated voltage (nameplate data, Ur in IEC 60909-0). It is primarily used for short circuit data exchange according to IEC 60909.
The attribute shall be a positive value.

Type: string

The aliasName is free text human readable name of the object alternative to IdentifiedObject.name. It may be non unique and may not correlate to a naming hierarchy.
The attribute aliasName is retained because of backwards compatibility between CIM relases. It is however recommended to replace aliasName with the Name class as aliasName is planned for retirement at a future time.

Type: string

Master resource identifier issued by a model authority. The mRID is unique within an exchange context. Global uniqueness is easily achieved by using a UUID, as specified in RFC 4122, for the mRID. The use of UUID is strongly recommended.
For CIMXML data files in RDF syntax conforming to IEC 61970-552, the mRID is mapped to rdf:ID or rdf:about attributes that identify CIM object elements.

Type: string

The name is any free human readable and possibly non unique text naming the object.

Type: object

A facility for providing variable and controllable shunt reactive power. The SVC typically consists of a stepdown transformer, filter, thyristor-controlled reactor, and thyristor-switched capacitor arms.

The SVC may operate in fixed MVar output mode or in voltage control mode. When in voltage control mode, the output of the SVC will be proportional to the deviation of voltage at the controlled bus from the voltage setpoint. The SVC characteristic slope defines the proportion. If the voltage at the controlled bus is equal to the voltage setpoint, the SVC MVar output is zero.

Type: array

An AC electrical connection point to a piece of conducting equipment. Terminals are connected at physical connection points called connectivity nodes.

No Additional Items

Each item of this array must be:

Type: object

An AC electrical connection point to a piece of conducting equipment. Terminals are connected at physical connection points called connectivity nodes.

Same definition as Terminal

Type: array

State variable for status.

No Additional Items

Each item of this array must be:

Type: enum (of string)

SVC control mode.

Must be one of:

  • "reactivePower"
  • "voltage"

Type: object or number

The reactive power output of the SVC is proportional to the difference between the voltage at the regulated bus and the voltage setpoint. When the regulated bus voltage is equal to the voltage setpoint, the reactive power output is zero.

Same definition as PowerElectronicsConnection.ratedU

Type: boolean

The aggregate flag provides an alternative way of representing an aggregated (equivalent) element. It is applicable in cases when the dedicated classes for equivalent equipment do not have all of the attributes necessary to represent the required level of detail. In case the flag is set to “true” the single instance of equipment represents multiple pieces of equipment that have been modelled together as an aggregate equivalent obtained by a network reduction procedure. Examples would be power transformers or synchronous machines operating in parallel modelled as a single aggregate power transformer or aggregate synchronous machine.
The attribute is not used for EquivalentBranch, EquivalentShunt and EquivalentInjection.

Type: boolean

The equipment is enabled to participate in network analysis. If unspecified, the value is assumed to be true.

Type: boolean

Specifies the regulation status of the equipment. True is regulating, false is not regulating.

Type: object or number

Reactive power injection. Load sign convention is used, i.e. positive sign means flow out from a node.
Starting value for a steady state solution.

Same definition as PowerElectronicsConnectionPhase.q

Type: boolean

Specifies the availability of the equipment under normal operating conditions. True means the equipment is available for topology processing, which determines if the equipment is energized or not. False means that the equipment is treated by network applications as if it is not in the model.

Type: string

The aliasName is free text human readable name of the object alternative to IdentifiedObject.name. It may be non unique and may not correlate to a naming hierarchy.
The attribute aliasName is retained because of backwards compatibility between CIM relases. It is however recommended to replace aliasName with the Name class as aliasName is planned for retirement at a future time.

Type: string

Master resource identifier issued by a model authority. The mRID is unique within an exchange context. Global uniqueness is easily achieved by using a UUID, as specified in RFC 4122, for the mRID. The use of UUID is strongly recommended.
For CIMXML data files in RDF syntax conforming to IEC 61970-552, the mRID is mapped to rdf:ID or rdf:about attributes that identify CIM object elements.

Type: string

The name is any free human readable and possibly non unique text naming the object.

Type: boolean

Specifies the availability of the equipment. True means the equipment is available for topology processing, which determines if the equipment is energized or not. False means that the equipment is treated by network applications as if it is not in the model.

Type: string

The description is a free human readable text describing or naming the object. It may be non unique and may not correlate to a naming hierarchy.

Type: object or number

Capacitive reactance at maximum capacitive reactive power. Shall always be positive.

Same definition as PowerElectronicsConnection.x

Type: object or number

Inductive reactance at maximum inductive reactive power. Shall always be negative.

Same definition as PowerElectronicsConnection.x

Type: object or number

The characteristics slope of an SVC defines how the reactive power output changes in proportion to the difference between the regulated bus voltage and the voltage setpoint.
The attribute shall be a positive value or zero.

Type: object

This class represents the external network and it is used for IEC 60909 calculations.

Type: array

An AC electrical connection point to a piece of conducting equipment. Terminals are connected at physical connection points called connectivity nodes.

No Additional Items

Each item of this array must be:

Type: object

An AC electrical connection point to a piece of conducting equipment. Terminals are connected at physical connection points called connectivity nodes.

Same definition as Terminal

Type: array

State variable for status.

No Additional Items

Each item of this array must be:

Type: object or number

Power Frequency Bias. This is the change in power injection divided by the change in frequency and negated. A positive value of the power frequency bias provides additional power injection upon a drop in frequency.

Type: boolean

Indicates whether initial symmetrical short-circuit current and power have been calculated according to IEC (Ik"). Used only if short circuit calculations are done according to superposition method.

Type: object or number

Maximum initial symmetrical short-circuit currents (Ik" max) in A (Ik" = Sk"/(SQRT(3) Un)). Used for short circuit data exchange according to IEC 60909.

Type: object or number

Maximum reactive power limit. It is used for modelling of infeed for load flow exchange and not for short circuit modelling.

Same definition as PowerElectronicsConnectionPhase.q

Type: number

Maximum ratio of zero sequence resistance of Network Feeder to its zero sequence reactance (R(0)/X(0) max). Used for short circuit data exchange according to IEC 60909.

Type: number

Maximum ratio of positive sequence resistance of Network Feeder to its positive sequence reactance (R(1)/X(1) max). Used for short circuit data exchange according to IEC 60909.

Type: number

Maximum ratio of zero sequence impedance to its positive sequence impedance (Z(0)/Z(1) max). Used for short circuit data exchange according to IEC 60909.

Type: object or number

Minimum initial symmetrical short-circuit currents (Ik" min) in A (Ik" = Sk"/(SQRT(3) Un)). Used for short circuit data exchange according to IEC 60909.

Same definition as ExternalNetworkInjection.maxInitialSymShCCurrent

Type: object or number

Minimum reactive power limit. It is used for modelling of infeed for load flow exchange and not for short circuit modelling.

Same definition as PowerElectronicsConnectionPhase.q

Type: number

Indicates whether initial symmetrical short-circuit current and power have been calculated according to IEC (Ik"). Used for short circuit data exchange according to IEC 6090.

Type: number

Minimum ratio of positive sequence resistance of Network Feeder to its positive sequence reactance (R(1)/X(1) min). Used for short circuit data exchange according to IEC 60909.

Type: number

Minimum ratio of zero sequence impedance to its positive sequence impedance (Z(0)/Z(1) min). Used for short circuit data exchange according to IEC 60909.

Type: integer

Priority of unit for use as powerflow voltage phase angle reference bus selection. 0 = don t care (default) 1 = highest priority. 2 is less than 1 and so on.

Type: object or number

Voltage factor in pu, which was used to calculate short-circuit current Ik" and power Sk". Used only if short circuit calculations are done according to superposition method.

Same definition as PowerElectronicsConnection.maxIFault

Type: string

The description is a free human readable text describing or naming the object. It may be non unique and may not correlate to a naming hierarchy.

Type: boolean

Specifies the regulation status of the equipment. True is regulating, false is not regulating.

Type: object or number

Active power injection. Load sign convention is used, i.e. positive sign means flow out from a node.
Starting value for steady state solutions.

Same definition as PowerElectronicsUnit.maxP

Type: object or number

Reactive power injection. Load sign convention is used, i.e. positive sign means flow out from a node.
Starting value for steady state solutions.

Same definition as PowerElectronicsConnectionPhase.q

Type: boolean

The aggregate flag provides an alternative way of representing an aggregated (equivalent) element. It is applicable in cases when the dedicated classes for equivalent equipment do not have all of the attributes necessary to represent the required level of detail. In case the flag is set to “true” the single instance of equipment represents multiple pieces of equipment that have been modelled together as an aggregate equivalent obtained by a network reduction procedure. Examples would be power transformers or synchronous machines operating in parallel modelled as a single aggregate power transformer or aggregate synchronous machine.
The attribute is not used for EquivalentBranch, EquivalentShunt and EquivalentInjection.

Type: boolean

The equipment is enabled to participate in network analysis. If unspecified, the value is assumed to be true.

Type: boolean

Specifies the availability of the equipment under normal operating conditions. True means the equipment is available for topology processing, which determines if the equipment is energized or not. False means that the equipment is treated by network applications as if it is not in the model.

Type: boolean

Specifies the availability of the equipment. True means the equipment is available for topology processing, which determines if the equipment is energized or not. False means that the equipment is treated by network applications as if it is not in the model.

Type: string

The aliasName is free text human readable name of the object alternative to IdentifiedObject.name. It may be non unique and may not correlate to a naming hierarchy.
The attribute aliasName is retained because of backwards compatibility between CIM relases. It is however recommended to replace aliasName with the Name class as aliasName is planned for retirement at a future time.

Type: string

Master resource identifier issued by a model authority. The mRID is unique within an exchange context. Global uniqueness is easily achieved by using a UUID, as specified in RFC 4122, for the mRID. The use of UUID is strongly recommended.
For CIMXML data files in RDF syntax conforming to IEC 61970-552, the mRID is mapped to rdf:ID or rdf:about attributes that identify CIM object elements.

Type: string

The name is any free human readable and possibly non unique text naming the object.

Type: object

A device to convert from one frequency to another (e.g., frequency F1 to F2) comprises a pair of FrequencyConverter instances. One converts from F1 to DC, the other converts the DC to F2.

Type: array

An AC electrical connection point to a piece of conducting equipment. Terminals are connected at physical connection points called connectivity nodes.

No Additional Items

Each item of this array must be:

Type: object

An AC electrical connection point to a piece of conducting equipment. Terminals are connected at physical connection points called connectivity nodes.

Same definition as Terminal

Type: array

State variable for status.

No Additional Items

Each item of this array must be:

Type: boolean

The aggregate flag provides an alternative way of representing an aggregated (equivalent) element. It is applicable in cases when the dedicated classes for equivalent equipment do not have all of the attributes necessary to represent the required level of detail. In case the flag is set to “true” the single instance of equipment represents multiple pieces of equipment that have been modelled together as an aggregate equivalent obtained by a network reduction procedure. Examples would be power transformers or synchronous machines operating in parallel modelled as a single aggregate power transformer or aggregate synchronous machine.
The attribute is not used for EquivalentBranch, EquivalentShunt and EquivalentInjection.

Type: string

The description is a free human readable text describing or naming the object. It may be non unique and may not correlate to a naming hierarchy.

Type: boolean

The equipment is enabled to participate in network analysis. If unspecified, the value is assumed to be true.

Type: boolean

Specifies the regulation status of the equipment. True is regulating, false is not regulating.

Type: boolean

Specifies the availability of the equipment under normal operating conditions. True means the equipment is available for topology processing, which determines if the equipment is energized or not. False means that the equipment is treated by network applications as if it is not in the model.

Type: string

The aliasName is free text human readable name of the object alternative to IdentifiedObject.name. It may be non unique and may not correlate to a naming hierarchy.
The attribute aliasName is retained because of backwards compatibility between CIM relases. It is however recommended to replace aliasName with the Name class as aliasName is planned for retirement at a future time.

Type: string

Master resource identifier issued by a model authority. The mRID is unique within an exchange context. Global uniqueness is easily achieved by using a UUID, as specified in RFC 4122, for the mRID. The use of UUID is strongly recommended.
For CIMXML data files in RDF syntax conforming to IEC 61970-552, the mRID is mapped to rdf:ID or rdf:about attributes that identify CIM object elements.

Type: string

The name is any free human readable and possibly non unique text naming the object.

Type: boolean

Specifies the availability of the equipment. True means the equipment is available for topology processing, which determines if the equipment is energized or not. False means that the equipment is treated by network applications as if it is not in the model.

Type: object or number

Frequency on the AC side.

Type: object or number

The maximum active power on the DC side at which the frequency converter should operate.

Same definition as PowerElectronicsUnit.maxP

Type: object or number

The maximum voltage on the DC side at which the frequency converter should operate.

Same definition as PowerElectronicsConnection.ratedU

Type: object or number

The minimum active power on the DC side at which the frequency converter should operate.

Same definition as PowerElectronicsUnit.maxP

Type: object or number

The minimum voltage on the DC side at which the frequency converter should operate.

Same definition as PowerElectronicsConnection.ratedU

Type: object

A shunt capacitor or reactor or switchable bank of shunt capacitors or reactors. A section of a shunt compensator is an individual capacitor or reactor. A negative value for bPerSection indicates that the compensator is a reactor. ShuntCompensator is a single terminal device. Ground is implied.

Type: array

An AC electrical connection point to a piece of conducting equipment. Terminals are connected at physical connection points called connectivity nodes.

No Additional Items

Each item of this array must be:

Type: object

An AC electrical connection point to a piece of conducting equipment. Terminals are connected at physical connection points called connectivity nodes.

Same definition as Terminal

Type: array

Single phase of a multi-phase shunt compensator when its attributes might be different per phase.

No Additional Items

Each item of this array must be:

Type: object

Single phase of a multi-phase shunt compensator when its attributes might be different per phase.

Type: string

The description is a free human readable text describing or naming the object. It may be non unique and may not correlate to a naming hierarchy.

Type: string

The aliasName is free text human readable name of the object alternative to IdentifiedObject.name. It may be non unique and may not correlate to a naming hierarchy.
The attribute aliasName is retained because of backwards compatibility between CIM relases. It is however recommended to replace aliasName with the Name class as aliasName is planned for retirement at a future time.

Type: string

Master resource identifier issued by a model authority. The mRID is unique within an exchange context. Global uniqueness is easily achieved by using a UUID, as specified in RFC 4122, for the mRID. The use of UUID is strongly recommended.
For CIMXML data files in RDF syntax conforming to IEC 61970-552, the mRID is mapped to rdf:ID or rdf:about attributes that identify CIM object elements.

Type: number

Shunt compensator sections in use. Starting value for steady state solution. The attribute shall be a positive value or zero. Non integer values are allowed to support continuous variables. The reasons for continuous value are to support study cases where no discrete shunt compensators has yet been designed, a solutions where a narrow voltage band force the sections to oscillate or accommodate for a continuous solution as input.
For LinearShuntConpensator the value shall be between zero and ShuntCompensatorPhase.maximumSections. At value zero the shunt compensator conductance and admittance is zero. Linear interpolation of conductance and admittance between the previous and next integer section is applied in case of non-integer values.
For NonlinearShuntCompensator-s shall only be set to one of the NonlinearShuntCompenstorPhasePoint.sectionNumber. There is no interpolation between NonlinearShuntCompenstorPhasePoint-s.

Type: integer

The maximum number of sections that may be switched in for this phase.

Type: integer

For the capacitor phase, the normal number of sections switched in. The value shall be between zero and ShuntCompensatorPhase.maximumSections.

Type: enum (of string)

Phase of this shunt compensator component. If the shunt compensator is wye connected, the connection is from the indicated phase to the central ground or neutral point. If the shunt compensator is delta connected, the phase indicates a shunt compensator connected from the indicated phase to the next logical non-neutral phase.

Same definition as PowerElectronicsConnectionPhase.phase

Type: string

The name is any free human readable and possibly non unique text naming the object.

Type: array

State variable for the number of sections in service for a shunt compensator.

No Additional Items

Each item of this array must be:

Type: object

State variable for the number of sections in service for a shunt compensator.

Type: number

The number of sections in service as a continuous variable. The attribute shall be a positive value or zero. To get integer value scale with ShuntCompensator.bPerSection.

Type: enum (of string)

The terminal phase at which the connection is applied. If missing, the injection is assumed to be balanced among non-neutral phases.

Same definition as PowerElectronicsConnectionPhase.phase

Type: array

State variable for status.

No Additional Items

Each item of this array must be:

Type: string

The description is a free human readable text describing or naming the object. It may be non unique and may not correlate to a naming hierarchy.

Type: boolean

Specifies the regulation status of the equipment. True is regulating, false is not regulating.

Type: object or number

Zero sequence shunt (charging) susceptance per section.

Same definition as LinearShuntCompensatorPhase.bPerSection

Type: number

Shunt compensator sections in use. Starting value for steady state solution. The attribute shall be a positive value or zero. Non integer values are allowed to support continuous variables. The reasons for continuous value are to support study cases where no discrete shunt compensators has yet been designed, a solutions where a narrow voltage band force the sections to oscillate or accommodate for a continuous solution as input.
For LinearShuntConpensator the value shall be between zero and ShuntCompensator.maximumSections. At value zero the shunt compensator conductance and admittance is zero. Linear interpolation of conductance and admittance between the previous and next integer section is applied in case of non-integer values.
For NonlinearShuntCompensator-s shall only be set to one of the NonlinearShuntCompenstorPoint.sectionNumber. There is no interpolation between NonlinearShuntCompenstorPoint-s.

Type: object or number

Positive sequence shunt (charging) susceptance per section.

Same definition as LinearShuntCompensatorPhase.bPerSection

Type: object or number

Zero sequence shunt (charging) conductance per section.

Same definition as LinearShuntCompensatorPhase.gPerSection

Type: object or number

Positive sequence shunt (charging) conductance per section.

Same definition as LinearShuntCompensatorPhase.gPerSection

Type: object or number

An automatic voltage regulation delay (AVRDelay) which is the time delay from a change in voltage to when the capacitor is allowed to change state. This filters out temporary changes in voltage.

Type: number Default: null

Time, in seconds

Type: boolean

Used for Yn and Zn connections. True if the neutral is solidly grounded.

Type: integer

The maximum number of sections that may be switched in.

Type: object or number

The voltage at which the nominal reactive power may be calculated. This should normally be within 10% of the voltage at which the capacitor is connected to the network.

Same definition as PowerElectronicsConnection.ratedU

Type: integer

The normal number of sections switched in. The value shall be between zero and ShuntCompensator.maximumSections.

Type: enum (of string)

The type of phase connection, such as wye or delta.

Must be one of:

  • "D"
  • "Y"
  • "Yn"
  • "I"
  • "G"

Type: integer

The switch on count since the capacitor count was last reset or initialized.

Type: string

The date and time when the capacitor bank was last switched on.

Type: object or number

Voltage sensitivity required for the device to regulate the bus voltage, in voltage/reactive power.

Same definition as StaticVarCompensator.slope

Type: boolean

The aggregate flag provides an alternative way of representing an aggregated (equivalent) element. It is applicable in cases when the dedicated classes for equivalent equipment do not have all of the attributes necessary to represent the required level of detail. In case the flag is set to “true” the single instance of equipment represents multiple pieces of equipment that have been modelled together as an aggregate equivalent obtained by a network reduction procedure. Examples would be power transformers or synchronous machines operating in parallel modelled as a single aggregate power transformer or aggregate synchronous machine.
The attribute is not used for EquivalentBranch, EquivalentShunt and EquivalentInjection.

Type: boolean

Specifies the availability of the equipment under normal operating conditions. True means the equipment is available for topology processing, which determines if the equipment is energized or not. False means that the equipment is treated by network applications as if it is not in the model.

Type: boolean

The equipment is enabled to participate in network analysis. If unspecified, the value is assumed to be true.

Type: boolean

Specifies the availability of the equipment. True means the equipment is available for topology processing, which determines if the equipment is energized or not. False means that the equipment is treated by network applications as if it is not in the model.

Type: string

The aliasName is free text human readable name of the object alternative to IdentifiedObject.name. It may be non unique and may not correlate to a naming hierarchy.
The attribute aliasName is retained because of backwards compatibility between CIM relases. It is however recommended to replace aliasName with the Name class as aliasName is planned for retirement at a future time.

Type: string

Master resource identifier issued by a model authority. The mRID is unique within an exchange context. Global uniqueness is easily achieved by using a UUID, as specified in RFC 4122, for the mRID. The use of UUID is strongly recommended.
For CIMXML data files in RDF syntax conforming to IEC 61970-552, the mRID is mapped to rdf:ID or rdf:about attributes that identify CIM object elements.

Type: string

The name is any free human readable and possibly non unique text naming the object.

Type: object

A rotating machine which may be used as a generator or motor.

Type: array

An AC electrical connection point to a piece of conducting equipment. Terminals are connected at physical connection points called connectivity nodes.

No Additional Items

Each item of this array must be:

Type: object

An AC electrical connection point to a piece of conducting equipment. Terminals are connected at physical connection points called connectivity nodes.

Same definition as Terminal

Type: object

A single or set of synchronous machines for converting mechanical power into alternating-current power. For example, individual machines within a set may be defined for scheduling purposes while a single control signal is derived for the set. In this case there would be a GeneratingUnit for each member of the set and an additional GeneratingUnit corresponding to the set.

Type: object

A generating unit whose prime mover is a hydraulic turbine (e.g., Francis, Pelton, Kaplan).

Type: object

The generating unit's Operator-approved current operating schedule (or plan), typically produced with the aid of unit commitment type analyses. The X-axis represents absolute time. The Y1-axis represents the status (0=off-line and unavailable: 1=available: 2=must run: 3=must run at fixed power value: etc.). The Y2-axis represents the must run fixed power value where required.

Type: string

The aliasName is free text human readable name of the object alternative to IdentifiedObject.name. It may be non unique and may not correlate to a naming hierarchy.
The attribute aliasName is retained because of backwards compatibility between CIM relases. It is however recommended to replace aliasName with the Name class as aliasName is planned for retirement at a future time.

Type: string

The time for the first time point. The value can be a time of day, not a specific date.

Type: string

The description is a free human readable text describing or naming the object. It may be non unique and may not correlate to a naming hierarchy.

Type: string

The time for the last time point. The value can be a time of day, not a specific date.

Type: string

Master resource identifier issued by a model authority. The mRID is unique within an exchange context. Global uniqueness is easily achieved by using a UUID, as specified in RFC 4122, for the mRID. The use of UUID is strongly recommended.
For CIMXML data files in RDF syntax conforming to IEC 61970-552, the mRID is mapped to rdf:ID or rdf:about attributes that identify CIM object elements.

Type: string

The name is any free human readable and possibly non unique text naming the object.

Type: array

Relationship between unit operating cost (Y-axis) and unit output active power (X-axis). The operating cost curve for thermal units is derived from heat input and fuel costs. The operating cost curve for hydro units is derived from water flow rates and equivalent water costs.

No Additional Items

Each item of this array must be:

Type: object

Relationship between unit operating cost (Y-axis) and unit output active power (X-axis). The operating cost curve for thermal units is derived from heat input and fuel costs. The operating cost curve for hydro units is derived from water flow rates and equivalent water costs.

Type: enum (of string)

The style or shape of the curve.

Must be one of:

  • "constantYValue"
  • "straightLineYValues"

Type: string

The description is a free human readable text describing or naming the object. It may be non unique and may not correlate to a naming hierarchy.

Type: string

The aliasName is free text human readable name of the object alternative to IdentifiedObject.name. It may be non unique and may not correlate to a naming hierarchy.
The attribute aliasName is retained because of backwards compatibility between CIM relases. It is however recommended to replace aliasName with the Name class as aliasName is planned for retirement at a future time.

Type: string

Master resource identifier issued by a model authority. The mRID is unique within an exchange context. Global uniqueness is easily achieved by using a UUID, as specified in RFC 4122, for the mRID. The use of UUID is strongly recommended.
For CIMXML data files in RDF syntax conforming to IEC 61970-552, the mRID is mapped to rdf:ID or rdf:about attributes that identify CIM object elements.

Type: string

The name is any free human readable and possibly non unique text naming the object.

Type: object or number

Governor Speed Changer Droop. This is the change in generator power output divided by the change in frequency normalized by the nominal power of the generator and the nominal frequency and expressed in percent and negated. A positive value of speed change droop provides additional generator output upon a drop in frequency.

Same definition as InefficientBatteryUnit.efficiencyDischarge

Type: enum (of string)

Type of turbine.

Must be one of:

  • "francis"
  • "pelton"
  • "kaplan"

Type: object or number

Default initial active power which is used to store a powerflow result for the initial active power for this unit in this network configuration.

Same definition as PowerElectronicsUnit.maxP

Type: number

Generating unit long term economic participation factor.

Type: object or number

Maximum high economic active power limit, that should not exceed the maximum operating active power limit.

Same definition as PowerElectronicsUnit.maxP

Type: object or number

Maximum allowable spinning reserve. Spinning reserve will never be considered greater than this value regardless of the current operating point.

Same definition as PowerElectronicsUnit.maxP

Type: object or number

This is the maximum operating active power limit the dispatcher can enter for this unit.

Same definition as PowerElectronicsUnit.maxP

Type: object or number

Low economic active power limit that shall be greater than or equal to the minimum operating active power limit.

Same definition as PowerElectronicsUnit.maxP

Type: object or number

This is the minimum operating active power limit the dispatcher can enter for this unit.

Same definition as PowerElectronicsUnit.maxP

Type: object or number

The nominal power of the generating unit. Used to give precise meaning to percentage based attributes such as the governor speed change droop (governorSCD attribute).
The attribute shall be a positive value equal to or less than RotatingMachine.ratedS.

Same definition as PowerElectronicsUnit.maxP

Type: number

Generating unit economic participation factor. The sum of the participation factors across generating units does not have to sum to one. It is used for representing distributed slack participation factor. The attribute shall be a positive value or zero.

Type: number

Defined as: 1 / ( 1 - Incremental Transmission Loss); with the Incremental Transmission Loss expressed as a plus or minus value. The typical range of penalty factors is (0.9 to 1.1).

Type: object or number

The normal maximum rate the generating unit active power output can be raised by control actions.

Same definition as GeneratingUnit.lowerRampRate

Type: object or number

The unit's gross rated maximum capacity (book value).
The attribute shall be a positive value.

Same definition as PowerElectronicsUnit.maxP

Type: object or number

The gross rated minimum generation level which the unit can safely operate at while delivering power to the transmission grid.
The attribute shall be a positive value.

Same definition as PowerElectronicsUnit.maxP

Type: object or number

The net rated maximum capacity determined by subtracting the auxiliary power used to operate the internal plant machinery from the rated gross maximum capacity.
The attribute shall be a positive value.

Same definition as PowerElectronicsUnit.maxP

Type: number

Generating unit short term economic participation factor.

Type: object

The initial startup cost incurred for each start of the GeneratingUnit.

Type: enum (of string) Default: null

nan

Must be one of:

  • "AUD"
  • "CHF"
  • "AFN"
  • "AED"
  • "ALL"
  • "AMD"
  • "ANG"
  • "AOA"
  • "ARS"
  • "AWG"
  • "AZN"
  • "BAM"
  • "BBD"
  • "BDT"
  • "BGN"
  • "BHD"
  • "BIF"
  • "BMD"
  • "BND"
  • "BOB"
  • "BOV"
  • "BRL"
  • "BSD"
  • "BTN"
  • "BWP"
  • "BYR"
  • "BZD"
  • "CAD"
  • "CDF"
  • "CLF"
  • "CLP"
  • "CNY"
  • "ZAR"
  • "COP"
  • "COU"
  • "CRC"
  • "CUC"
  • "CUP"
  • "CVE"
  • "CZK"
  • "DJF"
  • "DKK"
  • "DOP"
  • "DZD"
  • "EEK"
  • "EGP"
  • "ERN"
  • "ETB"
  • "EUR"
  • "FJD"
  • "FKP"
  • "GBP"
  • "GEL"
  • "GHS"
  • "GIP"
  • "GMD"
  • "GNF"
  • "GTQ"
  • "GYD"
  • "HKD"
  • "HNL"
  • "HRK"
  • "HTG"
  • "HUF"
  • "IDR"
  • "ILS"
  • "INR"
  • "IQD"
  • "IRR"
  • "ISK"
  • "JMD"
  • "JOD"
  • "JPY"
  • "KES"
  • "KGS"
  • "KHR"
  • "KMF"
  • "KPW"
  • "KRW"
  • "KWD"
  • "KYD"
  • "KZT"
  • "LAK"
  • "LBP"
  • "LKR"
  • "LRD"
  • "LSL"
  • "LTL"
  • "LVL"
  • "LYD"
  • "MAD"
  • "MDL"
  • "MGA"
  • "MKD"
  • "MMK"
  • "MNT"
  • "MOP"
  • "MRO"
  • "MUR"
  • "MVR"
  • "MWK"
  • "MXN"
  • "MYR"
  • "MZN"
  • "NAD"
  • "NGN"
  • "NIO"
  • "NOK"
  • "NPR"
  • "NZD"
  • "OMR"
  • "PAB"
  • "PEN"
  • "PGK"
  • "PHP"
  • "PKR"
  • "PLN"
  • "PYG"
  • "QAR"
  • "RON"
  • "RSD"
  • "RUB"
  • "RWF"
  • "SAR"
  • "SBD"
  • "SCR"
  • "SDG"
  • "SEK"
  • "SGD"
  • "SHP"
  • "SLL"
  • "SOS"
  • "SRD"
  • "STD"
  • "SYP"
  • "SZL"
  • "THB"
  • "TJS"
  • "TMT"
  • "TND"
  • "TOP"
  • "TRY"
  • "TTD"
  • "TWD"
  • "TZS"
  • "UAH"
  • "UGX"
  • "USD"
  • "UYU"
  • "UZS"
  • "VEF"
  • "VND"
  • "VUV"
  • "WST"
  • "XAF"
  • "XCD"
  • "XOF"
  • "XPF"
  • "YER"
  • "ZMK"
  • "ZWL"

Type: object or number

Time it takes to get the unit on-line, from the time that the prime mover mechanical power is applied.

Same definition as ShuntCompensator.aVRDelay

Type: string

The description is a free human readable text describing or naming the object. It may be non unique and may not correlate to a naming hierarchy.

Type: enum (of string)

Energy conversion capability for generating.

Must be one of:

  • "generator"
  • "pumpAndGenerator"

Type: boolean

The aggregate flag provides an alternative way of representing an aggregated (equivalent) element. It is applicable in cases when the dedicated classes for equivalent equipment do not have all of the attributes necessary to represent the required level of detail. In case the flag is set to “true” the single instance of equipment represents multiple pieces of equipment that have been modelled together as an aggregate equivalent obtained by a network reduction procedure. Examples would be power transformers or synchronous machines operating in parallel modelled as a single aggregate power transformer or aggregate synchronous machine.
The attribute is not used for EquivalentBranch, EquivalentShunt and EquivalentInjection.

Type: boolean

The equipment is enabled to participate in network analysis. If unspecified, the value is assumed to be true.

Type: boolean

Specifies the availability of the equipment under normal operating conditions. True means the equipment is available for topology processing, which determines if the equipment is energized or not. False means that the equipment is treated by network applications as if it is not in the model.

Type: string

Master resource identifier issued by a model authority. The mRID is unique within an exchange context. Global uniqueness is easily achieved by using a UUID, as specified in RFC 4122, for the mRID. The use of UUID is strongly recommended.
For CIMXML data files in RDF syntax conforming to IEC 61970-552, the mRID is mapped to rdf:ID or rdf:about attributes that identify CIM object elements.

Type: string

The name is any free human readable and possibly non unique text naming the object.

Type: boolean

Specifies the availability of the equipment. True means the equipment is available for topology processing, which determines if the equipment is energized or not. False means that the equipment is treated by network applications as if it is not in the model.

Type: object or number

The planned unused capacity (spinning reserve) which can be used to support emergency load.

Same definition as PowerElectronicsUnit.maxP

Type: object or number

The planned unused capacity which can be used to support automatic control overruns.

Same definition as PowerElectronicsUnit.maxP

Type: object or number

For dispatchable units, this value represents the economic active power basepoint, for units that are not dispatchable, this value represents the fixed generation value. The value shall be between the operating low and high limits.

Same definition as PowerElectronicsUnit.maxP

Type: object or number

Unit control error deadband. When a unit's desired active power change is less than this deadband, then no control pulses will be sent to the unit.

Same definition as PowerElectronicsUnit.maxP

Type: object or number

Pulse high limit which is the largest control pulse that the unit can respond to.

Same definition as ShuntCompensator.aVRDelay

Type: object or number

Pulse low limit which is the smallest control pulse that the unit can respond to.

Same definition as ShuntCompensator.aVRDelay

Type: object or number

Unit response rate which specifies the active power change for a control pulse of one second in the most responsive loading level of the unit.

Same definition as GeneratingUnit.lowerRampRate

Type: object or number

The efficiency of the unit in converting mechanical energy, from the prime mover, into electrical energy.

Same definition as InefficientBatteryUnit.efficiencyDischarge

Type: string

The aliasName is free text human readable name of the object alternative to IdentifiedObject.name. It may be non unique and may not correlate to a naming hierarchy.
The attribute aliasName is retained because of backwards compatibility between CIM relases. It is however recommended to replace aliasName with the Name class as aliasName is planned for retirement at a future time.

Type: enum (of string)

The unit control mode.

Must be one of:

  • "setpoint"
  • "pulse"

Type: enum (of string)

The source of controls for a generating unit. Defines the control status of the generating unit.

Must be one of:

  • "unavailable"
  • "offAGC"
  • "onAGC"
  • "plantControl"
Type: object

A solar thermal generating unit, connected to the grid by means of a rotating machine. This class does not represent photovoltaic (PV) generation.

Type: object

The generating unit's Operator-approved current operating schedule (or plan), typically produced with the aid of unit commitment type analyses. The X-axis represents absolute time. The Y1-axis represents the status (0=off-line and unavailable: 1=available: 2=must run: 3=must run at fixed power value: etc.). The Y2-axis represents the must run fixed power value where required.

Same definition as GeneratingUnit.GenUnitOpSchedule

Type: array

Relationship between unit operating cost (Y-axis) and unit output active power (X-axis). The operating cost curve for thermal units is derived from heat input and fuel costs. The operating cost curve for hydro units is derived from water flow rates and equivalent water costs.

No Additional Items

Each item of this array must be:

Type: object

Relationship between unit operating cost (Y-axis) and unit output active power (X-axis). The operating cost curve for thermal units is derived from heat input and fuel costs. The operating cost curve for hydro units is derived from water flow rates and equivalent water costs.

Same definition as GenUnitOpCostCurve

Type: object or number

Governor Speed Changer Droop. This is the change in generator power output divided by the change in frequency normalized by the nominal power of the generator and the nominal frequency and expressed in percent and negated. A positive value of speed change droop provides additional generator output upon a drop in frequency.

Same definition as InefficientBatteryUnit.efficiencyDischarge

Type: object or number

Default initial active power which is used to store a powerflow result for the initial active power for this unit in this network configuration.

Same definition as PowerElectronicsUnit.maxP

Type: number

Generating unit long term economic participation factor.

Type: object or number

The normal maximum rate the generating unit active power output can be lowered by control actions.

Same definition as GeneratingUnit.lowerRampRate

Type: object or number

Maximum high economic active power limit, that should not exceed the maximum operating active power limit.

Same definition as PowerElectronicsUnit.maxP

Type: object or number

Maximum allowable spinning reserve. Spinning reserve will never be considered greater than this value regardless of the current operating point.

Same definition as PowerElectronicsUnit.maxP

Type: object or number

This is the maximum operating active power limit the dispatcher can enter for this unit.

Same definition as PowerElectronicsUnit.maxP

Type: object or number

Low economic active power limit that shall be greater than or equal to the minimum operating active power limit.

Same definition as PowerElectronicsUnit.maxP

Type: object or number

This is the minimum operating active power limit the dispatcher can enter for this unit.

Same definition as PowerElectronicsUnit.maxP

Type: object or number

The nominal power of the generating unit. Used to give precise meaning to percentage based attributes such as the governor speed change droop (governorSCD attribute).
The attribute shall be a positive value equal to or less than RotatingMachine.ratedS.

Same definition as PowerElectronicsUnit.maxP

Type: number

Generating unit economic participation factor. The sum of the participation factors across generating units does not have to sum to one. It is used for representing distributed slack participation factor. The attribute shall be a positive value or zero.

Type: number

Defined as: 1 / ( 1 - Incremental Transmission Loss); with the Incremental Transmission Loss expressed as a plus or minus value. The typical range of penalty factors is (0.9 to 1.1).

Type: object or number

The normal maximum rate the generating unit active power output can be raised by control actions.

Same definition as GeneratingUnit.lowerRampRate

Type: object or number

The unit's gross rated maximum capacity (book value).
The attribute shall be a positive value.

Same definition as PowerElectronicsUnit.maxP

Type: object or number

The gross rated minimum generation level which the unit can safely operate at while delivering power to the transmission grid.
The attribute shall be a positive value.

Same definition as PowerElectronicsUnit.maxP

Type: object or number

The net rated maximum capacity determined by subtracting the auxiliary power used to operate the internal plant machinery from the rated gross maximum capacity.
The attribute shall be a positive value.

Same definition as PowerElectronicsUnit.maxP

Type: number

Generating unit short term economic participation factor.

Type: object or number

Time it takes to get the unit on-line, from the time that the prime mover mechanical power is applied.

Same definition as ShuntCompensator.aVRDelay

Type: string

The description is a free human readable text describing or naming the object. It may be non unique and may not correlate to a naming hierarchy.

Type: boolean

The aggregate flag provides an alternative way of representing an aggregated (equivalent) element. It is applicable in cases when the dedicated classes for equivalent equipment do not have all of the attributes necessary to represent the required level of detail. In case the flag is set to “true” the single instance of equipment represents multiple pieces of equipment that have been modelled together as an aggregate equivalent obtained by a network reduction procedure. Examples would be power transformers or synchronous machines operating in parallel modelled as a single aggregate power transformer or aggregate synchronous machine.
The attribute is not used for EquivalentBranch, EquivalentShunt and EquivalentInjection.

Type: boolean

The equipment is enabled to participate in network analysis. If unspecified, the value is assumed to be true.

Type: boolean

Specifies the availability of the equipment under normal operating conditions. True means the equipment is available for topology processing, which determines if the equipment is energized or not. False means that the equipment is treated by network applications as if it is not in the model.

Type: string

Master resource identifier issued by a model authority. The mRID is unique within an exchange context. Global uniqueness is easily achieved by using a UUID, as specified in RFC 4122, for the mRID. The use of UUID is strongly recommended.
For CIMXML data files in RDF syntax conforming to IEC 61970-552, the mRID is mapped to rdf:ID or rdf:about attributes that identify CIM object elements.

Type: string

The name is any free human readable and possibly non unique text naming the object.

Type: boolean

Specifies the availability of the equipment. True means the equipment is available for topology processing, which determines if the equipment is energized or not. False means that the equipment is treated by network applications as if it is not in the model.

Type: object or number

The planned unused capacity (spinning reserve) which can be used to support emergency load.

Same definition as PowerElectronicsUnit.maxP

Type: object or number

The planned unused capacity which can be used to support automatic control overruns.

Same definition as PowerElectronicsUnit.maxP

Type: object or number

For dispatchable units, this value represents the economic active power basepoint, for units that are not dispatchable, this value represents the fixed generation value. The value shall be between the operating low and high limits.

Same definition as PowerElectronicsUnit.maxP

Type: object or number

Unit control error deadband. When a unit's desired active power change is less than this deadband, then no control pulses will be sent to the unit.

Same definition as PowerElectronicsUnit.maxP

Type: object or number

Pulse high limit which is the largest control pulse that the unit can respond to.

Same definition as ShuntCompensator.aVRDelay

Type: object or number

Pulse low limit which is the smallest control pulse that the unit can respond to.

Same definition as ShuntCompensator.aVRDelay

Type: object or number

Unit response rate which specifies the active power change for a control pulse of one second in the most responsive loading level of the unit.

Same definition as GeneratingUnit.lowerRampRate

Type: object or number

The efficiency of the unit in converting mechanical energy, from the prime mover, into electrical energy.

Same definition as InefficientBatteryUnit.efficiencyDischarge

Type: string

The aliasName is free text human readable name of the object alternative to IdentifiedObject.name. It may be non unique and may not correlate to a naming hierarchy.
The attribute aliasName is retained because of backwards compatibility between CIM relases. It is however recommended to replace aliasName with the Name class as aliasName is planned for retirement at a future time.

Type: enum (of string)

The source of controls for a generating unit. Defines the control status of the generating unit.

Same definition as GeneratingUnit.genControlSource
Type: object

A nuclear generating unit.

Type: object

The generating unit's Operator-approved current operating schedule (or plan), typically produced with the aid of unit commitment type analyses. The X-axis represents absolute time. The Y1-axis represents the status (0=off-line and unavailable: 1=available: 2=must run: 3=must run at fixed power value: etc.). The Y2-axis represents the must run fixed power value where required.

Same definition as GeneratingUnit.GenUnitOpSchedule

Type: array

Relationship between unit operating cost (Y-axis) and unit output active power (X-axis). The operating cost curve for thermal units is derived from heat input and fuel costs. The operating cost curve for hydro units is derived from water flow rates and equivalent water costs.

No Additional Items

Each item of this array must be:

Type: object

Relationship between unit operating cost (Y-axis) and unit output active power (X-axis). The operating cost curve for thermal units is derived from heat input and fuel costs. The operating cost curve for hydro units is derived from water flow rates and equivalent water costs.

Same definition as GenUnitOpCostCurve

Type: object or number

Governor Speed Changer Droop. This is the change in generator power output divided by the change in frequency normalized by the nominal power of the generator and the nominal frequency and expressed in percent and negated. A positive value of speed change droop provides additional generator output upon a drop in frequency.

Same definition as InefficientBatteryUnit.efficiencyDischarge

Type: object or number

Default initial active power which is used to store a powerflow result for the initial active power for this unit in this network configuration.

Same definition as PowerElectronicsUnit.maxP

Type: number

Generating unit long term economic participation factor.

Type: object or number

The normal maximum rate the generating unit active power output can be lowered by control actions.

Same definition as GeneratingUnit.lowerRampRate

Type: object or number

Maximum high economic active power limit, that should not exceed the maximum operating active power limit.

Same definition as PowerElectronicsUnit.maxP

Type: object or number

Maximum allowable spinning reserve. Spinning reserve will never be considered greater than this value regardless of the current operating point.

Same definition as PowerElectronicsUnit.maxP

Type: object or number

This is the maximum operating active power limit the dispatcher can enter for this unit.

Same definition as PowerElectronicsUnit.maxP

Type: object or number

Low economic active power limit that shall be greater than or equal to the minimum operating active power limit.

Same definition as PowerElectronicsUnit.maxP

Type: object or number

This is the minimum operating active power limit the dispatcher can enter for this unit.

Same definition as PowerElectronicsUnit.maxP

Type: object or number

The nominal power of the generating unit. Used to give precise meaning to percentage based attributes such as the governor speed change droop (governorSCD attribute).
The attribute shall be a positive value equal to or less than RotatingMachine.ratedS.

Same definition as PowerElectronicsUnit.maxP

Type: number

Generating unit economic participation factor. The sum of the participation factors across generating units does not have to sum to one. It is used for representing distributed slack participation factor. The attribute shall be a positive value or zero.

Type: number

Defined as: 1 / ( 1 - Incremental Transmission Loss); with the Incremental Transmission Loss expressed as a plus or minus value. The typical range of penalty factors is (0.9 to 1.1).

Type: object or number

The normal maximum rate the generating unit active power output can be raised by control actions.

Same definition as GeneratingUnit.lowerRampRate

Type: object or number

The unit's gross rated maximum capacity (book value).
The attribute shall be a positive value.

Same definition as PowerElectronicsUnit.maxP

Type: object or number

The gross rated minimum generation level which the unit can safely operate at while delivering power to the transmission grid.
The attribute shall be a positive value.

Same definition as PowerElectronicsUnit.maxP

Type: object or number

The net rated maximum capacity determined by subtracting the auxiliary power used to operate the internal plant machinery from the rated gross maximum capacity.
The attribute shall be a positive value.

Same definition as PowerElectronicsUnit.maxP

Type: number

Generating unit short term economic participation factor.

Type: object or number

Time it takes to get the unit on-line, from the time that the prime mover mechanical power is applied.

Same definition as ShuntCompensator.aVRDelay

Type: string

The description is a free human readable text describing or naming the object. It may be non unique and may not correlate to a naming hierarchy.

Type: boolean

The aggregate flag provides an alternative way of representing an aggregated (equivalent) element. It is applicable in cases when the dedicated classes for equivalent equipment do not have all of the attributes necessary to represent the required level of detail. In case the flag is set to “true” the single instance of equipment represents multiple pieces of equipment that have been modelled together as an aggregate equivalent obtained by a network reduction procedure. Examples would be power transformers or synchronous machines operating in parallel modelled as a single aggregate power transformer or aggregate synchronous machine.
The attribute is not used for EquivalentBranch, EquivalentShunt and EquivalentInjection.

Type: boolean

The equipment is enabled to participate in network analysis. If unspecified, the value is assumed to be true.

Type: boolean

Specifies the availability of the equipment under normal operating conditions. True means the equipment is available for topology processing, which determines if the equipment is energized or not. False means that the equipment is treated by network applications as if it is not in the model.

Type: string

Master resource identifier issued by a model authority. The mRID is unique within an exchange context. Global uniqueness is easily achieved by using a UUID, as specified in RFC 4122, for the mRID. The use of UUID is strongly recommended.
For CIMXML data files in RDF syntax conforming to IEC 61970-552, the mRID is mapped to rdf:ID or rdf:about attributes that identify CIM object elements.

Type: string

The name is any free human readable and possibly non unique text naming the object.

Type: boolean

Specifies the availability of the equipment. True means the equipment is available for topology processing, which determines if the equipment is energized or not. False means that the equipment is treated by network applications as if it is not in the model.

Type: object or number

The planned unused capacity (spinning reserve) which can be used to support emergency load.

Same definition as PowerElectronicsUnit.maxP

Type: object or number

The planned unused capacity which can be used to support automatic control overruns.

Same definition as PowerElectronicsUnit.maxP

Type: object or number

For dispatchable units, this value represents the economic active power basepoint, for units that are not dispatchable, this value represents the fixed generation value. The value shall be between the operating low and high limits.

Same definition as PowerElectronicsUnit.maxP

Type: object or number

Unit control error deadband. When a unit's desired active power change is less than this deadband, then no control pulses will be sent to the unit.

Same definition as PowerElectronicsUnit.maxP

Type: object or number

Pulse high limit which is the largest control pulse that the unit can respond to.

Same definition as ShuntCompensator.aVRDelay

Type: object or number

Pulse low limit which is the smallest control pulse that the unit can respond to.

Same definition as ShuntCompensator.aVRDelay

Type: object or number

Unit response rate which specifies the active power change for a control pulse of one second in the most responsive loading level of the unit.

Same definition as GeneratingUnit.lowerRampRate

Type: object or number

The efficiency of the unit in converting mechanical energy, from the prime mover, into electrical energy.

Same definition as InefficientBatteryUnit.efficiencyDischarge

Type: string

The aliasName is free text human readable name of the object alternative to IdentifiedObject.name. It may be non unique and may not correlate to a naming hierarchy.
The attribute aliasName is retained because of backwards compatibility between CIM relases. It is however recommended to replace aliasName with the Name class as aliasName is planned for retirement at a future time.

Type: enum (of string)

The source of controls for a generating unit. Defines the control status of the generating unit.

Same definition as GeneratingUnit.genControlSource
Type: object

A wind driven generating unit, connected to the grid by means of a rotating machine. May be used to represent a single turbine or an aggregation.

Type: object

The generating unit's Operator-approved current operating schedule (or plan), typically produced with the aid of unit commitment type analyses. The X-axis represents absolute time. The Y1-axis represents the status (0=off-line and unavailable: 1=available: 2=must run: 3=must run at fixed power value: etc.). The Y2-axis represents the must run fixed power value where required.

Same definition as GeneratingUnit.GenUnitOpSchedule

Type: array

Relationship between unit operating cost (Y-axis) and unit output active power (X-axis). The operating cost curve for thermal units is derived from heat input and fuel costs. The operating cost curve for hydro units is derived from water flow rates and equivalent water costs.

No Additional Items

Each item of this array must be:

Type: object

Relationship between unit operating cost (Y-axis) and unit output active power (X-axis). The operating cost curve for thermal units is derived from heat input and fuel costs. The operating cost curve for hydro units is derived from water flow rates and equivalent water costs.

Same definition as GenUnitOpCostCurve

Type: object or number

Governor Speed Changer Droop. This is the change in generator power output divided by the change in frequency normalized by the nominal power of the generator and the nominal frequency and expressed in percent and negated. A positive value of speed change droop provides additional generator output upon a drop in frequency.

Same definition as InefficientBatteryUnit.efficiencyDischarge

Type: object or number

Default initial active power which is used to store a powerflow result for the initial active power for this unit in this network configuration.

Same definition as PowerElectronicsUnit.maxP

Type: number

Generating unit long term economic participation factor.

Type: object or number

The normal maximum rate the generating unit active power output can be lowered by control actions.

Same definition as GeneratingUnit.lowerRampRate

Type: object or number

Maximum high economic active power limit, that should not exceed the maximum operating active power limit.

Same definition as PowerElectronicsUnit.maxP

Type: object or number

Maximum allowable spinning reserve. Spinning reserve will never be considered greater than this value regardless of the current operating point.

Same definition as PowerElectronicsUnit.maxP

Type: object or number

This is the maximum operating active power limit the dispatcher can enter for this unit.

Same definition as PowerElectronicsUnit.maxP

Type: object or number

Low economic active power limit that shall be greater than or equal to the minimum operating active power limit.

Same definition as PowerElectronicsUnit.maxP

Type: object or number

This is the minimum operating active power limit the dispatcher can enter for this unit.

Same definition as PowerElectronicsUnit.maxP

Type: object or number

The nominal power of the generating unit. Used to give precise meaning to percentage based attributes such as the governor speed change droop (governorSCD attribute).
The attribute shall be a positive value equal to or less than RotatingMachine.ratedS.

Same definition as PowerElectronicsUnit.maxP

Type: number

Generating unit economic participation factor. The sum of the participation factors across generating units does not have to sum to one. It is used for representing distributed slack participation factor. The attribute shall be a positive value or zero.

Type: number

Defined as: 1 / ( 1 - Incremental Transmission Loss); with the Incremental Transmission Loss expressed as a plus or minus value. The typical range of penalty factors is (0.9 to 1.1).

Type: object or number

The normal maximum rate the generating unit active power output can be raised by control actions.

Same definition as GeneratingUnit.lowerRampRate

Type: object or number

The unit's gross rated maximum capacity (book value).
The attribute shall be a positive value.

Same definition as PowerElectronicsUnit.maxP

Type: object or number

The gross rated minimum generation level which the unit can safely operate at while delivering power to the transmission grid.
The attribute shall be a positive value.

Same definition as PowerElectronicsUnit.maxP

Type: object or number

The net rated maximum capacity determined by subtracting the auxiliary power used to operate the internal plant machinery from the rated gross maximum capacity.
The attribute shall be a positive value.

Same definition as PowerElectronicsUnit.maxP

Type: number

Generating unit short term economic participation factor.

Type: object or number

Time it takes to get the unit on-line, from the time that the prime mover mechanical power is applied.

Same definition as ShuntCompensator.aVRDelay

Type: string

The description is a free human readable text describing or naming the object. It may be non unique and may not correlate to a naming hierarchy.

Type: boolean

The aggregate flag provides an alternative way of representing an aggregated (equivalent) element. It is applicable in cases when the dedicated classes for equivalent equipment do not have all of the attributes necessary to represent the required level of detail. In case the flag is set to “true” the single instance of equipment represents multiple pieces of equipment that have been modelled together as an aggregate equivalent obtained by a network reduction procedure. Examples would be power transformers or synchronous machines operating in parallel modelled as a single aggregate power transformer or aggregate synchronous machine.
The attribute is not used for EquivalentBranch, EquivalentShunt and EquivalentInjection.

Type: boolean

The equipment is enabled to participate in network analysis. If unspecified, the value is assumed to be true.

Type: boolean

Specifies the availability of the equipment under normal operating conditions. True means the equipment is available for topology processing, which determines if the equipment is energized or not. False means that the equipment is treated by network applications as if it is not in the model.

Type: enum (of string)

The kind of wind generating unit.

Must be one of:

  • "offshore"
  • "onshore"

Type: string

Master resource identifier issued by a model authority. The mRID is unique within an exchange context. Global uniqueness is easily achieved by using a UUID, as specified in RFC 4122, for the mRID. The use of UUID is strongly recommended.
For CIMXML data files in RDF syntax conforming to IEC 61970-552, the mRID is mapped to rdf:ID or rdf:about attributes that identify CIM object elements.

Type: string

The name is any free human readable and possibly non unique text naming the object.

Type: boolean

Specifies the availability of the equipment. True means the equipment is available for topology processing, which determines if the equipment is energized or not. False means that the equipment is treated by network applications as if it is not in the model.

Type: object or number

The planned unused capacity (spinning reserve) which can be used to support emergency load.

Same definition as PowerElectronicsUnit.maxP

Type: object or number

The planned unused capacity which can be used to support automatic control overruns.

Same definition as PowerElectronicsUnit.maxP

Type: object or number

For dispatchable units, this value represents the economic active power basepoint, for units that are not dispatchable, this value represents the fixed generation value. The value shall be between the operating low and high limits.

Same definition as PowerElectronicsUnit.maxP

Type: object or number

Unit control error deadband. When a unit's desired active power change is less than this deadband, then no control pulses will be sent to the unit.

Same definition as PowerElectronicsUnit.maxP

Type: object or number

Pulse high limit which is the largest control pulse that the unit can respond to.

Same definition as ShuntCompensator.aVRDelay

Type: object or number

Pulse low limit which is the smallest control pulse that the unit can respond to.

Same definition as ShuntCompensator.aVRDelay

Type: object or number

Unit response rate which specifies the active power change for a control pulse of one second in the most responsive loading level of the unit.

Same definition as GeneratingUnit.lowerRampRate

Type: object or number

The efficiency of the unit in converting mechanical energy, from the prime mover, into electrical energy.

Same definition as InefficientBatteryUnit.efficiencyDischarge

Type: string

The aliasName is free text human readable name of the object alternative to IdentifiedObject.name. It may be non unique and may not correlate to a naming hierarchy.
The attribute aliasName is retained because of backwards compatibility between CIM relases. It is however recommended to replace aliasName with the Name class as aliasName is planned for retirement at a future time.

Type: enum (of string)

The source of controls for a generating unit. Defines the control status of the generating unit.

Same definition as GeneratingUnit.genControlSource
Type: object

A generating unit whose prime mover could be a steam turbine, combustion turbine, or diesel engine.

Type: object

The generating unit's Operator-approved current operating schedule (or plan), typically produced with the aid of unit commitment type analyses. The X-axis represents absolute time. The Y1-axis represents the status (0=off-line and unavailable: 1=available: 2=must run: 3=must run at fixed power value: etc.). The Y2-axis represents the must run fixed power value where required.

Same definition as GeneratingUnit.GenUnitOpSchedule

Type: array

Relationship between unit operating cost (Y-axis) and unit output active power (X-axis). The operating cost curve for thermal units is derived from heat input and fuel costs. The operating cost curve for hydro units is derived from water flow rates and equivalent water costs.

No Additional Items

Each item of this array must be:

Type: object

Relationship between unit operating cost (Y-axis) and unit output active power (X-axis). The operating cost curve for thermal units is derived from heat input and fuel costs. The operating cost curve for hydro units is derived from water flow rates and equivalent water costs.

Same definition as GenUnitOpCostCurve

Type: object or number

Governor Speed Changer Droop. This is the change in generator power output divided by the change in frequency normalized by the nominal power of the generator and the nominal frequency and expressed in percent and negated. A positive value of speed change droop provides additional generator output upon a drop in frequency.

Same definition as InefficientBatteryUnit.efficiencyDischarge

Type: object or number

Default initial active power which is used to store a powerflow result for the initial active power for this unit in this network configuration.

Same definition as PowerElectronicsUnit.maxP

Type: number

Generating unit long term economic participation factor.

Type: object or number

The normal maximum rate the generating unit active power output can be lowered by control actions.

Same definition as GeneratingUnit.lowerRampRate

Type: object or number

Maximum high economic active power limit, that should not exceed the maximum operating active power limit.

Same definition as PowerElectronicsUnit.maxP

Type: object or number

Maximum allowable spinning reserve. Spinning reserve will never be considered greater than this value regardless of the current operating point.

Same definition as PowerElectronicsUnit.maxP

Type: object or number

This is the maximum operating active power limit the dispatcher can enter for this unit.

Same definition as PowerElectronicsUnit.maxP

Type: object or number

Low economic active power limit that shall be greater than or equal to the minimum operating active power limit.

Same definition as PowerElectronicsUnit.maxP

Type: object or number

This is the minimum operating active power limit the dispatcher can enter for this unit.

Same definition as PowerElectronicsUnit.maxP

Type: object or number

The nominal power of the generating unit. Used to give precise meaning to percentage based attributes such as the governor speed change droop (governorSCD attribute).
The attribute shall be a positive value equal to or less than RotatingMachine.ratedS.

Same definition as PowerElectronicsUnit.maxP

Type: number

Generating unit economic participation factor. The sum of the participation factors across generating units does not have to sum to one. It is used for representing distributed slack participation factor. The attribute shall be a positive value or zero.

Type: number

Defined as: 1 / ( 1 - Incremental Transmission Loss); with the Incremental Transmission Loss expressed as a plus or minus value. The typical range of penalty factors is (0.9 to 1.1).

Type: object or number

The normal maximum rate the generating unit active power output can be raised by control actions.

Same definition as GeneratingUnit.lowerRampRate

Type: object or number

The unit's gross rated maximum capacity (book value).
The attribute shall be a positive value.

Same definition as PowerElectronicsUnit.maxP

Type: object or number

The gross rated minimum generation level which the unit can safely operate at while delivering power to the transmission grid.
The attribute shall be a positive value.

Same definition as PowerElectronicsUnit.maxP

Type: object or number

The net rated maximum capacity determined by subtracting the auxiliary power used to operate the internal plant machinery from the rated gross maximum capacity.
The attribute shall be a positive value.

Same definition as PowerElectronicsUnit.maxP

Type: number

Generating unit short term economic participation factor.

Type: object or number

Time it takes to get the unit on-line, from the time that the prime mover mechanical power is applied.

Same definition as ShuntCompensator.aVRDelay

Type: string

The description is a free human readable text describing or naming the object. It may be non unique and may not correlate to a naming hierarchy.

Type: boolean

The aggregate flag provides an alternative way of representing an aggregated (equivalent) element. It is applicable in cases when the dedicated classes for equivalent equipment do not have all of the attributes necessary to represent the required level of detail. In case the flag is set to “true” the single instance of equipment represents multiple pieces of equipment that have been modelled together as an aggregate equivalent obtained by a network reduction procedure. Examples would be power transformers or synchronous machines operating in parallel modelled as a single aggregate power transformer or aggregate synchronous machine.
The attribute is not used for EquivalentBranch, EquivalentShunt and EquivalentInjection.

Type: boolean

The equipment is enabled to participate in network analysis. If unspecified, the value is assumed to be true.

Type: boolean

Specifies the availability of the equipment under normal operating conditions. True means the equipment is available for topology processing, which determines if the equipment is energized or not. False means that the equipment is treated by network applications as if it is not in the model.

Type: string

Master resource identifier issued by a model authority. The mRID is unique within an exchange context. Global uniqueness is easily achieved by using a UUID, as specified in RFC 4122, for the mRID. The use of UUID is strongly recommended.
For CIMXML data files in RDF syntax conforming to IEC 61970-552, the mRID is mapped to rdf:ID or rdf:about attributes that identify CIM object elements.

Type: string

The name is any free human readable and possibly non unique text naming the object.

Type: boolean

Specifies the availability of the equipment. True means the equipment is available for topology processing, which determines if the equipment is energized or not. False means that the equipment is treated by network applications as if it is not in the model.

Type: object or number

The planned unused capacity (spinning reserve) which can be used to support emergency load.

Same definition as PowerElectronicsUnit.maxP

Type: object or number

The planned unused capacity which can be used to support automatic control overruns.

Same definition as PowerElectronicsUnit.maxP

Type: object or number

For dispatchable units, this value represents the economic active power basepoint, for units that are not dispatchable, this value represents the fixed generation value. The value shall be between the operating low and high limits.

Same definition as PowerElectronicsUnit.maxP

Type: object or number

Unit control error deadband. When a unit's desired active power change is less than this deadband, then no control pulses will be sent to the unit.

Same definition as PowerElectronicsUnit.maxP

Type: object or number

Pulse high limit which is the largest control pulse that the unit can respond to.

Same definition as ShuntCompensator.aVRDelay

Type: object or number

Pulse low limit which is the smallest control pulse that the unit can respond to.

Same definition as ShuntCompensator.aVRDelay

Type: object or number

Unit response rate which specifies the active power change for a control pulse of one second in the most responsive loading level of the unit.

Same definition as GeneratingUnit.lowerRampRate

Type: object or number

The efficiency of the unit in converting mechanical energy, from the prime mover, into electrical energy.

Same definition as InefficientBatteryUnit.efficiencyDischarge

Type: string

The aliasName is free text human readable name of the object alternative to IdentifiedObject.name. It may be non unique and may not correlate to a naming hierarchy.
The attribute aliasName is retained because of backwards compatibility between CIM relases. It is however recommended to replace aliasName with the Name class as aliasName is planned for retirement at a future time.

Type: enum (of string)

The source of controls for a generating unit. Defines the control status of the generating unit.

Same definition as GeneratingUnit.genControlSource

Type: array

State variable for status.

No Additional Items

Each item of this array must be:

Type: object or number

Steady-state short-circuit current (in A for the profile) of generator with compound excitation during 3-phase short circuit.
- Ikk=0: Generator with no compound excitation.
- Ikk<>0: Generator with compound excitation.
Ikk is used to calculate the minimum steady-state short-circuit current for generators with compound excitation.
(4.6.1.2 in IEC 60909-0:2001).
Used only for single fed short circuit on a generator. (4.3.4.2. in IEC 60909-0:2001).

Same definition as ExternalNetworkInjection.maxInitialSymShCCurrent

Type: object or number

Time delay required when switching from Manual to Automatic Voltage Regulation. This value is used in the accelerating power reference frame for powerflow solutions.

Same definition as ShuntCompensator.aVRDelay

Type: object or number

Maximum reactive power limit. This is the maximum (nameplate) limit for the unit.

Same definition as PowerElectronicsConnectionPhase.q

Type: object or number

Minimum reactive power limit for the unit.

Same definition as PowerElectronicsConnectionPhase.q

Type: number

Factor to calculate the breaking current (Section 4.5.2.1 in IEC 60909-0).
Used only for single fed short circuit on a generator (Section 4.3.4.2. in IEC 60909-0).

Type: enum (of string)

Current mode of operation.

Must be one of:

  • "generator"
  • "condenser"
  • "motor"

Type: object or number

Part of the coordinated reactive control that comes from this machine. The attribute is used as a participation factor not necessarily summing up to 100% for the participating devices in the control.

Same definition as InefficientBatteryUnit.efficiencyDischarge

Type: object or number

Equivalent resistance (RG) of generator. RG is considered for the calculation of all currents, except for the calculation of the peak current ip. Used for short circuit data exchange according to IEC 60909.

Same definition as PowerElectronicsConnection.r

Type: object or number

Zero sequence resistance of the synchronous machine.

Same definition as PowerElectronicsConnection.r

Type: integer

Priority of unit for use as powerflow voltage phase angle reference bus selection. 0 = don t care (default) 1 = highest priority. 2 is less than 1 and so on.

Type: object or number

Direct-axis subtransient reactance saturated, also known as Xd"sat.

Same definition as PowerElectronicsConnection.maxIFault

Type: object or number

Direct-axes saturated synchronous reactance (xdsat); reciprocal of short-circuit ration. Used for short circuit data exchange, only for single fed short circuit on a generator. (4.3.4.2. in IEC 60909-0:2001).

Same definition as PowerElectronicsConnection.maxIFault

Type: object or number

Saturated Direct-axis transient reactance. The attribute is primarily used for short circuit calculations according to ANSI.

Same definition as PowerElectronicsConnection.maxIFault

Type: enum (of string)

Type of rotor, used by short circuit applications, only for single fed short circuit according to IEC 60909.

Must be one of:

  • "salientPole1"
  • "salientPole2"
  • "turboSeries1"
  • "turboSeries2"

Type: boolean

Indicates whether the machine is a converter fed drive. Used for short circuit data exchange according to IEC 60909.

Type: object or number

Efficiency of the asynchronous machine at nominal operation as a percentage. Indicator for converter drive motors. Used for short circuit data exchange according to IEC 60909.

Same definition as InefficientBatteryUnit.efficiencyDischarge

Type: number

Ratio of locked-rotor current to the rated current of the motor (Ia/Ir). Used for short circuit data exchange according to IEC 60909.

Type: object or number

Nameplate data indicates if the machine is 50 Hz or 60 Hz.

Same definition as FrequencyConverter.frequency

Type: enum (of string)

Modes that this synchronous machine can operate in.

Must be one of:

  • "generator"
  • "condenser"
  • "generatorOrCondenser"
  • "motor"
  • "generatorOrMotor"
  • "motorOrCondenser"
  • "generatorOrCondenserOrMotor"

Type: object or number

Range of generator voltage regulation (PG in IEC 60909-0) used for calculation of the impedance correction factor KG defined in IEC 60909-0.
This attribute is used to describe the operating voltage of the generating unit.

Same definition as InefficientBatteryUnit.efficiencyDischarge

Type: object or number

Nameplate data. Depends on the slip and number of pole pairs.

Type: object or number

Zero sequence reactance of the synchronous machine.

Same definition as PowerElectronicsConnection.x

Type: integer

Number of pole pairs of stator. Used for short circuit data exchange according to IEC 60909.

Type: object or number

Rated mechanical power (Pr in IEC 60909-0). Used for short circuit data exchange according to IEC 60909.

Same definition as PowerElectronicsUnit.maxP

Type: boolean

Indicates for converter drive motors if the power can be reversible. Used for short circuit data exchange according to IEC 60909.

Type: number

Locked rotor ratio (R/X). Used for short circuit data exchange according to IEC 60909.

Type: object or number

Transient rotor time constant (greater than tppo).

Same definition as ShuntCompensator.aVRDelay

Type: object or number

Sub-transient rotor time constant (greater than 0).

Same definition as ShuntCompensator.aVRDelay

Type: object or number

Damper 1 winding leakage reactance.

Same definition as PowerElectronicsConnection.x

Type: object or number

Damper 2 winding leakage reactance.

Same definition as PowerElectronicsConnection.x

Type: object or number

Transient reactance (unsaturated) (greater than or equal to xpp).

Same definition as PowerElectronicsConnection.x

Type: object or number

Sub-transient reactance (unsaturated).

Same definition as PowerElectronicsConnection.x

Type: object or number

Synchronous reactance (greater than xp).

Same definition as PowerElectronicsConnection.x

Type: boolean

Specifies the regulation status of the equipment. True is regulating, false is not regulating.

Type: number

Power factor (nameplate data). It is primarily used for short circuit data exchange according to IEC 60909. The attribute cannot be a negative value.

Type: object or number

Nameplate apparent power rating for the unit.
The attribute shall have a positive value.

Same definition as PowerElectronicsConnection.ratedS

Type: object or number

Rated voltage (nameplate data, Ur in IEC 60909-0). It is primarily used for short circuit data exchange according to IEC 60909.
The attribute shall be a positive value.

Same definition as PowerElectronicsConnection.ratedU

Type: object or number

Active power injection. Load sign convention is used, i.e. positive sign means flow out from a node.
Starting value for a steady state solution.

Same definition as PowerElectronicsUnit.maxP

Type: object or number

Reactive power injection. Load sign convention is used, i.e. positive sign means flow out from a node.
Starting value for a steady state solution.

Same definition as PowerElectronicsConnectionPhase.q

Type: boolean

The aggregate flag provides an alternative way of representing an aggregated (equivalent) element. It is applicable in cases when the dedicated classes for equivalent equipment do not have all of the attributes necessary to represent the required level of detail. In case the flag is set to “true” the single instance of equipment represents multiple pieces of equipment that have been modelled together as an aggregate equivalent obtained by a network reduction procedure. Examples would be power transformers or synchronous machines operating in parallel modelled as a single aggregate power transformer or aggregate synchronous machine.
The attribute is not used for EquivalentBranch, EquivalentShunt and EquivalentInjection.

Type: string

The description is a free human readable text describing or naming the object. It may be non unique and may not correlate to a naming hierarchy.

Type: boolean

The equipment is enabled to participate in network analysis. If unspecified, the value is assumed to be true.

Type: boolean

Specifies the availability of the equipment under normal operating conditions. True means the equipment is available for topology processing, which determines if the equipment is energized or not. False means that the equipment is treated by network applications as if it is not in the model.

Type: string

The aliasName is free text human readable name of the object alternative to IdentifiedObject.name. It may be non unique and may not correlate to a naming hierarchy.
The attribute aliasName is retained because of backwards compatibility between CIM relases. It is however recommended to replace aliasName with the Name class as aliasName is planned for retirement at a future time.

Type: enum (of string)

Indicates the type of Asynchronous Machine (motor or generator).

Must be one of:

  • "generator"
  • "motor"

Type: string

Master resource identifier issued by a model authority. The mRID is unique within an exchange context. Global uniqueness is easily achieved by using a UUID, as specified in RFC 4122, for the mRID. The use of UUID is strongly recommended.
For CIMXML data files in RDF syntax conforming to IEC 61970-552, the mRID is mapped to rdf:ID or rdf:about attributes that identify CIM object elements.

Type: string

The name is any free human readable and possibly non unique text naming the object.

Type: boolean

Specifies the availability of the equipment. True means the equipment is available for topology processing, which determines if the equipment is energized or not. False means that the equipment is treated by network applications as if it is not in the model.

Type: object or number

Time delay required when switching from Automatic Voltage Regulation (AVR) to Manual for a lagging MVAr violation.

Same definition as ShuntCompensator.aVRDelay

Type: object or number

Time delay required when switching from Automatic Voltage Regulation (AVR) to Manual for a leading MVAr violation.

Same definition as ShuntCompensator.aVRDelay

Type: object or number

Default base reactive power value. This value represents the initial reactive power that can be used by any application function.

Same definition as PowerElectronicsConnectionPhase.q

Type: object or number

Active power consumed when in condenser mode operation.

Same definition as PowerElectronicsUnit.maxP

Type: number

Temperature or pressure of coolant medium.

Type: enum (of string)

Method of cooling the machine.

Must be one of:

  • "air"
  • "hydrogenGas"
  • "water"

Type: boolean

Indicates whether or not the generator is earthed. Used for short circuit data exchange according to IEC 60909.

Type: object or number

Generator star point earthing resistance (Re). Used for short circuit data exchange according to IEC 60909.

Same definition as PowerElectronicsConnection.r

Type: object or number

Generator star point earthing reactance (Xe). Used for short circuit data exchange according to IEC 60909.

Same definition as PowerElectronicsConnection.x

Type: object

Generic user of energy - a point of consumption on the power system model.
EnergyConsumer.pfixed, .qfixed, .pfixedPct and .qfixedPct have meaning only if there is no LoadResponseCharacteristic associated with EnergyConsumer or if LoadResponseCharacteristic.exponentModel is set to False.

Type: object

ConformLoad represent loads that follow a daily load change pattern where the pattern can be used to scale the load with a system load.

Type: array

An AC electrical connection point to a piece of conducting equipment. Terminals are connected at physical connection points called connectivity nodes.

No Additional Items

Each item of this array must be:

Type: object

An AC electrical connection point to a piece of conducting equipment. Terminals are connected at physical connection points called connectivity nodes.

Same definition as Terminal

Type: object

Models the characteristic response of the load demand due to changes in system conditions such as voltage and frequency. It is not related to demand response.
If LoadResponseCharacteristic.exponentModel is True, the exponential voltage or frequency dependent models are specified and used as to calculate active and reactive power components of the load model.
The equations to calculate active and reactive power components of the load model are internal to the power flow calculation, hence they use different quantities depending on the use case of the data exchange.
The equations for exponential voltage dependent load model injected power are:
pInjection= Pnominal* (Voltage/cim:BaseVoltage.nominalVoltage) * cim:LoadResponseCharacteristic.pVoltageExponent
qInjection= Qnominal
(Voltage/cim:BaseVoltage.nominalVoltage) * cim:LoadResponseCharacteristic.qVoltageExponent
Where:
1) * means "multiply" and *
is "raised to power of";
2) Pnominal and Qnominal represent the active power and reactive power at nominal voltage as any load described by the voltage exponential model shall be given at nominal voltage. This means that EnergyConsumer.p and EnergyConsumer.q are at nominal voltage.
3) After power flow is solved:
-pInjection and qInjection correspond to SvPowerflow.p and SvPowerflow.q respectively.
- Voltage corresponds to SvVoltage.v at the TopologicalNode where the load is connected.

Type: number

Portion of active power load modelled as constant current.

Type: number

Portion of active power load modelled as constant impedance.

Type: number

Portion of active power load modelled as constant power.

Type: number

Exponent of per unit frequency effecting active power.

Type: number

Portion of reactive power load modelled as constant current.

Type: number

Portion of reactive power load modelled as constant impedance.

Type: number

Portion of reactive power load modelled as constant power.

Type: number

Exponent of per unit frequency effecting reactive power.

Type: number

Exponent of per unit voltage effecting reactive power.

Type: string

The name is any free human readable and possibly non unique text naming the object.

Type: string

The description is a free human readable text describing or naming the object. It may be non unique and may not correlate to a naming hierarchy.

Type: string

The aliasName is free text human readable name of the object alternative to IdentifiedObject.name. It may be non unique and may not correlate to a naming hierarchy.
The attribute aliasName is retained because of backwards compatibility between CIM relases. It is however recommended to replace aliasName with the Name class as aliasName is planned for retirement at a future time.

Type: string

Master resource identifier issued by a model authority. The mRID is unique within an exchange context. Global uniqueness is easily achieved by using a UUID, as specified in RFC 4122, for the mRID. The use of UUID is strongly recommended.
For CIMXML data files in RDF syntax conforming to IEC 61970-552, the mRID is mapped to rdf:ID or rdf:about attributes that identify CIM object elements.

Type: boolean

Indicates the exponential voltage dependency model is to be used. If false, the coefficient model is to be used.
The exponential voltage dependency model consist of the attributes:
- pVoltageExponent
- qVoltageExponent
- pFrequencyExponent
- qFrequencyExponent.
The coefficient model consist of the attributes:
- pConstantImpedance
- pConstantCurrent
- pConstantPower
- qConstantImpedance
- qConstantCurrent
- qConstantPower.
The sum of pConstantImpedance, pConstantCurrent and pConstantPower shall equal 1.
The sum of qConstantImpedance, qConstantCurrent and qConstantPower shall equal 1.

Type: array

A single phase of an energy consumer.

No Additional Items

Each item of this array must be:

Type: object

A single phase of an energy consumer.

Type: object or number

Active power of the load. Load sign convention is used, i.e. positive sign means flow out from a node.
For voltage dependent loads the value is at rated voltage.
Starting value for a steady state solution.

Same definition as PowerElectronicsUnit.maxP

Type: object or number

Active power of the load that is a fixed quantity. Load sign convention is used, i.e. positive sign means flow out from a node.

Same definition as PowerElectronicsUnit.maxP

Type: object or number

Fixed active power as per cent of load group fixed active power. Load sign convention is used, i.e. positive sign means flow out from a node.

Same definition as InefficientBatteryUnit.efficiencyDischarge

Type: enum (of string)

Phase of this energy consumer component. If the energy consumer is wye connected, the connection is from the indicated phase to the central ground or neutral point. If the energy consumer is delta connected, the phase indicates an energy consumer connected from the indicated phase to the next logical non-neutral phase.

Same definition as PowerElectronicsConnectionPhase.phase

Type: object or number

Reactive power of the load that is a fixed quantity. Load sign convention is used, i.e. positive sign means flow out from a node.

Same definition as PowerElectronicsConnectionPhase.q

Type: object or number

Fixed reactive power as per cent of load group fixed reactive power. Load sign convention is used, i.e. positive sign means flow out from a node.

Same definition as InefficientBatteryUnit.efficiencyDischarge

Type: object or number

Reactive power of the load. Load sign convention is used, i.e. positive sign means flow out from a node.
For voltage dependent loads the value is at rated voltage.
Starting value for a steady state solution.

Same definition as PowerElectronicsConnectionPhase.q

Type: string

The description is a free human readable text describing or naming the object. It may be non unique and may not correlate to a naming hierarchy.

Type: string

The aliasName is free text human readable name of the object alternative to IdentifiedObject.name. It may be non unique and may not correlate to a naming hierarchy.
The attribute aliasName is retained because of backwards compatibility between CIM relases. It is however recommended to replace aliasName with the Name class as aliasName is planned for retirement at a future time.

Type: string

Master resource identifier issued by a model authority. The mRID is unique within an exchange context. Global uniqueness is easily achieved by using a UUID, as specified in RFC 4122, for the mRID. The use of UUID is strongly recommended.
For CIMXML data files in RDF syntax conforming to IEC 61970-552, the mRID is mapped to rdf:ID or rdf:about attributes that identify CIM object elements.

Type: string

The name is any free human readable and possibly non unique text naming the object.

Type: array

State variable for status.

No Additional Items

Each item of this array must be:

Type: object or number

Active power of the load. Load sign convention is used, i.e. positive sign means flow out from a node.
For voltage dependent loads the value is at rated voltage.
Starting value for a steady state solution.

Same definition as PowerElectronicsUnit.maxP

Type: boolean

The aggregate flag provides an alternative way of representing an aggregated (equivalent) element. It is applicable in cases when the dedicated classes for equivalent equipment do not have all of the attributes necessary to represent the required level of detail. In case the flag is set to “true” the single instance of equipment represents multiple pieces of equipment that have been modelled together as an aggregate equivalent obtained by a network reduction procedure. Examples would be power transformers or synchronous machines operating in parallel modelled as a single aggregate power transformer or aggregate synchronous machine.
The attribute is not used for EquivalentBranch, EquivalentShunt and EquivalentInjection.

Type: object or number

Reactive power of the load. Load sign convention is used, i.e. positive sign means flow out from a node.
For voltage dependent loads the value is at rated voltage.
Starting value for a steady state solution.

Same definition as PowerElectronicsConnectionPhase.q

Type: boolean

The equipment is enabled to participate in network analysis. If unspecified, the value is assumed to be true.

Type: boolean

Specifies the availability of the equipment under normal operating conditions. True means the equipment is available for topology processing, which determines if the equipment is energized or not. False means that the equipment is treated by network applications as if it is not in the model.

Type: integer

Number of individual customers represented by this demand.

Type: boolean

Used for Yn and Zn connections. True if the neutral is solidly grounded.

Type: object or number

Active power of the load that is a fixed quantity and does not vary as load group value varies. Load sign convention is used, i.e. positive sign means flow out from a node.

Same definition as PowerElectronicsUnit.maxP

Type: object or number

Fixed active power as a percentage of load group fixed active power. Used to represent the time-varying components. Load sign convention is used, i.e. positive sign means flow out from a node.

Same definition as InefficientBatteryUnit.efficiencyDischarge

Type: enum (of string)

The type of phase connection, such as wye or delta.

Same definition as ShuntCompensator.phaseConnection

Type: object or number

Reactive power of the load that is a fixed quantity and does not vary as load group value varies. Load sign convention is used, i.e. positive sign means flow out from a node.

Same definition as PowerElectronicsConnectionPhase.q

Type: object or number

Fixed reactive power as a percentage of load group fixed reactive power. Used to represent the time-varying components. Load sign convention is used, i.e. positive sign means flow out from a node.

Same definition as InefficientBatteryUnit.efficiencyDischarge

Type: boolean

Specifies the availability of the equipment. True means the equipment is available for topology processing, which determines if the equipment is energized or not. False means that the equipment is treated by network applications as if it is not in the model.

Type: string

The description is a free human readable text describing or naming the object. It may be non unique and may not correlate to a naming hierarchy.

Type: string

The aliasName is free text human readable name of the object alternative to IdentifiedObject.name. It may be non unique and may not correlate to a naming hierarchy.
The attribute aliasName is retained because of backwards compatibility between CIM relases. It is however recommended to replace aliasName with the Name class as aliasName is planned for retirement at a future time.

Type: string

Master resource identifier issued by a model authority. The mRID is unique within an exchange context. Global uniqueness is easily achieved by using a UUID, as specified in RFC 4122, for the mRID. The use of UUID is strongly recommended.
For CIMXML data files in RDF syntax conforming to IEC 61970-552, the mRID is mapped to rdf:ID or rdf:about attributes that identify CIM object elements.

Type: string

The name is any free human readable and possibly non unique text naming the object.

Type: object

NonConformLoad represents loads that do not follow a daily load change pattern and whose changes are not correlated with the daily load change pattern.

Type: array

An AC electrical connection point to a piece of conducting equipment. Terminals are connected at physical connection points called connectivity nodes.

No Additional Items

Each item of this array must be:

Type: object

An AC electrical connection point to a piece of conducting equipment. Terminals are connected at physical connection points called connectivity nodes.

Same definition as Terminal

Type: object

Models the characteristic response of the load demand due to changes in system conditions such as voltage and frequency. It is not related to demand response.
If LoadResponseCharacteristic.exponentModel is True, the exponential voltage or frequency dependent models are specified and used as to calculate active and reactive power components of the load model.
The equations to calculate active and reactive power components of the load model are internal to the power flow calculation, hence they use different quantities depending on the use case of the data exchange.
The equations for exponential voltage dependent load model injected power are:
pInjection= Pnominal* (Voltage/cim:BaseVoltage.nominalVoltage) * cim:LoadResponseCharacteristic.pVoltageExponent
qInjection= Qnominal
(Voltage/cim:BaseVoltage.nominalVoltage) * cim:LoadResponseCharacteristic.qVoltageExponent
Where:
1) * means "multiply" and *
is "raised to power of";
2) Pnominal and Qnominal represent the active power and reactive power at nominal voltage as any load described by the voltage exponential model shall be given at nominal voltage. This means that EnergyConsumer.p and EnergyConsumer.q are at nominal voltage.
3) After power flow is solved:
-pInjection and qInjection correspond to SvPowerflow.p and SvPowerflow.q respectively.
- Voltage corresponds to SvVoltage.v at the TopologicalNode where the load is connected.

Same definition as EnergyConsumer.LoadResponseCharacteristic

Type: array

A single phase of an energy consumer.

No Additional Items

Each item of this array must be:

Type: array

State variable for status.

No Additional Items

Each item of this array must be:

Type: object or number

Active power of the load. Load sign convention is used, i.e. positive sign means flow out from a node.
For voltage dependent loads the value is at rated voltage.
Starting value for a steady state solution.

Same definition as PowerElectronicsUnit.maxP

Type: boolean

The aggregate flag provides an alternative way of representing an aggregated (equivalent) element. It is applicable in cases when the dedicated classes for equivalent equipment do not have all of the attributes necessary to represent the required level of detail. In case the flag is set to “true” the single instance of equipment represents multiple pieces of equipment that have been modelled together as an aggregate equivalent obtained by a network reduction procedure. Examples would be power transformers or synchronous machines operating in parallel modelled as a single aggregate power transformer or aggregate synchronous machine.
The attribute is not used for EquivalentBranch, EquivalentShunt and EquivalentInjection.

Type: object or number

Reactive power of the load. Load sign convention is used, i.e. positive sign means flow out from a node.
For voltage dependent loads the value is at rated voltage.
Starting value for a steady state solution.

Same definition as PowerElectronicsConnectionPhase.q

Type: boolean

The equipment is enabled to participate in network analysis. If unspecified, the value is assumed to be true.

Type: boolean

Specifies the availability of the equipment under normal operating conditions. True means the equipment is available for topology processing, which determines if the equipment is energized or not. False means that the equipment is treated by network applications as if it is not in the model.

Type: integer

Number of individual customers represented by this demand.

Type: boolean

Used for Yn and Zn connections. True if the neutral is solidly grounded.

Type: object or number

Active power of the load that is a fixed quantity and does not vary as load group value varies. Load sign convention is used, i.e. positive sign means flow out from a node.

Same definition as PowerElectronicsUnit.maxP

Type: object or number

Fixed active power as a percentage of load group fixed active power. Used to represent the time-varying components. Load sign convention is used, i.e. positive sign means flow out from a node.

Same definition as InefficientBatteryUnit.efficiencyDischarge

Type: enum (of string)

The type of phase connection, such as wye or delta.

Same definition as ShuntCompensator.phaseConnection

Type: object or number

Reactive power of the load that is a fixed quantity and does not vary as load group value varies. Load sign convention is used, i.e. positive sign means flow out from a node.

Same definition as PowerElectronicsConnectionPhase.q

Type: object or number

Fixed reactive power as a percentage of load group fixed reactive power. Used to represent the time-varying components. Load sign convention is used, i.e. positive sign means flow out from a node.

Same definition as InefficientBatteryUnit.efficiencyDischarge

Type: boolean

Specifies the availability of the equipment. True means the equipment is available for topology processing, which determines if the equipment is energized or not. False means that the equipment is treated by network applications as if it is not in the model.

Type: string

The description is a free human readable text describing or naming the object. It may be non unique and may not correlate to a naming hierarchy.

Type: string

The aliasName is free text human readable name of the object alternative to IdentifiedObject.name. It may be non unique and may not correlate to a naming hierarchy.
The attribute aliasName is retained because of backwards compatibility between CIM relases. It is however recommended to replace aliasName with the Name class as aliasName is planned for retirement at a future time.

Type: string

Master resource identifier issued by a model authority. The mRID is unique within an exchange context. Global uniqueness is easily achieved by using a UUID, as specified in RFC 4122, for the mRID. The use of UUID is strongly recommended.
For CIMXML data files in RDF syntax conforming to IEC 61970-552, the mRID is mapped to rdf:ID or rdf:about attributes that identify CIM object elements.

Type: string

The name is any free human readable and possibly non unique text naming the object.

Type: object

A generic equivalent for an energy supplier on a transmission or distribution voltage level.

Type: array

An AC electrical connection point to a piece of conducting equipment. Terminals are connected at physical connection points called connectivity nodes.

No Additional Items

Each item of this array must be:

Type: object

An AC electrical connection point to a piece of conducting equipment. Terminals are connected at physical connection points called connectivity nodes.

Same definition as Terminal

Type: array

Represents the single phase information of an unbalanced energy source.

No Additional Items

Each item of this array must be:

Type: object

Represents the single phase information of an unbalanced energy source.

Type: enum (of string)

Phase of this energy source component. If the energy source wye connected, the connection is from the indicated phase to the central ground or neutral point. If the energy source is delta connected, the phase indicates an energy source connected from the indicated phase to the next logical non-neutral phase.

Same definition as PowerElectronicsConnectionPhase.phase

Type: string

The description is a free human readable text describing or naming the object. It may be non unique and may not correlate to a naming hierarchy.

Type: string

The aliasName is free text human readable name of the object alternative to IdentifiedObject.name. It may be non unique and may not correlate to a naming hierarchy.
The attribute aliasName is retained because of backwards compatibility between CIM relases. It is however recommended to replace aliasName with the Name class as aliasName is planned for retirement at a future time.

Type: string

Master resource identifier issued by a model authority. The mRID is unique within an exchange context. Global uniqueness is easily achieved by using a UUID, as specified in RFC 4122, for the mRID. The use of UUID is strongly recommended.
For CIMXML data files in RDF syntax conforming to IEC 61970-552, the mRID is mapped to rdf:ID or rdf:about attributes that identify CIM object elements.

Type: string

The name is any free human readable and possibly non unique text naming the object.

Type: array

State variable for status.

No Additional Items

Each item of this array must be:

Type: object or number

This is the minimum active power that can be produced by the source. Load sign convention is used, i.e. positive sign means flow out from a TopologicalNode (bus) into the conducting equipment.

Same definition as PowerElectronicsUnit.maxP

Type: object or number

This is the maximum active power that can be produced by the source. Load sign convention is used, i.e. positive sign means flow out from a TopologicalNode (bus) into the conducting equipment.

Same definition as PowerElectronicsUnit.maxP

Type: string

The description is a free human readable text describing or naming the object. It may be non unique and may not correlate to a naming hierarchy.

Type: object or number

High voltage source reactive injection. Load sign convention is used, i.e. positive sign means flow out from a node.
Starting value for steady state solutions.

Same definition as PowerElectronicsConnectionPhase.q

Type: boolean

The aggregate flag provides an alternative way of representing an aggregated (equivalent) element. It is applicable in cases when the dedicated classes for equivalent equipment do not have all of the attributes necessary to represent the required level of detail. In case the flag is set to “true” the single instance of equipment represents multiple pieces of equipment that have been modelled together as an aggregate equivalent obtained by a network reduction procedure. Examples would be power transformers or synchronous machines operating in parallel modelled as a single aggregate power transformer or aggregate synchronous machine.
The attribute is not used for EquivalentBranch, EquivalentShunt and EquivalentInjection.

Type: boolean

The equipment is enabled to participate in network analysis. If unspecified, the value is assumed to be true.

Type: boolean

Specifies the availability of the equipment under normal operating conditions. True means the equipment is available for topology processing, which determines if the equipment is energized or not. False means that the equipment is treated by network applications as if it is not in the model.

Type: boolean

Specifies the availability of the equipment. True means the equipment is available for topology processing, which determines if the equipment is energized or not. False means that the equipment is treated by network applications as if it is not in the model.

Type: object or number

High voltage source active injection. Load sign convention is used, i.e. positive sign means flow out from a node.
Starting value for steady state solutions.

Same definition as PowerElectronicsUnit.maxP

Type: object or number

Phase-to-phase nominal voltage.

Same definition as PowerElectronicsConnection.ratedU

Type: object or number

Positive sequence Thevenin resistance.

Same definition as PowerElectronicsConnection.r

Type: object or number

Zero sequence Thevenin resistance.

Same definition as PowerElectronicsConnection.r

Type: object or number

Negative sequence Thevenin resistance.

Same definition as PowerElectronicsConnection.r

Type: object or number

Phase angle of a-phase open circuit used when voltage characteristics need to be imposed at the node associated with the terminal of the energy source, such as when voltages and angles from the transmission level are used as input to the distribution network. The attribute shall be a positive value or zero.

Type: enum (of string) Default: "none"

nan

Same definition as multiplier

Type: enum (of string) Default: "rad"

nan

Same definition as unit

Type: number Default: null

nan

Type: object or number

Phase-to-phase open circuit voltage magnitude used when voltage characteristics need to be imposed at the node associated with the terminal of the energy source, such as when voltages and angles from the transmission level are used as input to the distribution network. The attribute shall be a positive value or zero.

Same definition as PowerElectronicsConnection.ratedU

Type: object or number

Positive sequence Thevenin reactance.

Same definition as PowerElectronicsConnection.x

Type: object or number

Zero sequence Thevenin reactance.

Same definition as PowerElectronicsConnection.x

Type: object or number

Negative sequence Thevenin reactance.

Same definition as PowerElectronicsConnection.x

Type: string

The aliasName is free text human readable name of the object alternative to IdentifiedObject.name. It may be non unique and may not correlate to a naming hierarchy.
The attribute aliasName is retained because of backwards compatibility between CIM relases. It is however recommended to replace aliasName with the Name class as aliasName is planned for retirement at a future time.

Type: string

Master resource identifier issued by a model authority. The mRID is unique within an exchange context. Global uniqueness is easily achieved by using a UUID, as specified in RFC 4122, for the mRID. The use of UUID is strongly recommended.
For CIMXML data files in RDF syntax conforming to IEC 61970-552, the mRID is mapped to rdf:ID or rdf:about attributes that identify CIM object elements.

Type: string

The name is any free human readable and possibly non unique text naming the object.