Skip to content

Class: PowerTransformerEnd

A PowerTransformerEnd is associated with each Terminal of a PowerTransformer.

The impedance values r, r0, x, and x0 of a PowerTransformerEnd represents a star equivalent as follows.

1) for a two Terminal PowerTransformer the high voltage (TransformerEnd.endNumber=1) PowerTransformerEnd has non zero values on r, r0, x, and x0 while the low voltage (TransformerEnd.endNumber=2) PowerTransformerEnd has zero values for r, r0, x, and x0. Parameters are always provided, even if the PowerTransformerEnds have the same rated voltage. In this case, the parameters are provided at the PowerTransformerEnd which has TransformerEnd.endNumber equal to 1.

2) for a three Terminal PowerTransformer the three PowerTransformerEnds represent a star equivalent with each leg in the star represented by r, r0, x, and x0 values.

3) For a three Terminal transformer each PowerTransformerEnd shall have g, g0, b and b0 values corresponding to the no load losses distributed on the three PowerTransformerEnds. The total no load loss shunt impedances may also be placed at one of the PowerTransformerEnds, preferably the end numbered 1, having the shunt values on end 1. This is the preferred way.

4) for a PowerTransformer with more than three Terminals the PowerTransformerEnd impedance values cannot be used. Instead use the TransformerMeshImpedance or split the transformer into multiple PowerTransformers.

Each PowerTransformerEnd must be contained by a PowerTransformer. Because a PowerTransformerEnd (or any other object) can not be contained by more than one parent, a PowerTransformerEnd can not have an association to an EquipmentContainer (Substation, VoltageLevel, etc).

URI: cim:PowerTransformerEnd

 classDiagram
    class PowerTransformerEnd
      TransformerEnd <|-- PowerTransformerEnd

      PowerTransformerEnd : PowerTransformerEnd.b

          PowerTransformerEnd --> Susceptance : PowerTransformerEnd.b

      PowerTransformerEnd : TransformerEnd.BaseVoltage

          PowerTransformerEnd --> BaseVoltage : TransformerEnd.BaseVoltage

      PowerTransformerEnd : PowerTransformerEnd.connectionKind

          PowerTransformerEnd --> WindingConnection : PowerTransformerEnd.connectionKind

      PowerTransformerEnd : IdentifiedObject.description

      PowerTransformerEnd : TransformerEnd.endNumber

      PowerTransformerEnd : IdentifiedObject.energyIdentCodeEic

      PowerTransformerEnd : PowerTransformerEnd.g

          PowerTransformerEnd --> Conductance : PowerTransformerEnd.g

      PowerTransformerEnd : IdentifiedObject.mRID

      PowerTransformerEnd : IdentifiedObject.Names

          PowerTransformerEnd --> Name : IdentifiedObject.Names

      PowerTransformerEnd : PowerTransformerEnd.PowerTransformer

          PowerTransformerEnd --> PowerTransformer : PowerTransformerEnd.PowerTransformer

      PowerTransformerEnd : PowerTransformerEnd.r

          PowerTransformerEnd --> Resistance : PowerTransformerEnd.r

      PowerTransformerEnd : PowerTransformerEnd.ratedU

          PowerTransformerEnd --> Voltage : PowerTransformerEnd.ratedU

      PowerTransformerEnd : IdentifiedObject.shortName

      PowerTransformerEnd : TransformerEnd.Terminal

          PowerTransformerEnd --> Terminal : TransformerEnd.Terminal

      PowerTransformerEnd : PowerTransformerEnd.x

          PowerTransformerEnd --> Reactance : PowerTransformerEnd.x

Inheritance

Slots

