RotatingMachine

Type: object

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

Type: object

nan

Type: enum (of string)

nan

Must be one of:

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

Type: string

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 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: enum (of string)

Multiplier for value2.

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: object or number

The time between each pair of subsequent regular time points in sequence order.

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

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: 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: boolean

Flag is set to true when output is expressed in net active power.

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.

Type: number Default: null

Normally 0 to 100 on a defined base.

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 GeneratingUnit.highControlLimit

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.

Type: object or number

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

Same definition as GeneratingUnit.highControlLimit

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 GeneratingUnit.highControlLimit

Type: object or number

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

Same definition as GeneratingUnit.highControlLimit

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 GeneratingUnit.highControlLimit

Type: object or number

Minimum time interval between unit shutdown and startup.

Same definition as RegularIntervalSchedule.timeStep

Type: object or number

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

Same definition as GeneratingUnit.highControlLimit

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 GeneratingUnit.highControlLimit

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 GeneratingUnit.highControlLimit

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 GeneratingUnit.highControlLimit

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 GeneratingUnit.highControlLimit

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 RegularIntervalSchedule.timeStep

Type: number

Generating unit economic participation factor.

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

The variable cost component of production per unit of ActivePower.

Same definition as GeneratingUnit.startupCost

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: object or number

The efficiency of the unit in converting the fuel into electrical energy.

Same definition as GeneratingUnit.governorSCD

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 GeneratingUnit.highControlLimit

Type: object or number

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

Same definition as GeneratingUnit.highControlLimit

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 GeneratingUnit.highControlLimit

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 GeneratingUnit.highControlLimit

Type: object or number

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

Same definition as RegularIntervalSchedule.timeStep

Type: object or number

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

Same definition as RegularIntervalSchedule.timeStep

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 GeneratingUnit.governorSCD

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 GeneratingUnit.governorSCD

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 GeneratingUnit.highControlLimit

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 GeneratingUnit.highControlLimit

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 GeneratingUnit.highControlLimit

Type: object or number

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

Same definition as GeneratingUnit.highControlLimit

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 GeneratingUnit.highControlLimit

Type: object or number

Minimum time interval between unit shutdown and startup.

Same definition as RegularIntervalSchedule.timeStep

Type: object or number

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

Same definition as GeneratingUnit.highControlLimit

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 GeneratingUnit.highControlLimit

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 GeneratingUnit.highControlLimit

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 GeneratingUnit.highControlLimit

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 GeneratingUnit.highControlLimit

Type: number

Generating unit short term economic participation factor.

Type: object

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

Same definition as GeneratingUnit.startupCost

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 RegularIntervalSchedule.timeStep

Type: number

Generating unit economic participation factor.

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

The variable cost component of production per unit of ActivePower.

Same definition as GeneratingUnit.startupCost

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: object or number

The efficiency of the unit in converting the fuel into electrical energy.

Same definition as GeneratingUnit.governorSCD

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 GeneratingUnit.highControlLimit

Type: object or number

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

Same definition as GeneratingUnit.highControlLimit

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 GeneratingUnit.highControlLimit

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 GeneratingUnit.highControlLimit

Type: object or number

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

Same definition as RegularIntervalSchedule.timeStep

Type: object or number

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

Same definition as RegularIntervalSchedule.timeStep

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 GeneratingUnit.governorSCD

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 GeneratingUnit.governorSCD

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 GeneratingUnit.highControlLimit

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 GeneratingUnit.highControlLimit

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 GeneratingUnit.highControlLimit

Type: object or number

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

Same definition as GeneratingUnit.highControlLimit

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 GeneratingUnit.highControlLimit

Type: object or number

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

Same definition as GeneratingUnit.highControlLimit

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 GeneratingUnit.highControlLimit

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 GeneratingUnit.highControlLimit

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 GeneratingUnit.highControlLimit

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 GeneratingUnit.highControlLimit

Type: number

Generating unit short term economic participation factor.

Type: object

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

Same definition as GeneratingUnit.startupCost

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 RegularIntervalSchedule.timeStep

Type: number

Generating unit economic participation factor.

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

The variable cost component of production per unit of ActivePower.

Same definition as GeneratingUnit.startupCost

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: object or number

The efficiency of the unit in converting the fuel into electrical energy.

Same definition as GeneratingUnit.governorSCD

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 GeneratingUnit.highControlLimit

Type: object or number

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

Same definition as GeneratingUnit.highControlLimit

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 GeneratingUnit.highControlLimit

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 GeneratingUnit.highControlLimit

Type: object or number

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

Same definition as RegularIntervalSchedule.timeStep

Type: object or number

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

Same definition as RegularIntervalSchedule.timeStep

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 GeneratingUnit.governorSCD

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 GeneratingUnit.governorSCD

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 GeneratingUnit.highControlLimit

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 GeneratingUnit.highControlLimit

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 GeneratingUnit.highControlLimit

Type: object or number

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

Same definition as GeneratingUnit.highControlLimit

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 GeneratingUnit.highControlLimit

Type: object or number

Minimum time interval between unit shutdown and startup.

Same definition as RegularIntervalSchedule.timeStep

Type: object or number

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

Same definition as GeneratingUnit.highControlLimit

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 GeneratingUnit.highControlLimit

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 GeneratingUnit.highControlLimit

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 GeneratingUnit.highControlLimit

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 GeneratingUnit.highControlLimit

