Skip to content

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.

URI: cim:GeneratingUnit
Type: Class

GeneratingUnit class diagram

Inheritance

Attributes

Name URI Cardinality and Range Inheritance Description
governorSCD cim:GeneratingUnit.governorSCD 0..1 PerCent direct 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.
longPF cim:GeneratingUnit.longPF 0..1 float direct Generating unit long term economic participation factor.
maximumAllowableSpinningReserve cim:GeneratingUnit.maximumAllowableSpinningReserve 0..1 ActivePower direct Maximum allowable spinning reserve. Spinning reserve will never be considered greater than this value regardless of the current operating point.
maxOperatingP cim:GeneratingUnit.maxOperatingP 1..1 ActivePower direct This is the maximum operating active power limit the dispatcher can enter for this unit.
minOperatingP cim:GeneratingUnit.minOperatingP 1..1 ActivePower direct This is the minimum operating active power limit the dispatcher can enter for this unit.
nominalP cim:GeneratingUnit.nominalP 0..1 ActivePower direct 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.
ratedGrossMaxP cim:GeneratingUnit.ratedGrossMaxP 0..1 ActivePower direct The unit's gross rated maximum capacity (book value).The attribute shall be a positive value.
ratedGrossMinP cim:GeneratingUnit.ratedGrossMinP 0..1 ActivePower direct 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 cim:GeneratingUnit.ratedNetMaxP 0..1 ActivePower direct 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 cim:GeneratingUnit.shortPF 0..1 float direct Generating unit short term economic participation factor.
startupCost cim:GeneratingUnit.startupCost 0..1 Money direct The initial startup cost incurred for each start of the GeneratingUnit.
startupTime cim:GeneratingUnit.startupTime 0..1 Seconds direct Time it takes to get the unit on-line, from the time that the prime mover mechanical power is applied.
totalEfficiency cim:GeneratingUnit.totalEfficiency 0..1 PerCent direct The efficiency of the unit in converting the fuel into electrical energy.
variableCost cim:GeneratingUnit.variableCost 0..1 Money direct The variable cost component of production per unit of ActivePower.
aggregate cim:Equipment.aggregate 0..1 boolean Equipment 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.
normallyInService cim:Equipment.normallyInService 0..1 boolean Equipment 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.
EquipmentContainer cim:Equipment.EquipmentContainer 0..1 EquipmentContainer Equipment Container of this equipment.
mRID cim:IdentifiedObject.mRID 1..1 string IdentifiedObject 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.
description cim:IdentifiedObject.description 0..1 string IdentifiedObject 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.
energyIdentCodeEic eu:IdentifiedObject.energyIdentCodeEic 0..1 string IdentifiedObject The attribute is used for an exchange of the EIC code (Energy identification Code). The length of the string is 16 characters as defined by the EIC code. For details on EIC scheme please refer to ENTSO-E web site.
name cim:IdentifiedObject.name 1..1 string IdentifiedObject The name is any free human readable and possibly non unique text naming the object.
shortName eu:IdentifiedObject.shortName 0..1 string IdentifiedObject The attribute is used for an exchange of a human readable short name with length of the string 12 characters maximum.

Format Examples

{
    "@context": {"rdf": "http://www.w3.org/1999/02/22-rdf-syntax-ns#", "linkml": "https://w3id.org/linkml/", "sh": "http://www.w3.org/ns/shacl#", "skos": "http://www.w3.org/2004/02/skos/core#", "dc": "http://purl.org/dc/elements/1.1/", "profcim": "http://iec.ch/TC57/ns/CIM/prof-cim#", "owl": "http://www.w3.org/2002/07/owl#", "cim": "http://iec.ch/TC57/CIM100#", "this": "http://ucaiug.org/ns/CGMES/CoreEquipment-EU/3.0#", "cims": "http://iec.ch/TC57/1999/rdf-schema-extensions-19990926#", "dct": "http://purl.org/dc/terms/", "rdfs": "http://www.w3.org/2000/01/rdf-schema#", "dcat": "http://www.w3.org/ns/dcat#", "eu": "http://iec.ch/TC57/CIM100-European#"},
    "@id": "urn:uuid:<uuid>",
    "@type": "cim:GeneratingUnit",
    "cim:GeneratingUnit.governorSCD": "float",
    "cim:GeneratingUnit.longPF": "float",
    "cim:GeneratingUnit.maximumAllowableSpinningReserve": "float",
    "cim:GeneratingUnit.maxOperatingP": "float",
    "cim:GeneratingUnit.minOperatingP": "float",
    "cim:GeneratingUnit.nominalP": "float",
    "cim:GeneratingUnit.ratedGrossMaxP": "float",
    "cim:GeneratingUnit.ratedGrossMinP": "float",
    "cim:GeneratingUnit.ratedNetMaxP": "float",
    "cim:GeneratingUnit.shortPF": "float",
    "cim:GeneratingUnit.startupCost": "Decimal",
    "cim:GeneratingUnit.startupTime": "float",
    "cim:GeneratingUnit.totalEfficiency": "float",
    "cim:GeneratingUnit.variableCost": "Decimal",
    "cim:Equipment.aggregate": "boolean",
    "cim:Equipment.normallyInService": "boolean",
    "cim:Equipment.EquipmentContainer": { "@id": "urn:uuid:<uuid of EquipmentContainer>" },
    "cim:IdentifiedObject.mRID": "string",
    "cim:IdentifiedObject.description": "string",
    "eu:IdentifiedObject.energyIdentCodeEic": "string",
    "cim:IdentifiedObject.name": "string",
    "eu:IdentifiedObject.shortName": "string"
}

