Skip to content

EnergyConsumer

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

URI: cim:EnergyConsumer
Type: Class

EnergyConsumer class diagram

Inheritance

Attributes

Name URI Cardinality and Range Inheritance Description
pfixed cim:EnergyConsumer.pfixed 0..1 ActivePower direct Active power of the load that is a fixed quantity and does not vary as load group value varies. Load sign convention is used, i.e. positive sign means flow out from a node.
pfixedPct cim:EnergyConsumer.pfixedPct 0..1 PerCent direct Fixed active power as a percentage of load group fixed active power. Used to represent the time-varying components. Load sign convention is used, i.e. positive sign means flow out from a node.
qfixed cim:EnergyConsumer.qfixed 0..1 ReactivePower direct Reactive power of the load that is a fixed quantity and does not vary as load group value varies. Load sign convention is used, i.e. positive sign means flow out from a node.
qfixedPct cim:EnergyConsumer.qfixedPct 0..1 PerCent direct Fixed reactive power as a percentage of load group fixed reactive power. Used to represent the time-varying components. Load sign convention is used, i.e. positive sign means flow out from a node.
LoadResponse cim:EnergyConsumer.LoadResponse 0..1 LoadResponseCharacteristic direct The load response characteristic of this load. If missing, this load is assumed to be constant power.
BaseVoltage cim:ConductingEquipment.BaseVoltage 0..1 BaseVoltage ConductingEquipment Base voltage of this conducting equipment. Use only when there is no voltage level container used and only one base voltage applies. For example, not used for transformers.
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:EnergyConsumer",
    "cim:EnergyConsumer.pfixed": "float",
    "cim:EnergyConsumer.pfixedPct": "float",
    "cim:EnergyConsumer.qfixed": "float",
    "cim:EnergyConsumer.qfixedPct": "float",
    "cim:EnergyConsumer.LoadResponse": { "@id": "urn:uuid:<uuid of LoadResponseCharacteristic>" },
    "cim:ConductingEquipment.BaseVoltage": { "@id": "urn:uuid:<uuid of BaseVoltage>" },
    "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:EnergyConsumer rdf:ID="_<uuid>">
    <cim:EnergyConsumer.pfixed>float</cim:EnergyConsumer.pfixed>
    <cim:EnergyConsumer.pfixedPct>float</cim:EnergyConsumer.pfixedPct>
    <cim:EnergyConsumer.qfixed>float</cim:EnergyConsumer.qfixed>
    <cim:EnergyConsumer.qfixedPct>float</cim:EnergyConsumer.qfixedPct>
    <cim:EnergyConsumer.LoadResponse rdf:resource="#_<uuid of LoadResponseCharacteristic>" />
    <cim:ConductingEquipment.BaseVoltage rdf:resource="#_<uuid of BaseVoltage>" />
    <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:EnergyConsumer>

{
    "pfixed": "float",
    "pfixedPct": "float",
    "qfixed": "float",
    "qfixedPct": "float",
    "LoadResponse": "<LoadResponseCharacteristic>",
    "BaseVoltage": "<BaseVoltage>",
    "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:EnergyConsumer ;
        cim:EnergyConsumer.pfixed "float" ;
        cim:EnergyConsumer.pfixedPct "float" ;
        cim:EnergyConsumer.qfixed "float" ;
        cim:EnergyConsumer.qfixedPct "float" ;
        cim:EnergyConsumer.LoadResponse <urn:uuid:<uuid of LoadResponseCharacteristic>> ;
        cim:ConductingEquipment.BaseVoltage <urn:uuid:<uuid of BaseVoltage>> ;
        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