Type: number

Generating unit short term economic participation factor.

Type: object

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

Same definition as GeneratingUnit.startupCost

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 RegularIntervalSchedule.timeStep

Type: number

Generating unit economic participation factor.

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

The variable cost component of production per unit of ActivePower.

Same definition as GeneratingUnit.startupCost

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: object or number

The efficiency of the unit in converting the fuel into electrical energy.

Same definition as GeneratingUnit.governorSCD

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 GeneratingUnit.highControlLimit

Type: object or number

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

Same definition as GeneratingUnit.highControlLimit

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 GeneratingUnit.highControlLimit

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 GeneratingUnit.highControlLimit

Type: object or number

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

Same definition as RegularIntervalSchedule.timeStep

Type: object or number

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

Same definition as RegularIntervalSchedule.timeStep

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 GeneratingUnit.governorSCD

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 GeneratingUnit.governorSCD

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 GeneratingUnit.highControlLimit

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 GeneratingUnit.highControlLimit

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 GeneratingUnit.highControlLimit

Type: object or number

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

Same definition as GeneratingUnit.highControlLimit

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 GeneratingUnit.highControlLimit

Type: object or number

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

Same definition as GeneratingUnit.highControlLimit

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 GeneratingUnit.highControlLimit

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 GeneratingUnit.highControlLimit

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 GeneratingUnit.highControlLimit

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 GeneratingUnit.highControlLimit

Type: number

Generating unit short term economic participation factor.

Type: object

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

Same definition as GeneratingUnit.startupCost

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 RegularIntervalSchedule.timeStep

Type: number

Generating unit economic participation factor.

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

The variable cost component of production per unit of ActivePower.

Same definition as GeneratingUnit.startupCost

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: object or number

The efficiency of the unit in converting the fuel into electrical energy.

Same definition as GeneratingUnit.governorSCD

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 GeneratingUnit.highControlLimit

Type: object or number

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

Same definition as GeneratingUnit.highControlLimit

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 GeneratingUnit.highControlLimit

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 GeneratingUnit.highControlLimit

Type: object or number

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

Same definition as RegularIntervalSchedule.timeStep

Type: object or number

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

Same definition as RegularIntervalSchedule.timeStep

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 GeneratingUnit.governorSCD

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

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.

Must be one of:

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

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).

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

nan

Same definition as unit

Type: number Default: null

nan

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 RegularIntervalSchedule.timeStep

Type: object or number

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

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

nan

Same definition as unit

Type: number Default: null

nan

Type: object or number

Maximum voltage limit for the unit.

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

nan

Same definition as unit

Type: number Default: null

nan

Type: object or number

Minimum reactive power limit for the unit.

Same definition as SynchronousMachine.maxQ

Type: object or number

Minimum voltage limit for the unit.

Same definition as SynchronousMachine.maxU

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 GeneratingUnit.governorSCD

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: enum (of string) Default: "ohm"

nan

Same definition as unit

Type: number Default: null

nan

Type: object or number

Zero sequence resistance of the synchronous machine.

Same definition as SynchronousMachine.r

Type: object or number

Negative sequence resistance.

Same definition as SynchronousMachine.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 GeneratingUnit.governorMPL

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 GeneratingUnit.governorMPL

Type: object or number

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

Same definition as GeneratingUnit.governorMPL

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 GeneratingUnit.governorSCD

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.

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

nan

Same definition as unit

Type: number Default: null

nan

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 GeneratingUnit.governorSCD

Type: object or number

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

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

nan

Same definition as unit

Type: number Default: null

nan

Type: object or number

Zero sequence reactance of the synchronous machine.

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

nan

Same definition as unit

Type: number Default: null

nan

Type: object or number

Negative sequence reactance.

Same definition as SynchronousMachine.x0

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 GeneratingUnit.highControlLimit

Type: boolean

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

Type: object or number

Damper 1 winding resistance.

Same definition as SynchronousMachine.r

Type: object or number

Damper 2 winding resistance.

Same definition as SynchronousMachine.r

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 RegularIntervalSchedule.timeStep

Type: object or number

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

Same definition as RegularIntervalSchedule.timeStep

Type: object or number

Damper 1 winding leakage reactance.

Same definition as SynchronousMachine.x0

Type: object or number

Damper 2 winding leakage reactance.

Same definition as SynchronousMachine.x0

Type: object or number

Magnetizing reactance.

Same definition as SynchronousMachine.x0

Type: object or number

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

Same definition as SynchronousMachine.x0

Type: object or number

Sub-transient reactance (unsaturated).

Same definition as SynchronousMachine.x0

Type: object or number

Synchronous reactance (greater than xp).

Same definition as SynchronousMachine.x0

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.

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

nan

Same definition as unit

Type: number Default: null

nan

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 SynchronousMachine.maxU

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 GeneratingUnit.highControlLimit

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 SynchronousMachine.maxQ

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 RegularIntervalSchedule.timeStep

Type: object or number

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

Same definition as RegularIntervalSchedule.timeStep

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 SynchronousMachine.maxQ

Type: object or number

Active power consumed when in condenser mode operation.

Same definition as GeneratingUnit.highControlLimit

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 SynchronousMachine.r

Type: object or number

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

Same definition as SynchronousMachine.x0