Skip to content

EquivalentBranch

The class represents equivalent branches. In cases where a transformer phase shift is modelled and the EquivalentBranch is spanning the same nodes, the impedance quantities for the EquivalentBranch shall consider the needed phase shift.

URI: cim:EquivalentBranch
Type: Class

EquivalentBranch class diagram

Inheritance

Attributes

Name URI Cardinality and Range Inheritance Description
r cim:EquivalentBranch.r 1..1 Resistance direct Positive sequence series resistance of the reduced branch.
r21 cim:EquivalentBranch.r21 0..1 Resistance direct Resistance from terminal sequence 2 to terminal sequence 1 .Used for steady state power flow. This attribute is optional and represent unbalanced network such as off-nominal phase shifter. If only EquivalentBranch.r is given, then EquivalentBranch.r21 is assumed equal to EquivalentBranch.r.Usage rule : EquivalentBranch is a result of network reduction prior to the data exchange.
x cim:EquivalentBranch.x 1..1 Reactance direct Positive sequence series reactance of the reduced branch.
x21 cim:EquivalentBranch.x21 0..1 Reactance direct Reactance from terminal sequence 2 to terminal sequence 1. Used for steady state power flow. This attribute is optional and represents an unbalanced network such as off-nominal phase shifter. If only EquivalentBranch.x is given, then EquivalentBranch.x21 is assumed equal to EquivalentBranch.x.Usage rule: EquivalentBranch is a result of network reduction prior to the data exchange.
EquivalentNetwork cim:EquivalentEquipment.EquivalentNetwork 0..1 EquivalentNetwork EquivalentEquipment The equivalent where the reduced model belongs.
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:EquivalentBranch",
    "cim:EquivalentBranch.r": "float",
    "cim:EquivalentBranch.r21": "float",
    "cim:EquivalentBranch.x": "float",
    "cim:EquivalentBranch.x21": "float",
    "cim:EquivalentEquipment.EquivalentNetwork": { "@id": "urn:uuid:<uuid of EquivalentNetwork>" },
    "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:EquivalentBranch rdf:ID="_<uuid>">
    <cim:EquivalentBranch.r>float</cim:EquivalentBranch.r>
    <cim:EquivalentBranch.r21>float</cim:EquivalentBranch.r21>
    <cim:EquivalentBranch.x>float</cim:EquivalentBranch.x>
    <cim:EquivalentBranch.x21>float</cim:EquivalentBranch.x21>
    <cim:EquivalentEquipment.EquivalentNetwork rdf:resource="#_<uuid of EquivalentNetwork>" />
    <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:EquivalentBranch>

{
    "r": "float",
    "r21": "float",
    "x": "float",
    "x21": "float",
    "EquivalentNetwork": "<EquivalentNetwork>",
    "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:EquivalentBranch ;
        cim:EquivalentBranch.r "float" ;
        cim:EquivalentBranch.r21 "float" ;
        cim:EquivalentBranch.x "float" ;
        cim:EquivalentBranch.x21 "float" ;
        cim:EquivalentEquipment.EquivalentNetwork <urn:uuid:<uuid of EquivalentNetwork>> ;
        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