Name Cardinality and Range Description Inheritance
power_transformer 1..1
PowerTransformer		 The power transformer of this power transformer end direct
b 1..1
Susceptance		 Magnetizing branch susceptance (B mag) direct
connection_kind 0..1
WindingConnection		 Kind of connection direct
g 0..1
Conductance		 Magnetizing branch conductance direct
rated_u 1..1
Voltage		 Rated voltage: phase-phase for three-phase windings, and either phase-phase o... direct
r 1..1
Resistance		 Resistance (star-model) of the transformer end direct
x 1..1
Reactance		 Positive sequence series reactance (star-model) of the transformer end direct
base_voltage 1..1
BaseVoltage		 Base voltage of the transformer end TransformerEnd
terminal 1..1
Terminal		 Terminal of the power transformer to which this transformer end belongs TransformerEnd
end_number 1..1
Integer		 Number for this transformer end, corresponding to the end's order in the powe... TransformerEnd
description 0..1
String		 The description is a free human readable text describing or naming the object IdentifiedObject
energy_ident_code_eic 0..1
String		 The attribute is used for an exchange of the EIC code (Energy identification ... IdentifiedObject
m_rid 1..1
String		 Master resource identifier issued by a model authority IdentifiedObject
short_name 0..1
String		 The attribute is used for an exchange of a human readable short name with len... IdentifiedObject
names 0..*
Name		 All names of this identified object IdentifiedObject

Usages

used by used in type used
PowerTransformer power_transformer_end range PowerTransformerEnd

Identifier and Mapping Information

Schema Source

  • from schema: http://iec.ch/TC57/ns/CIM/CoreEquipment-EU#Package_CoreEquipmentProfile

Mappings

Mapping Type Mapped Value
self cim:PowerTransformerEnd
native this:PowerTransformerEnd

LinkML Source

Direct

name: PowerTransformerEnd
description: 'A PowerTransformerEnd is associated with each Terminal of a PowerTransformer.

  The impedance values r, r0, x, and x0 of a PowerTransformerEnd represents a star
  equivalent as follows.

  1) for a two Terminal PowerTransformer the high voltage (TransformerEnd.endNumber=1)
  PowerTransformerEnd has non zero values on r, r0, x, and x0 while the low voltage
  (TransformerEnd.endNumber=2) PowerTransformerEnd has zero values for r, r0, x, and
  x0.  Parameters are always provided, even if the PowerTransformerEnds have the same
  rated voltage.  In this case, the parameters are provided at the PowerTransformerEnd
  which has TransformerEnd.endNumber equal to 1.

  2) for a three Terminal PowerTransformer the three PowerTransformerEnds represent
  a star equivalent with each leg in the star represented by r, r0, x, and x0 values.

  3) For a three Terminal transformer each PowerTransformerEnd shall have g, g0, b
  and b0 values corresponding to the no load losses distributed on the three PowerTransformerEnds.
  The total no load loss shunt impedances may also be placed at one of the PowerTransformerEnds,
  preferably the end numbered 1, having the shunt values on end 1.  This is the preferred
  way.

  4) for a PowerTransformer with more than three Terminals the PowerTransformerEnd
  impedance values cannot be used. Instead use the TransformerMeshImpedance or split
  the transformer into multiple PowerTransformers.

  Each PowerTransformerEnd must be contained by a PowerTransformer. Because a PowerTransformerEnd
  (or any other object) can not be contained by more than one parent, a PowerTransformerEnd
  can not have an association to an EquipmentContainer (Substation, VoltageLevel,
  etc).'
