GeneratingUnit
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 |
Class |
|---|---|
URI |
|
CIM standard (perspective) |
IEC61970 (Grid) |
Slots
| Name | Cardinality | Type | Description |
|---|---|---|---|
1 |
Dataset containing the data objects. |
||
0..1 |
A generating unit may have an operating schedule, indicating the planned operation of the unit. |
||
0..1 |
The planned unused capacity (spinning reserve) which can be used to support emergency load. |
||
0..1 |
The planned unused capacity which can be used to support automatic control overruns. |
||
0..1 |
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. |
||
0..1 |
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. |
||
0..1 |
Pulse high limit which is the largest control pulse that the unit can respond to. |
||
0..1 |
Pulse low limit which is the smallest control pulse that the unit can respond to. |
||
0..1 |
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. |
||
0..1 |
The efficiency of the unit in converting mechanical energy, from the prime mover, into electrical energy. |
||
0..1 |
The unit control mode. |
||
0..1 |
The source of controls for a generating unit. Defines the control status of the generating unit. |
||
0..1 |
Governor motor position limit. |
||
0..1 |
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. |
||
0..1 |
High limit for secondary (AGC) control. |
||
0..1 |
Default initial active power which is used to store a powerflow result for the initial active power for this unit in this network configuration. |
||
0..1 |
Generating unit long term economic participation factor. |
||
0..1 |
Low limit for secondary (AGC) control. |
||
0..1 |
The normal maximum rate the generating unit active power output can be lowered by control actions. |
||
0..1 |
Maximum high economic active power limit, that should not exceed the maximum operating active power limit. |
||
0..1 |
This is the maximum operating active power limit the dispatcher can enter for this unit. |
||
0..1 |
Maximum allowable spinning reserve. Spinning reserve will never be considered greater than this value regardless of the current operating point. |
||
0..1 |
Low economic active power limit that shall be greater than or equal to the minimum operating active power limit. |
||
0..1 |
This is the minimum operating active power limit the dispatcher can enter for this unit. |
||
0..1 |
Minimum time interval between unit shutdown and startup. |
||
0..1 |
Detail level of the generator model data. |
||
0..1 |
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. |
||
0..1 |
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. |
||
0..1 |
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). |
||
0..1 |
The normal maximum rate the generating unit active power output can be raised by control actions. |
||
0..1 |
The unit's gross rated maximum capacity (book value). The attribute shall be a positive value. |
||
0..1 |
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. |
||
0..1 |
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. |
||
0..1 |
Generating unit short term economic participation factor. |
||
0..1 |
The initial startup cost incurred for each start of the GeneratingUnit. |
||
0..1 |
Time it takes to get the unit on-line, from the time that the prime mover mechanical power is applied. |
||
0..1 |
Generating unit economic participation factor. |
||
0..1 |
The efficiency of the unit in converting the fuel into electrical energy. |
||
0..1 |
The variable cost component of production per unit of ActivePower. |
||
0..* |
ControlArea specifications for this generating unit. |
||
0..* |
A generating unit may have one or more cost curves, depending upon fuel mixture and fuel cost. |
||
0..* |
A generating unit may have a gross active power to net active power curve, describing the losses and auxiliary power requirements of the unit. |
||
0..* |
A synchronous machine may operate as a generator and as such becomes a member of a generating unit. |
||
0..1 |
Datasheet information for this power system resource. |
||
0..1 |
Container of this equipment. |
||
0..1 |
Location of this power system resource. |
||
0..1 |
Custom classification for this power system resource. |
||
0..1 |
The single CIM data object in the appropriate dataset context. |
||
0..1 |
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. |
||
0..1 |
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. |
||
0..1 |
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. |
||
0..1 |
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. |
||
0..1 |
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. |
||
0..1 |
The name is any free human readable and possibly non unique text naming the object. |
||
0..1 |
The equipment is enabled to participate in network analysis. If unspecified, the value is assumed to be true. |
||
0..1 |
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. |
||
0..* |
Additional equipment container beyond the primary equipment container. The equipment is contained in another equipment container, but also grouped with this equipment container. |
||
0..* |
All assets represented by this power system resource. For example, multiple conductor assets are electrically modelled as a single AC line segment. |
||
0..* |
All clearances applicable to this power system resource. |
||
0..* |
All configuration events created for this Power System resource. |
||
0..* |
The contingency equipments in which this equipment participates. |
||
0..* |
The controller outputs used to actually govern a regulating device, e.g. the magnetization of a synchronous machine or capacitor bank breaker actuator. |
||
0..* |
The diagram objects that are associated with the domain object. |
||
0..* |
Equipment limit series calculation component to which this equipment contributes. |
||
0..* |
n/a |
||
0..* |
All faults on this equipment. |
||
0..* |
The generic action that is performed on the power system resource |
||
0..* |
Limit dependencymodels organized under this equipment as a means for organizing the model in a tree view. |
||
0..* |
The measurements associated with this power system resource. |
||
0..* |
All names of this identified object. |
||
0..* |
The operating shares of this power system resource. |
||
0..* |
The operational limit sets associated with this equipment. |
||
0..* |
All operational restrictions for this equipment. |
||
0..* |
All operational tags placed on this power system resource. |
||
0..* |
All outages in which this equipment is involved. |
||
0..* |
All events associated with this power system resource. |
||
0..* |
n/a |
||
0..* |
Protective action is controlling equipment. This can be direct signals from the control center, or emulation of action done by protection equipment. |
||
0..* |
Reporting groups to which this power system resource belongs. |
||
0..* |
Data objects registered. |
||
0..* |
All usage points connected to the electrical grid through this equipment. |
||
0..* |
The verification action that is performed on the power system resource |
||
0..* |
n/a |
AdditionalEquipmentContainer
Additional equipment container beyond the primary equipment container. The equipment is contained in another equipment container, but also grouped with this equipment container.
URI |
|
|---|---|
Cardinality |
0..* |
Type |
|
Inherited from |
aggregate
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.
URI |
|
|---|---|
Cardinality |
0..1 |
Type |
|
Inherited from |
aliasName
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.
URI |
|
|---|---|
Cardinality |
0..1 |
Type |
|
Inherited from |
allocSpinResP
The planned unused capacity (spinning reserve) which can be used to support emergency load.
URI |
|
|---|---|
Cardinality |
0..1 |
Type |
AssetDatasheet
Datasheet information for this power system resource.
URI |
|
|---|---|
Cardinality |
0..1 |
Type |
|
Inherited from |
Assets
All assets represented by this power system resource. For example, multiple conductor assets are electrically modelled as a single AC line segment.
URI |
|
|---|---|
Cardinality |
0..* |
Type |
|
Inherited from |
autoCntrlMarginP
The planned unused capacity which can be used to support automatic control overruns.
URI |
|
|---|---|
Cardinality |
0..1 |
Type |
baseP
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.
URI |
|
|---|---|
Cardinality |
0..1 |
Type |
Clearances
All clearances applicable to this power system resource.
URI |
|
|---|---|
Cardinality |
0..* |
Type |
|
Inherited from |
ConfigurationEvent
All configuration events created for this Power System resource.
URI |
|
|---|---|
Cardinality |
0..* |
Type |
|
Inherited from |
ContingencyEquipment
The contingency equipments in which this equipment participates.
URI |
|
|---|---|
Cardinality |
0..* |
Type |
|
Inherited from |
ControlAreaGeneratingUnit
ControlArea specifications for this generating unit.
URI |
|
|---|---|
Cardinality |
0..* |
Type |
controlDeadband
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.
URI |
|
|---|---|
Cardinality |
0..1 |
Type |
controlPulseHigh
Pulse high limit which is the largest control pulse that the unit can respond to.
URI |
|
|---|---|
Cardinality |
0..1 |
Type |
controlPulseLow
Pulse low limit which is the smallest control pulse that the unit can respond to.
URI |
|
|---|---|
Cardinality |
0..1 |
Type |
controlResponseRate
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.
URI |
|
|---|---|
Cardinality |
0..1 |
Type |
Controls
The controller outputs used to actually govern a regulating device, e.g. the magnetization of a synchronous machine or capacitor bank breaker actuator.
URI |
|
|---|---|
Cardinality |
0..* |
Type |
|
Inherited from |
description
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.
URI |
|
|---|---|
Cardinality |
0..1 |
Type |
|
Inherited from |
DiagramObjects
The diagram objects that are associated with the domain object.
URI |
|
|---|---|
Cardinality |
0..* |
Type |
|
Inherited from |
efficiency
The efficiency of the unit in converting mechanical energy, from the prime mover, into electrical energy.
URI |
|
|---|---|
Cardinality |
0..1 |
Type |
EqiupmentLimitSeriesComponent
Equipment limit series calculation component to which this equipment contributes.
URI |
|
|---|---|
Cardinality |
0..* |
Type |
|
Inherited from |
EquipmentContainer
Container of this equipment.
URI |
|
|---|---|
Cardinality |
0..1 |
Type |
|
Inherited from |
EquipmentUnavailabilitySchedule
URI |
|
|---|---|
Cardinality |
0..* |
Type |
|
Inherited from |
genControlSource
The source of controls for a generating unit. Defines the control status of the generating unit.
URI |
|
|---|---|
Cardinality |
0..1 |
Type |
GenericAction
The generic action that is performed on the power system resource
URI |
|
|---|---|
Cardinality |
0..* |
Type |
|
Inherited from |
GenUnitOpCostCurves
A generating unit may have one or more cost curves, depending upon fuel mixture and fuel cost.
URI |
|
|---|---|
Cardinality |
0..* |
Type |
GenUnitOpSchedule
A generating unit may have an operating schedule, indicating the planned operation of the unit.
URI |
|
|---|---|
Cardinality |
0..1 |
Type |
governorSCD
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.
URI |
|
|---|---|
Cardinality |
0..1 |
Type |
GrossToNetActivePowerCurves
A generating unit may have a gross active power to net active power curve, describing the losses and auxiliary power requirements of the unit.
URI |
|
|---|---|
Cardinality |
0..* |
Type |
highControlLimit
High limit for secondary (AGC) control.
URI |
|
|---|---|
Cardinality |
0..1 |
Type |
initialP
Default initial active power which is used to store a powerflow result for the initial active power for this unit in this network configuration.
URI |
|
|---|---|
Cardinality |
0..1 |
Type |
inService
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.
URI |
|
|---|---|
Cardinality |
0..1 |
Type |
|
Inherited from |
InstanceSet
Dataset containing the data objects.
URI |
|
|---|---|
Cardinality |
1 |
Type |
|
Inherited from |
LimitDependencyModel
Limit dependencymodels organized under this equipment as a means for organizing the model in a tree view.
URI |
|
|---|---|
Cardinality |
0..* |
Type |
|
Inherited from |
Location
Location of this power system resource.
URI |
|
|---|---|
Cardinality |
0..1 |
Type |
|
Inherited from |
longPF
Generating unit long term economic participation factor.
URI |
|
|---|---|
Cardinality |
0..1 |
Type |
lowControlLimit
Low limit for secondary (AGC) control.
URI |
|
|---|---|
Cardinality |
0..1 |
Type |
lowerRampRate
The normal maximum rate the generating unit active power output can be lowered by control actions.
URI |
|
|---|---|
Cardinality |
0..1 |
Type |
maxEconomicP
Maximum high economic active power limit, that should not exceed the maximum operating active power limit.
URI |
|
|---|---|
Cardinality |
0..1 |
Type |
maximumAllowableSpinningReserve
Maximum allowable spinning reserve. Spinning reserve will never be considered greater than this value regardless of the current operating point.
URI |
|
|---|---|
Cardinality |
0..1 |
Type |
maxOperatingP
This is the maximum operating active power limit the dispatcher can enter for this unit.
URI |
|
|---|---|
Cardinality |
0..1 |
Type |
Measurements
The measurements associated with this power system resource.
URI |
|
|---|---|
Cardinality |
0..* |
Type |
|
Inherited from |
minEconomicP
Low economic active power limit that shall be greater than or equal to the minimum operating active power limit.
URI |
|
|---|---|
Cardinality |
0..1 |
Type |
minimumOffTime
Minimum time interval between unit shutdown and startup.
URI |
|
|---|---|
Cardinality |
0..1 |
Type |
minOperatingP
This is the minimum operating active power limit the dispatcher can enter for this unit.
URI |
|
|---|---|
Cardinality |
0..1 |
Type |
modelDetail
Detail level of the generator model data.
URI |
|
|---|---|
Cardinality |
0..1 |
Type |
mRID
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.
URI |
|
|---|---|
Cardinality |
0..1 |
Type |
|
Inherited from |
name
The name is any free human readable and possibly non unique text naming the object.
URI |
|
|---|---|
Cardinality |
0..1 |
Type |
|
Inherited from |
Names
All names of this identified object.
URI |
|
|---|---|
Cardinality |
0..* |
Type |
|
Inherited from |
networkAnalysisEnabled
The equipment is enabled to participate in network analysis. If unspecified, the value is assumed to be true.
URI |
|
|---|---|
Cardinality |
0..1 |
Type |
|
Inherited from |
nominalP
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.
URI |
|
|---|---|
Cardinality |
0..1 |
Type |
normallyInService
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.
URI |
|
|---|---|
Cardinality |
0..1 |
Type |
|
Inherited from |
normalPF
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.
URI |
|
|---|---|
Cardinality |
0..1 |
Type |
OperatingShare
The operating shares of this power system resource.
URI |
|
|---|---|
Cardinality |
0..* |
Type |
|
Inherited from |
OperationalLimitSet
The operational limit sets associated with this equipment.
URI |
|
|---|---|
Cardinality |
0..* |
Type |
|
Inherited from |
OperationalRestrictions
All operational restrictions for this equipment.
URI |
|
|---|---|
Cardinality |
0..* |
Type |
|
Inherited from |
OperationalTags
All operational tags placed on this power system resource.
URI |
|
|---|---|
Cardinality |
0..* |
Type |
|
Inherited from |
Outages
All outages in which this equipment is involved.
URI |
|
|---|---|
Cardinality |
0..* |
Type |
|
Inherited from |
penaltyFactor
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).
URI |
|
|---|---|
Cardinality |
0..1 |
Type |
PropertiesCIMDataObject
The single CIM data object in the appropriate dataset context.
URI |
|
|---|---|
Cardinality |
0..1 |
Type |
|
Inherited from |
ProtectiveActionEquipment
Protective action is controlling equipment. This can be direct signals from the control center, or emulation of action done by protection equipment.
URI |
|
|---|---|
Cardinality |
0..* |
Type |
|
Inherited from |
PSREvents
All events associated with this power system resource.
URI |
|
|---|---|
Cardinality |
0..* |
Type |
|
Inherited from |
PSRType
Custom classification for this power system resource.
URI |
|
|---|---|
Cardinality |
0..1 |
Type |
|
Inherited from |
raiseRampRate
The normal maximum rate the generating unit active power output can be raised by control actions.
URI |
|
|---|---|
Cardinality |
0..1 |
Type |
ratedGrossMaxP
The unit's gross rated maximum capacity (book value). The attribute shall be a positive value.
URI |
|
|---|---|
Cardinality |
0..1 |
Type |
ratedGrossMinP
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.
URI |
|
|---|---|
Cardinality |
0..1 |
Type |
ratedNetMaxP
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.
URI |
|
|---|---|
Cardinality |
0..1 |
Type |
ReportingGroup
Reporting groups to which this power system resource belongs.
URI |
|
|---|---|
Cardinality |
0..* |
Type |
|
Inherited from |
RotatingMachine
A synchronous machine may operate as a generator and as such becomes a member of a generating unit.
URI |
|
|---|---|
Cardinality |
0..* |
Type |
shortPF
Generating unit short term economic participation factor.
URI |
|
|---|---|
Cardinality |
0..1 |
Type |
startupCost
The initial startup cost incurred for each start of the GeneratingUnit.
URI |
|
|---|---|
Cardinality |
0..1 |
Type |
startupTime
Time it takes to get the unit on-line, from the time that the prime mover mechanical power is applied.
URI |
|
|---|---|
Cardinality |
0..1 |
Type |
TargetingCIMDataObject
Data objects registered.
URI |
|
|---|---|
Cardinality |
0..* |
Type |
|
Inherited from |
tieLinePF
Generating unit economic participation factor.
URI |
|
|---|---|
Cardinality |
0..1 |
Type |
totalEfficiency
The efficiency of the unit in converting the fuel into electrical energy.
URI |
|
|---|---|
Cardinality |
0..1 |
Type |
UsagePoints
All usage points connected to the electrical grid through this equipment.
URI |
|
|---|---|
Cardinality |
0..* |
Type |
|
Inherited from |
variableCost
The variable cost component of production per unit of ActivePower.
URI |
|
|---|---|
Cardinality |
0..1 |
Type |
VerificationAction
The verification action that is performed on the power system resource
URI |
|
|---|---|
Cardinality |
0..* |
Type |
|
Inherited from |