MktGeneratingUnit

InstanceSet

1

InstanceSet

Dataset containing the data objects.

GeneratingUnitDynamicValues

0..*

GeneratingUnitDynamicValues

n/a

AssetDatasheet

0..1

AssetInfo

Datasheet information for this power system resource.

EquipmentContainer

0..1

EquipmentContainer

Container of this equipment.

GenUnitOpSchedule

0..1

GenUnitOpSchedule

A generating unit may have an operating schedule, indicating the planned operation of the unit.

Location

0..1

Location

Location of this power system resource.

PSRType

0..1

PSRType

Custom classification for this power system resource.

PropertiesCIMDataObject

0..1

ChangeSetMember

The single CIM data object in the appropriate dataset context.

aggregate

0..1

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.

aliasName

0..1

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.

allocSpinResP

0..1

ActivePower

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

autoCntrlMarginP

0..1

ActivePower

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

baseP

0..1

ActivePower

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.

controlDeadband

0..1

ActivePower

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.

controlPulseHigh

0..1

Seconds

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

controlPulseLow

0..1

Seconds

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

controlResponseRate

0..1

ActivePowerChangeRate

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.

description

0..1

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.

efficiency

0..1

PerCent

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

genControlMode

0..1

GeneratorControlMode

The unit control mode.

genControlSource

0..1

GeneratorControlSource

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

governorMPL

0..1

PU

Governor motor position limit.

governorSCD

0..1

PerCent

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.

highControlLimit

0..1

ActivePower

High limit for secondary (AGC) control.

inService

0..1

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.

initialP

0..1

ActivePower

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

longPF

0..1

float

Generating unit long term economic participation factor.

lowControlLimit

0..1

ActivePower

Low limit for secondary (AGC) control.

lowerRampRate

0..1

ActivePowerChangeRate

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

mRID

0..1

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.

maxEconomicP

0..1

ActivePower

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

maxOperatingP

0..1

ActivePower

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

maximumAllowableSpinningReserve

0..1

ActivePower

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

minEconomicP

0..1

ActivePower

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

minOperatingP

0..1

ActivePower

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

minimumOffTime

0..1

Seconds

Minimum time interval between unit shutdown and startup.

modelDetail

0..1

Classification

Detail level of the generator model data.

name

0..1

string

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

networkAnalysisEnabled

0..1

boolean

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

nominalP

0..1

ActivePower

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.

normalPF

0..1

float

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.

normallyInService

0..1

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.

penaltyFactor

0..1

float

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

raiseRampRate

0..1

ActivePowerChangeRate

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

ratedGrossMaxP

0..1

ActivePower

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

ratedGrossMinP

0..1

ActivePower

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.

ratedNetMaxP

0..1

ActivePower

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.

shortPF

0..1

float

Generating unit short term economic participation factor.

startupCost

0..1

Money

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

startupTime

0..1

Seconds

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

tieLinePF

0..1

float

Generating unit economic participation factor.

totalEfficiency

0..1

PerCent

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

variableCost

0..1

Money

The variable cost component of production per unit of ActivePower.

AdditionalEquipmentContainer

0..*

EquipmentContainer

Additional equipment container beyond the primary equipment container. The equipment is contained in another equipment container, but also grouped with this equipment container.

Assets

0..*

Asset

All assets represented by this power system resource. For example, multiple conductor assets are electrically modelled as a single AC line segment.

Clearances

0..*

ClearanceDocument

All clearances applicable to this power system resource.

ConfigurationEvent

0..*

ConfigurationEvent

All configuration events created for this Power System resource.

ContingencyEquipment

0..*

ContingencyEquipment

The contingency equipments in which this equipment participates.

ControlAreaGeneratingUnit

0..*

ControlAreaGeneratingUnit

ControlArea specifications for this generating unit.

Controls

0..*

Control

The controller outputs used to actually govern a regulating device, e.g. the magnetization of a synchronous machine or capacitor bank breaker actuator.

DiagramObjects

0..*

DiagramObject

The diagram objects that are associated with the domain object.

EqiupmentLimitSeriesComponent

0..*

EquipmentLimitSeriesComponent

Equipment limit series calculation component to which this equipment contributes.

EquipmentUnavailabilitySchedule

0..*

EquipmentUnavailabilitySchedule

n/a

Faults

0..*

Fault

All faults on this equipment.

GenUnitOpCostCurves

0..*

GenUnitOpCostCurve

A generating unit may have one or more cost curves, depending upon fuel mixture and fuel cost.

GenericAction

0..*

GenericAction

The generic action that is performed on the power system resource

GrossToNetActivePowerCurves

0..*

GrossToNetActivePowerCurve

A generating unit may have a gross active power to net active power curve, describing the losses and auxiliary power requirements of the unit.

LimitDependencyModel

0..*

LimitDependency

Limit dependencymodels organized under this equipment as a means for organizing the model in a tree view.

Measurements

0..*

Measurement

The measurements associated with this power system resource.

Names

0..*

Name

All names of this identified object.

OperatingShare

0..*

OperatingShare

The operating shares of this power system resource.

OperationalLimitSet

0..*

OperationalLimitSet

The operational limit sets associated with this equipment.

OperationalRestrictions

0..*

OperationalRestriction

All operational restrictions for this equipment.

OperationalTags

0..*

OperationalTag

All operational tags placed on this power system resource.

Outages

0..*

Outage

All outages in which this equipment is involved.

PSREvents

0..*

PSREvent

All events associated with this power system resource.

PinEquipment

0..*

PinEquipment

n/a

ProtectiveActionEquipment

0..*

ProtectiveActionEquipment

Protective action is controlling equipment. This can be direct signals from the control center, or emulation of action done by protection equipment.

ReportingGroup

0..*

ReportingGroup

Reporting groups to which this power system resource belongs.

RotatingMachine

0..*

RotatingMachine

A synchronous machine may operate as a generator and as such becomes a member of a generating unit.

TargetingCIMDataObject

0..*

ChangeSetMember

Data objects registered.

UsagePoints

0..*

UsagePoint

All usage points connected to the electrical grid through this equipment.

VerificationAction

0..*

VerificationAction

The verification action that is performed on the power system resource

WeatherStation

0..*

WeatherStation

n/a