from_schema: http://iec.ch/TC57/ns/CIM/CoreEquipment-EU#Package_CoreEquipmentProfile
rank: 1000
is_a: TransformerEnd
attributes:
  power_transformer:
    name: power_transformer
    description: The power transformer of this power transformer end.
    from_schema: http://iec.ch/TC57/ns/CIM/CoreEquipment-EU#Package_CoreEquipmentProfile
    rank: 1000
    slot_uri: cim:PowerTransformerEnd.PowerTransformer
    multivalued: false
    domain_of:
    - PowerTransformerEnd
    range: PowerTransformer
    required: true
  b:
    name: b
    description: Magnetizing branch susceptance (B mag).  The value can be positive
      or negative.
    from_schema: http://iec.ch/TC57/ns/CIM/CoreEquipment-EU#Package_CoreEquipmentProfile
    rank: 1000
    slot_uri: cim:PowerTransformerEnd.b
    multivalued: false
    domain_of:
    - PowerTransformerEnd
    range: Susceptance
    required: true
  connection_kind:
    name: connection_kind
    description: Kind of connection.
    from_schema: http://iec.ch/TC57/ns/CIM/CoreEquipment-EU#Package_CoreEquipmentProfile
    rank: 1000
    slot_uri: cim:PowerTransformerEnd.connectionKind
    multivalued: false
    domain_of:
    - PowerTransformerEnd
    range: WindingConnection
    required: false
  g:
    name: g
    description: Magnetizing branch conductance.
    from_schema: http://iec.ch/TC57/ns/CIM/CoreEquipment-EU#Package_CoreEquipmentProfile
    rank: 1000
    slot_uri: cim:PowerTransformerEnd.g
    multivalued: false
    domain_of:
    - PowerTransformerEnd
    range: Conductance
    required: false
  rated_u:
    name: rated_u
    description: 'Rated voltage: phase-phase for three-phase windings, and either
      phase-phase or phase-neutral for single-phase windings.

      A high voltage side, as given by TransformerEnd.endNumber, shall have a ratedU
      that is greater than or equal to ratedU for the lower voltage sides.

      The attribute shall be a positive value.'
    from_schema: http://iec.ch/TC57/ns/CIM/CoreEquipment-EU#Package_CoreEquipmentProfile
    rank: 1000
    slot_uri: cim:PowerTransformerEnd.ratedU
    multivalued: false
    domain_of:
    - PowerTransformerEnd
    range: Voltage
    required: true
  r:
    name: r
    description: 'Resistance (star-model) of the transformer end.

      The attribute shall be equal to or greater than zero for non-equivalent transformers.'
    from_schema: http://iec.ch/TC57/ns/CIM/CoreEquipment-EU#Package_CoreEquipmentProfile
    slot_uri: cim:PowerTransformerEnd.r
    multivalued: false
    domain_of:
    - ACLineSegment
    - PowerTransformerEnd
    range: Resistance
    required: true
  x:
    name: x
    description: Positive sequence series reactance (star-model) of the transformer
      end.
    from_schema: http://iec.ch/TC57/ns/CIM/CoreEquipment-EU#Package_CoreEquipmentProfile
    slot_uri: cim:PowerTransformerEnd.x
    multivalued: false
    domain_of:
    - ACLineSegment
    - PowerTransformerEnd
    range: Reactance
    required: true
class_uri: cim:PowerTransformerEnd

Induced

name: PowerTransformerEnd
description: 'A PowerTransformerEnd is associated with each Terminal of a PowerTransformer.

  The impedance values r, r0, x, and x0 of a PowerTransformerEnd represents a star
  equivalent as follows.

  1) for a two Terminal PowerTransformer the high voltage (TransformerEnd.endNumber=1)
  PowerTransformerEnd has non zero values on r, r0, x, and x0 while the low voltage
  (TransformerEnd.endNumber=2) PowerTransformerEnd has zero values for r, r0, x, and
  x0.  Parameters are always provided, even if the PowerTransformerEnds have the same
  rated voltage.  In this case, the parameters are provided at the PowerTransformerEnd
  which has TransformerEnd.endNumber equal to 1.

  2) for a three Terminal PowerTransformer the three PowerTransformerEnds represent
  a star equivalent with each leg in the star represented by r, r0, x, and x0 values.

  3) For a three Terminal transformer each PowerTransformerEnd shall have g, g0, b
  and b0 values corresponding to the no load losses distributed on the three PowerTransformerEnds.
  The total no load loss shunt impedances may also be placed at one of the PowerTransformerEnds,
  preferably the end numbered 1, having the shunt values on end 1.  This is the preferred
  way.

  4) for a PowerTransformer with more than three Terminals the PowerTransformerEnd
  impedance values cannot be used. Instead use the TransformerMeshImpedance or split
  the transformer into multiple PowerTransformers.

  Each PowerTransformerEnd must be contained by a PowerTransformer. Because a PowerTransformerEnd
  (or any other object) can not be contained by more than one parent, a PowerTransformerEnd
  can not have an association to an EquipmentContainer (Substation, VoltageLevel,
  etc).'