<cim:GeneratingUnit rdf:ID="_<uuid>">
    <cim:GeneratingUnit.governorSCD>float</cim:GeneratingUnit.governorSCD>
    <cim:GeneratingUnit.longPF>float</cim:GeneratingUnit.longPF>
    <cim:GeneratingUnit.maximumAllowableSpinningReserve>float</cim:GeneratingUnit.maximumAllowableSpinningReserve>
    <cim:GeneratingUnit.maxOperatingP>float</cim:GeneratingUnit.maxOperatingP>
    <cim:GeneratingUnit.minOperatingP>float</cim:GeneratingUnit.minOperatingP>
    <cim:GeneratingUnit.nominalP>float</cim:GeneratingUnit.nominalP>
    <cim:GeneratingUnit.ratedGrossMaxP>float</cim:GeneratingUnit.ratedGrossMaxP>
    <cim:GeneratingUnit.ratedGrossMinP>float</cim:GeneratingUnit.ratedGrossMinP>
    <cim:GeneratingUnit.ratedNetMaxP>float</cim:GeneratingUnit.ratedNetMaxP>
    <cim:GeneratingUnit.shortPF>float</cim:GeneratingUnit.shortPF>
    <cim:GeneratingUnit.startupCost>Decimal</cim:GeneratingUnit.startupCost>
    <cim:GeneratingUnit.startupTime>float</cim:GeneratingUnit.startupTime>
    <cim:GeneratingUnit.totalEfficiency>float</cim:GeneratingUnit.totalEfficiency>
    <cim:GeneratingUnit.variableCost>Decimal</cim:GeneratingUnit.variableCost>
    <cim:Equipment.aggregate>boolean</cim:Equipment.aggregate>
    <cim:Equipment.normallyInService>boolean</cim:Equipment.normallyInService>
    <cim:Equipment.EquipmentContainer rdf:resource="#_<uuid of EquipmentContainer>" />
    <cim:IdentifiedObject.mRID>string</cim:IdentifiedObject.mRID>
    <cim:IdentifiedObject.description>string</cim:IdentifiedObject.description>
    <eu:IdentifiedObject.energyIdentCodeEic>string</eu:IdentifiedObject.energyIdentCodeEic>
    <cim:IdentifiedObject.name>string</cim:IdentifiedObject.name>
    <eu:IdentifiedObject.shortName>string</eu:IdentifiedObject.shortName>
</cim:GeneratingUnit>

{
    "governorSCD": "float",
    "longPF": "float",
    "maximumAllowableSpinningReserve": "float",
    "maxOperatingP": "float",
    "minOperatingP": "float",
    "nominalP": "float",
    "ratedGrossMaxP": "float",
    "ratedGrossMinP": "float",
    "ratedNetMaxP": "float",
    "shortPF": "float",
    "startupCost": "Decimal",
    "startupTime": "float",
    "totalEfficiency": "float",
    "variableCost": "Decimal",
    "aggregate": "boolean",
    "normallyInService": "boolean",
    "EquipmentContainer": "<EquipmentContainer>",
    "mRID": "string",
    "description": "string",
    "energyIdentCodeEic": "string",
    "name": "string",
    "shortName": "string"
}

<urn:uuid:<graph-id>> {
    <urn:uuid:<uuid>>
        a cim:GeneratingUnit ;
        cim:GeneratingUnit.governorSCD "float" ;
        cim:GeneratingUnit.longPF "float" ;
        cim:GeneratingUnit.maximumAllowableSpinningReserve "float" ;
        cim:GeneratingUnit.maxOperatingP "float" ;
        cim:GeneratingUnit.minOperatingP "float" ;
        cim:GeneratingUnit.nominalP "float" ;
        cim:GeneratingUnit.ratedGrossMaxP "float" ;
        cim:GeneratingUnit.ratedGrossMinP "float" ;
        cim:GeneratingUnit.ratedNetMaxP "float" ;
        cim:GeneratingUnit.shortPF "float" ;
        cim:GeneratingUnit.startupCost "Decimal" ;
        cim:GeneratingUnit.startupTime "float" ;
        cim:GeneratingUnit.totalEfficiency "float" ;
        cim:GeneratingUnit.variableCost "Decimal" ;
        cim:Equipment.aggregate "boolean" ;
        cim:Equipment.normallyInService "boolean" ;
        cim:Equipment.EquipmentContainer <urn:uuid:<uuid of EquipmentContainer>> ;
        cim:IdentifiedObject.mRID "string" ;
        cim:IdentifiedObject.description "string" ;
        eu:IdentifiedObject.energyIdentCodeEic "string" ;
        cim:IdentifiedObject.name "string" ;
        eu:IdentifiedObject.shortName "string" .
}

Schema Source