from_schema: http://iec.ch/TC57/ns/CIM/CoreEquipment-EU#Package_CoreEquipmentProfile
rank: 1000
is_a: TransformerEnd
attributes:
  power_transformer:
    name: power_transformer
    description: The power transformer of this power transformer end.
    from_schema: http://iec.ch/TC57/ns/CIM/CoreEquipment-EU#Package_CoreEquipmentProfile
    rank: 1000
    slot_uri: cim:PowerTransformerEnd.PowerTransformer
    multivalued: false
    alias: power_transformer
    owner: PowerTransformerEnd
    domain_of:
    - PowerTransformerEnd
    range: PowerTransformer
    required: true
  b:
    name: b
    description: Magnetizing branch susceptance (B mag).  The value can be positive
      or negative.
    from_schema: http://iec.ch/TC57/ns/CIM/CoreEquipment-EU#Package_CoreEquipmentProfile
    rank: 1000
    slot_uri: cim:PowerTransformerEnd.b
    multivalued: false
    alias: b
    owner: PowerTransformerEnd
    domain_of:
    - PowerTransformerEnd
    range: Susceptance
    required: true
  connection_kind:
    name: connection_kind
    description: Kind of connection.
    from_schema: http://iec.ch/TC57/ns/CIM/CoreEquipment-EU#Package_CoreEquipmentProfile
    rank: 1000
    slot_uri: cim:PowerTransformerEnd.connectionKind
    multivalued: false
    alias: connection_kind
    owner: PowerTransformerEnd
    domain_of:
    - PowerTransformerEnd
    range: WindingConnection
    required: false
  g:
    name: g
    description: Magnetizing branch conductance.
    from_schema: http://iec.ch/TC57/ns/CIM/CoreEquipment-EU#Package_CoreEquipmentProfile
    rank: 1000
    slot_uri: cim:PowerTransformerEnd.g
    multivalued: false
    alias: g
    owner: PowerTransformerEnd
    domain_of:
    - PowerTransformerEnd
    range: Conductance
    required: false
  rated_u:
    name: rated_u
    description: 'Rated voltage: phase-phase for three-phase windings, and either
      phase-phase or phase-neutral for single-phase windings.

      A high voltage side, as given by TransformerEnd.endNumber, shall have a ratedU
      that is greater than or equal to ratedU for the lower voltage sides.

      The attribute shall be a positive value.'
    from_schema: http://iec.ch/TC57/ns/CIM/CoreEquipment-EU#Package_CoreEquipmentProfile
    rank: 1000
    slot_uri: cim:PowerTransformerEnd.ratedU
    multivalued: false
    alias: rated_u
    owner: PowerTransformerEnd
    domain_of:
    - PowerTransformerEnd
    range: Voltage
    required: true
  r:
    name: r
    description: 'Resistance (star-model) of the transformer end.

      The attribute shall be equal to or greater than zero for non-equivalent transformers.'
    from_schema: http://iec.ch/TC57/ns/CIM/CoreEquipment-EU#Package_CoreEquipmentProfile
    slot_uri: cim:PowerTransformerEnd.r
    multivalued: false
    alias: r
    owner: PowerTransformerEnd
    domain_of:
    - ACLineSegment
    - PowerTransformerEnd
    range: Resistance
    required: true
  x:
    name: x
    description: Positive sequence series reactance (star-model) of the transformer
      end.
    from_schema: http://iec.ch/TC57/ns/CIM/CoreEquipment-EU#Package_CoreEquipmentProfile
    slot_uri: cim:PowerTransformerEnd.x
    multivalued: false
    alias: x
    owner: PowerTransformerEnd
    domain_of:
    - ACLineSegment
    - PowerTransformerEnd
    range: Reactance
    required: true
  base_voltage:
    name: base_voltage
    description: Base voltage of the transformer end.  This is essential for PU calculation.
    from_schema: http://iec.ch/TC57/ns/CIM/CoreEquipment-EU#Package_CoreEquipmentProfile
    slot_uri: cim:TransformerEnd.BaseVoltage
    multivalued: false
    alias: base_voltage
    owner: PowerTransformerEnd
    domain_of:
    - ConductingEquipment
    - VoltageLevel
    - TransformerEnd
    range: BaseVoltage
    required: true
  terminal:
    name: terminal
    description: Terminal of the power transformer to which this transformer end belongs.
    from_schema: http://iec.ch/TC57/ns/CIM/CoreEquipment-EU#Package_CoreEquipmentProfile
    rank: 1000
    slot_uri: cim:TransformerEnd.Terminal
    multivalued: false
    alias: terminal
    owner: PowerTransformerEnd
    domain_of:
    - TransformerEnd
    range: Terminal
    required: true
  end_number:
    name: end_number
    description: Number for this transformer end, corresponding to the end's order
      in the power transformer vector group or phase angle clock number.  Highest
      voltage winding should be 1.  Each end within a power transformer should have
      a unique subsequent end number.   Note the transformer end number need not match
      the terminal sequence number.
    from_schema: http://iec.ch/TC57/ns/CIM/CoreEquipment-EU#Package_CoreEquipmentProfile
    rank: 1000
    slot_uri: cim:TransformerEnd.endNumber
    multivalued: false
    alias: end_number
    owner: PowerTransformerEnd
    domain_of:
    - TransformerEnd
    range: integer
    required: true
  description:
    name: description
    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.
    from_schema: http://iec.ch/TC57/ns/CIM/CoreEquipment-EU#Package_CoreEquipmentProfile
    rank: 1000
    slot_uri: cim:IdentifiedObject.description
    multivalued: false
    alias: description
    owner: PowerTransformerEnd
    domain_of:
    - IdentifiedObject
    - NameType
    - NameTypeAuthority
    range: string
    required: false
  energy_ident_code_eic:
    name: energy_ident_code_eic
    description: 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.
    from_schema: http://iec.ch/TC57/ns/CIM/CoreEquipment-EU#Package_CoreEquipmentProfile
    rank: 1000
    slot_uri: eu:IdentifiedObject.energyIdentCodeEic
    multivalued: false
    alias: energy_ident_code_eic
    owner: PowerTransformerEnd
    domain_of:
    - IdentifiedObject
    range: string
    required: false
  m_rid:
    name: m_rid
    description: '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.'
    from_schema: http://iec.ch/TC57/ns/CIM/CoreEquipment-EU#Package_CoreEquipmentProfile
    rank: 1000
    slot_uri: cim:IdentifiedObject.mRID
    multivalued: false
    alias: m_rid
    owner: PowerTransformerEnd
    domain_of:
    - IdentifiedObject
    range: string
    required: true
  short_name:
    name: short_name
    description: The attribute is used for an exchange of a human readable short name
      with length of the string 12 characters maximum.
    from_schema: http://iec.ch/TC57/ns/CIM/CoreEquipment-EU#Package_CoreEquipmentProfile
    rank: 1000
    slot_uri: eu:IdentifiedObject.shortName
    multivalued: false
    alias: short_name
    owner: PowerTransformerEnd
    domain_of:
    - IdentifiedObject
    range: string
    required: false
  names:
    name: names
    description: All names of this identified object.
    from_schema: http://iec.ch/TC57/ns/CIM/CoreEquipment-EU#Package_CoreEquipmentProfile
    rank: 1000
    slot_uri: cim:IdentifiedObject.Names
    multivalued: true
    alias: names
    owner: PowerTransformerEnd
    domain_of:
    - IdentifiedObject
    - NameType
    range: Name
    required: false
class_uri: cim:PowerTransformerEnd