SC
https://www.entsoe.eu/digital/cim/cim-for-grid-models-exchange/
vocabulary
urn:iso:std:iec:61970-600-2:ed-1
urn:iso:std:iec:61970-301:ed-7:amd1
file://iec61970cim17v40_iec61968cim13v13a_iec62325cim03v17a.eap
urn:iso:std:iec:61970-501:draft:ed-2
3.0.0
ENTSO-E CIM EG
This vocabulary is describing the short circuit profile from IEC 61970-600-2.
97938d45-bb5f-4424-b64d-219c1f76ab31
2021-01-27T12:17:39Z
en-GB
2020-10-12
ENTSO-E
Copyright
ENTSO-E
Short Circuit Vocabulary
ShortCircuitProfile
This is the IEC 61970-452 short circuit profile.
ACDCTerminal
An electrical connection point (AC or DC) to a piece of conducting equipment. Terminals are connected at physical connection points called connectivity nodes.
ACLineSegment
A wire or combination of wires, with consistent electrical characteristics, building a single electrical system, used to carry alternating current between points in the power system.
For symmetrical, transposed three phase lines, it is sufficient to use attributes of the line segment, which describe impedances and admittances for the entire length of the segment. Additionally impedances can be computed by using length and associated per length impedances.
The BaseVoltage at the two ends of ACLineSegments in a Line shall have the same BaseVoltage.nominalVoltage. However, boundary lines may have slightly different BaseVoltage.nominalVoltages and variation is allowed. Larger voltage difference in general requires use of an equivalent branch.
Description
b0ch
Zero sequence shunt (charging) susceptance, uniformly distributed, of the entire line section.
Susceptance
Imaginary part of admittance.
CIMDatatype
value
Float
A floating point number. The range is unspecified and not limited.
Primitive
unit
S
UnitSymbol
The derived units defined for usage in the CIM. In some cases, the derived unit is equal to an SI unit. Whenever possible, the standard derived symbol is used instead of the formula for the derived unit. For example, the unit symbol Farad is defined as "F" instead of "CPerV". In cases where a standard symbol does not exist for a derived unit, the formula for the unit is used as the unit symbol. For example, density does not have a standard symbol and so it is represented as "kgPerm3". With the exception of the "kg", which is an SI unit, the unit symbols do not contain multipliers and therefore represent the base derived unit to which a multiplier can be applied as a whole.
Every unit symbol is treated as an unparseable text as if it were a single-letter symbol. The meaning of each unit symbol is defined by the accompanying descriptive text and not by the text contents of the unit symbol.
To allow the widest possible range of serializations without requiring special character handling, several substitutions are made which deviate from the format described in IEC 80000-1. The division symbol "/" is replaced by the letters "Per". Exponents are written in plain text after the unit as "m3" instead of being formatted as "m" with a superscript of 3 or introducing a symbol as in "m^3". The degree symbol "°" is replaced with the letters "deg". Any clarification of the meaning for a substitution is included in the description for the unit symbol.
Non-SI units are included in list of unit symbols to allow sources of data to be correctly labelled with their non-SI units (for example, a GPS sensor that is reporting numbers that represent feet instead of meters). This allows software to use the unit symbol information correctly convert and scale the raw data of those sources into SI-based units.
The integer values are used for harmonization with IEC 61850.
none
Dimension less quantity, e.g. count, per unit, etc.
enum
m
Length in metres.
enum
kg
Mass in kilograms. Note: multiplier “k” is included in this unit symbol for compatibility with IEC 61850-7-3.
enum
s
Time in seconds.
enum
A
Current in amperes.
enum
K
Temperature in kelvins.
enum
mol
Amount of substance in moles.
enum
cd
Luminous intensity in candelas.
enum
deg
Plane angle in degrees.
enum
rad
Plane angle in radians (m/m).
enum
sr
Solid angle in steradians (m2/m2).
enum
Gy
Absorbed dose in grays (J/kg).
enum
Bq
Radioactivity in becquerels (1/s).
enum
degC
Relative temperature in degrees Celsius.
In the SI unit system the symbol is °C. Electric charge is measured in coulomb that has the unit symbol C. To distinguish degree Celsius from coulomb the symbol used in the UML is degC. The reason for not using °C is that the special character ° is difficult to manage in software.
enum
Sv
Dose equivalent in sieverts (J/kg).
enum
F
Electric capacitance in farads (C/V).
enum
C
Electric charge in coulombs (A·s).
enum
S
Conductance in siemens.
enum
H
Electric inductance in henrys (Wb/A).
enum
V
Electric potential in volts (W/A).
enum
ohm
Electric resistance in ohms (V/A).
enum
J
Energy in joules (N·m = C·V = W·s).
enum
N
Force in newtons (kg·m/s²).
enum
Hz
Frequency in hertz (1/s).
enum
lx
Illuminance in lux (lm/m²).
enum
lm
Luminous flux in lumens (cd·sr).
enum
Wb
Magnetic flux in webers (V·s).
enum
T
Magnetic flux density in teslas (Wb/m2).
enum
W
Real power in watts (J/s). Electrical power may have real and reactive components. The real portion of electrical power (I²R or VIcos(phi)), is expressed in Watts. See also apparent power and reactive power.
enum
Pa
Pressure in pascals (N/m²). Note: the absolute or relative measurement of pressure is implied with this entry. See below for more explicit forms.
enum
m2
Area in square metres (m²).
enum
m3
Volume in cubic metres (m³).
enum
mPers
Velocity in metres per second (m/s).
enum
mPers2
Acceleration in metres per second squared (m/s²).
enum
m3Pers
Volumetric flow rate in cubic metres per second (m³/s).
enum
mPerm3
Fuel efficiency in metres per cubic metres (m/m³).
enum
kgm
Moment of mass in kilogram metres (kg·m) (first moment of mass). Note: multiplier “k” is included in this unit symbol for compatibility with IEC 61850-7-3.
enum
kgPerm3
Density in kilogram/cubic metres (kg/m³). Note: multiplier “k” is included in this unit symbol for compatibility with IEC 61850-7-3.
enum
m2Pers
Viscosity in square metres / second (m²/s).
enum
WPermK
Thermal conductivity in watt/metres kelvin.
enum
JPerK
Heat capacity in joules/kelvin.
enum
ppm
Concentration in parts per million.
enum
rotPers
Rotations per second (1/s). See also Hz (1/s).
enum
radPers
Angular velocity in radians per second (rad/s).
enum
WPerm2
Heat flux density, irradiance, watts per square metre.
enum
JPerm2
Insulation energy density, joules per square metre or watt second per square metre.
enum
SPerm
Conductance per length (F/m).
enum
KPers
Temperature change rate in kelvins per second.
enum
PaPers
Pressure change rate in pascals per second.
enum
JPerkgK
Specific heat capacity, specific entropy, joules per kilogram Kelvin.
enum
VA
Apparent power in volt amperes. See also real power and reactive power.
enum
VAr
Reactive power in volt amperes reactive. The “reactive” or “imaginary” component of electrical power (VIsin(phi)). (See also real power and apparent power).
Note: Different meter designs use different methods to arrive at their results. Some meters may compute reactive power as an arithmetic value, while others compute the value vectorially. The data consumer should determine the method in use and the suitability of the measurement for the intended purpose.
enum
cosPhi
Power factor, dimensionless.
Note 1: This definition of power factor only holds for balanced systems. See the alternative definition under code 153.
Note 2 : Beware of differing sign conventions in use between the IEC and EEI. It is assumed that the data consumer understands the type of meter in use and the sign convention in use by the utility.
enum
Vs
Volt seconds (Ws/A).
enum
V2
Volt squared (W²/A²).
enum
As
Ampere seconds (A·s).
enum
A2
Amperes squared (A²).
enum
A2s
Ampere squared time in square amperes (A²s).
enum
VAh
Apparent energy in volt ampere hours.
enum
Wh
Real energy in watt hours.
enum
VArh
Reactive energy in volt ampere reactive hours.
enum
VPerHz
Magnetic flux in volt per hertz.
enum
HzPers
Rate of change of frequency in hertz per second.
enum
character
Number of characters.
enum
charPers
Data rate (baud) in characters per second.
enum
kgm2
Moment of mass in kilogram square metres (kg·m²) (Second moment of mass, commonly called the moment of inertia). Note: multiplier “k” is included in this unit symbol for compatibility with IEC 61850-7-3.
enum
dB
Sound pressure level in decibels. Note: multiplier “d” is included in this unit symbol for compatibility with IEC 61850-7-3.
enum
WPers
Ramp rate in watts per second.
enum
lPers
Volumetric flow rate in litres per second.
enum
dBm
Power level (logarithmic ratio of signal strength , Bel-mW), normalized to 1mW. Note: multiplier “d” is included in this unit symbol for compatibility with IEC 61850-7-3.
enum
h
Time in hours, hour = 60 min = 3600 s.
enum
min
Time in minutes, minute = 60 s.
enum
Q
Quantity power, Q.
enum
Qh
Quantity energy, Qh.
enum
ohmm
Resistivity, ohm metres, (rho).
enum
APerm
A/m, magnetic field strength, amperes per metre.
enum
V2h
Volt-squared hour, volt-squared-hours.
enum
A2h
Ampere-squared hour, ampere-squared hour.
enum
Ah
Ampere-hours, ampere-hours.
enum
count
Amount of substance, Counter value.
enum
ft3
Volume, cubic feet.
enum
m3Perh
Volumetric flow rate, cubic metres per hour.
enum
gal
Volume in gallons, US gallon (1 gal = 231 in3 = 128 fl ounce).
enum
Btu
Energy, British Thermal Units.
enum
l
Volume in litres, litre = dm3 = m3/1000.
enum
lPerh
Volumetric flow rate, litres per hour.
enum
lPerl
Concentration, The ratio of the volume of a solute divided by the volume of the solution. Note: Users may need use a prefix such a ‘µ’ to express a quantity such as ‘µL/L’.
enum
gPerg
Concentration, The ratio of the mass of a solute divided by the mass of the solution. Note: Users may need use a prefix such a ‘µ’ to express a quantity such as ‘µg/g’.
enum
molPerm3
Concentration, The amount of substance concentration, (c), the amount of solvent in moles divided by the volume of solution in m³.
enum
molPermol
Concentration, Molar fraction, the ratio of the molar amount of a solute divided by the molar amount of the solution.
enum
molPerkg
Concentration, Molality, the amount of solute in moles and the amount of solvent in kilograms.
enum
sPers
Time, Ratio of time. Note: Users may need to supply a prefix such as ‘µ’ to show rates such as ‘µs/s’.
enum
HzPerHz
Frequency, rate of frequency change. Note: Users may need to supply a prefix such as ‘m’ to show rates such as ‘mHz/Hz’.
enum
VPerV
Voltage, ratio of voltages. Note: Users may need to supply a prefix such as ‘m’ to show rates such as ‘mV/V’.
enum
APerA
Current, ratio of amperages. Note: Users may need to supply a prefix such as ‘m’ to show rates such as ‘mA/A’.
enum
VPerVA
Power factor, PF, the ratio of the active power to the apparent power. Note: The sign convention used for power factor will differ between IEC meters and EEI (ANSI) meters. It is assumed that the data consumers understand the type of meter being used and agree on the sign convention in use at any given utility.
enum
rev
Amount of rotation, revolutions.
enum
kat
Catalytic activity, katal = mol / s.
enum
JPerkg
Specific energy, Joules / kg.
enum
m3Uncompensated
Volume, cubic metres, with the value uncompensated for weather effects.
enum
m3Compensated
Volume, cubic metres, with the value compensated for weather effects.
enum
WPerW
Signal Strength, ratio of power. Note: Users may need to supply a prefix such as ‘m’ to show rates such as ‘mW/W’.
enum
therm
Energy, therms.
enum
onePerm
Wavenumber, reciprocal metres, (1/m).
enum
m3Perkg
Specific volume, cubic metres per kilogram, v.
enum
Pas
Dynamic viscosity, pascal seconds.
enum
Nm
Moment of force, newton metres.
enum
NPerm
Surface tension, newton per metre.
enum
radPers2
Angular acceleration, radians per second squared.
enum
JPerm3
Energy density, joules per cubic metre.
enum
VPerm
Electric field strength, volts per metre.
enum
CPerm3
Electric charge density, coulombs per cubic metre.
enum
CPerm2
Surface charge density, coulombs per square metre.
enum
FPerm
Permittivity, farads per metre.
enum
HPerm
Permeability, henrys per metre.
enum
JPermol
Molar energy, joules per mole.
enum
JPermolK
Molar entropy, molar heat capacity, joules per mole kelvin.
enum
CPerkg
Exposure (x rays), coulombs per kilogram.
enum
GyPers
Absorbed dose rate, grays per second.
enum
WPersr
Radiant intensity, watts per steradian.
enum
WPerm2sr
Radiance, watts per square metre steradian.
enum
katPerm3
Catalytic activity concentration, katals per cubic metre.
enum
d
Time in days, day = 24 h = 86400 s.
enum
anglemin
Plane angle, minutes.
enum
anglesec
Plane angle, seconds.
enum
ha
Area, hectares.
enum
tonne
Mass in tons, “tonne” or “metric ton” (1000 kg = 1 Mg).
enum
bar
Pressure in bars, (1 bar = 100 kPa).
enum
mmHg
Pressure, millimetres of mercury (1 mmHg is approximately 133.3 Pa).
enum
M
Length, nautical miles (1 M = 1852 m).
enum
kn
Speed, knots (1 kn = 1852/3600) m/s.
enum
Mx
Magnetic flux, maxwells (1 Mx = 10-8 Wb).
enum
G
Magnetic flux density, gausses (1 G = 10-4 T).
enum
Oe
Magnetic field in oersteds, (1 Oe = (103/4p) A/m).
enum
Vh
Volt-hour, Volt hours.
enum
WPerA
Active power per current flow, watts per Ampere.
enum
onePerHz
Reciprocal of frequency (1/Hz).
enum
VPerVAr
Power factor, PF, the ratio of the active power to the apparent power. Note: The sign convention used for power factor will differ between IEC meters and EEI (ANSI) meters. It is assumed that the data consumers understand the type of meter being used and agree on the sign convention in use at any given utility.
enum
ohmPerm
Electric resistance per length in ohms per metre ((V/A)/m).
enum
kgPerJ
Weight per energy in kilograms per joule (kg/J). Note: multiplier “k” is included in this unit symbol for compatibility with IEC 61850-7-3.
enum
JPers
Energy rate in joules per second (J/s).
enum
multiplier
none
UnitMultiplier
The unit multipliers defined for the CIM. When applied to unit symbols, the unit symbol is treated as a derived unit. Regardless of the contents of the unit symbol text, the unit symbol shall be treated as if it were a single-character unit symbol. Unit symbols should not contain multipliers, and it should be left to the multiplier to define the multiple for an entire data type.
For example, if a unit symbol is "m2Pers" and the multiplier is "k", then the value is k(m**2/s), and the multiplier applies to the entire final value, not to any individual part of the value. This can be conceptualized by substituting a derived unit symbol for the unit type. If one imagines that the symbol "Þ" represents the derived unit "m2Pers", then applying the multiplier "k" can be conceptualized simply as "kÞ".
For example, the SI unit for mass is "kg" and not "g". If the unit symbol is defined as "kg", then the multiplier is applied to "kg" as a whole and does not replace the "k" in front of the "g". In this case, the multiplier of "m" would be used with the unit symbol of "kg" to represent one gram. As a text string, this violates the instructions in IEC 80000-1. However, because the unit symbol in CIM is treated as a derived unit instead of as an SI unit, it makes more sense to conceptualize the "kg" as if it were replaced by one of the proposed replacements for the SI mass symbol. If one imagines that the "kg" were replaced by a symbol "Þ", then it is easier to conceptualize the multiplier "m" as creating the proper unit "mÞ", and not the forbidden unit "mkg".
y
Yocto 10**-24.
enum
z
Zepto 10**-21.
enum
a
Atto 10**-18.
enum
f
Femto 10**-15.
enum
p
Pico 10**-12.
enum
n
Nano 10**-9.
enum
micro
Micro 10**-6.
enum
m
Milli 10**-3.
enum
c
Centi 10**-2.
enum
d
Deci 10**-1.
enum
none
No multiplier or equivalently multiply by 1.
enum
da
Deca 10**1.
enum
h
Hecto 10**2.
enum
k
Kilo 10**3.
enum
M
Mega 10**6.
enum
G
Giga 10**9.
enum
T
Tera 10**12.
enum
P
Peta 10**15.
enum
E
Exa 10**18.
enum
Z
Zetta 10**21.
enum
Y
Yotta 10**24.
enum
g0ch
Zero sequence shunt (charging) conductance, uniformly distributed, of the entire line section.
Conductance
Factor by which voltage must be multiplied to give corresponding power lost from a circuit. Real part of admittance.
CIMDatatype
value
unit
S
multiplier
none
r0
Zero sequence series resistance of the entire line section.
Resistance
Resistance (real part of impedance).
CIMDatatype
value
unit
ohm
multiplier
none
shortCircuitEndTemperature
Maximum permitted temperature at the end of SC for the calculation of minimum short-circuit currents. Used for short circuit data exchange according to IEC 60909.
Temperature
Value of temperature in degrees Celsius.
CIMDatatype
multiplier
none
unit
degC
value
x0
Zero sequence series reactance of the entire line section.
Reactance
Reactance (imaginary part of impedance), at rated frequency.
CIMDatatype
value
unit
ohm
multiplier
none
AsynchronousMachine
A rotating machine whose shaft rotates asynchronously with the electrical field. Also known as an induction machine with no external connection to the rotor windings, e.g. squirrel-cage induction machine.
Description
converterFedDrive
Indicates whether the machine is a converter fed drive. Used for short circuit data exchange according to IEC 60909.
Boolean
A type with the value space "true" and "false".
Primitive
efficiency
Efficiency of the asynchronous machine at nominal operation as a percentage. Indicator for converter drive motors. Used for short circuit data exchange according to IEC 60909.
PerCent
Percentage on a defined base. For example, specify as 100 to indicate at the defined base.
CIMDatatype
value
Normally 0 to 100 on a defined base.
unit
none
multiplier
none
iaIrRatio
Ratio of locked-rotor current to the rated current of the motor (Ia/Ir). Used for short circuit data exchange according to IEC 60909.
polePairNumber
Number of pole pairs of stator. Used for short circuit data exchange according to IEC 60909.
Integer
An integer number. The range is unspecified and not limited.
Primitive
ratedMechanicalPower
Rated mechanical power (Pr in IEC 60909-0). Used for short circuit data exchange according to IEC 60909.
ActivePower
Product of RMS value of the voltage and the RMS value of the in-phase component of the current.
CIMDatatype
value
multiplier
M
unit
W
reversible
Indicates for converter drive motors if the power can be reversible. Used for short circuit data exchange according to IEC 60909.
rxLockedRotorRatio
Locked rotor ratio (R/X). Used for short circuit data exchange according to IEC 60909.
BusbarSection
A conductor, or group of conductors, with negligible impedance, that serve to connect other conducting equipment within a single substation.
Voltage measurements are typically obtained from voltage transformers that are connected to busbar sections. A bus bar section may have many physical terminals but for analysis is modelled with exactly one logical terminal.
Description
ipMax
Maximum allowable peak short-circuit current of busbar (Ipmax in IEC 60909-0).
Mechanical limit of the busbar in the substation itself. Used for short circuit data exchange according to IEC 60909.
CurrentFlow
Electrical current with sign convention: positive flow is out of the conducting equipment into the connectivity node. Can be both AC and DC.
CIMDatatype
value
multiplier
none
unit
A
ConductingEquipment
The parts of the AC power system that are designed to carry current or that are conductively connected through terminals.
Conductor
Combination of conducting material with consistent electrical characteristics, building a single electrical system, used to carry current between points in the power system.
Connector
A conductor, or group of conductors, with negligible impedance, that serve to connect other conducting equipment within a single substation and are modelled with a single logical terminal.
EarthFaultCompensator
A conducting equipment used to represent a connection to ground which is typically used to compensate earth faults. An earth fault compensator device modelled with a single terminal implies a second terminal solidly connected to ground. If two terminals are modelled, the ground is not assumed and normal connection rules apply.
r
Nominal resistance of device.
EnergyConnection
A connection of energy generation or consumption on the power system model.
EnergySource
A generic equivalent for an energy supplier on a transmission or distribution voltage level.
Description
r
Positive sequence Thevenin resistance.
r0
Zero sequence Thevenin resistance.
rn
Negative sequence Thevenin resistance.
x
Positive sequence Thevenin reactance.
x0
Zero sequence Thevenin reactance.
xn
Negative sequence Thevenin reactance.
Equipment
The parts of a power system that are physical devices, electronic or mechanical.
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.
Description
negativeR12
Negative sequence series resistance from terminal sequence 1 to terminal sequence 2. Used for short circuit data exchange according to IEC 60909.
EquivalentBranch is a result of network reduction prior to the data exchange.
negativeR21
Negative sequence series resistance from terminal sequence 2 to terminal sequence 1. Used for short circuit data exchange according to IEC 60909.
EquivalentBranch is a result of network reduction prior to the data exchange.
negativeX12
Negative sequence series reactance from terminal sequence 1 to terminal sequence 2. Used for short circuit data exchange according to IEC 60909.
Usage : EquivalentBranch is a result of network reduction prior to the data exchange.
negativeX21
Negative sequence series reactance from terminal sequence 2 to terminal sequence 1. Used for short circuit data exchange according to IEC 60909.
Usage: EquivalentBranch is a result of network reduction prior to the data exchange.
positiveR12
Positive sequence series resistance from terminal sequence 1 to terminal sequence 2 . Used for short circuit data exchange according to IEC 60909.
EquivalentBranch is a result of network reduction prior to the data exchange.
positiveR21
Positive sequence series resistance from terminal sequence 2 to terminal sequence 1. Used for short circuit data exchange according to IEC 60909.
EquivalentBranch is a result of network reduction prior to the data exchange.
positiveX12
Positive sequence series reactance from terminal sequence 1 to terminal sequence 2. Used for short circuit data exchange according to IEC 60909.
Usage : EquivalentBranch is a result of network reduction prior to the data exchange.
positiveX21
Positive sequence series reactance from terminal sequence 2 to terminal sequence 1. Used for short circuit data exchange according to IEC 60909.
Usage : EquivalentBranch is a result of network reduction prior to the data exchange.
zeroR12
Zero sequence series resistance from terminal sequence 1 to terminal sequence 2. Used for short circuit data exchange according to IEC 60909.
EquivalentBranch is a result of network reduction prior to the data exchange.
zeroR21
Zero sequence series resistance from terminal sequence 2 to terminal sequence 1. Used for short circuit data exchange according to IEC 60909.
Usage : EquivalentBranch is a result of network reduction prior to the data exchange.
zeroX12
Zero sequence series reactance from terminal sequence 1 to terminal sequence 2. Used for short circuit data exchange according to IEC 60909.
Usage : EquivalentBranch is a result of network reduction prior to the data exchange.
zeroX21
Zero sequence series reactance from terminal sequence 2 to terminal sequence 1. Used for short circuit data exchange according to IEC 60909.
Usage : EquivalentBranch is a result of network reduction prior to the data exchange.
EquivalentEquipment
The class represents equivalent objects that are the result of a network reduction. The class is the base for equivalent objects of different types.
EquivalentInjection
This class represents equivalent injections (generation or load). Voltage regulation is allowed only at the point of connection.
Description
r
Positive sequence resistance. Used to represent Extended-Ward (IEC 60909).
Usage : Extended-Ward is a result of network reduction prior to the data exchange.
r0
Zero sequence resistance. Used to represent Extended-Ward (IEC 60909).
Usage : Extended-Ward is a result of network reduction prior to the data exchange.
r2
Negative sequence resistance. Used to represent Extended-Ward (IEC 60909).
Usage : Extended-Ward is a result of network reduction prior to the data exchange.
x
Positive sequence reactance. Used to represent Extended-Ward (IEC 60909).
Usage : Extended-Ward is a result of network reduction prior to the data exchange.
x0
Zero sequence reactance. Used to represent Extended-Ward (IEC 60909).
Usage : Extended-Ward is a result of network reduction prior to the data exchange.
x2
Negative sequence reactance. Used to represent Extended-Ward (IEC 60909).
Usage : Extended-Ward is a result of network reduction prior to the data exchange.
ExternalNetworkInjection
This class represents the external network and it is used for IEC 60909 calculations.
Description
ikSecond
Indicates whether initial symmetrical short-circuit current and power have been calculated according to IEC (Ik"). Used only if short circuit calculations are done according to superposition method.
maxInitialSymShCCurrent
Maximum initial symmetrical short-circuit currents (Ik" max) in A (Ik" = Sk"/(SQRT(3) Un)). Used for short circuit data exchange according to IEC 60909.
maxR0ToX0Ratio
Maximum ratio of zero sequence resistance of Network Feeder to its zero sequence reactance (R(0)/X(0) max). Used for short circuit data exchange according to IEC 60909.
maxR1ToX1Ratio
Maximum ratio of positive sequence resistance of Network Feeder to its positive sequence reactance (R(1)/X(1) max). Used for short circuit data exchange according to IEC 60909.
maxZ0ToZ1Ratio
Maximum ratio of zero sequence impedance to its positive sequence impedance (Z(0)/Z(1) max). Used for short circuit data exchange according to IEC 60909.
minInitialSymShCCurrent
Minimum initial symmetrical short-circuit currents (Ik" min) in A (Ik" = Sk"/(SQRT(3) Un)). Used for short circuit data exchange according to IEC 60909.
minR0ToX0Ratio
Indicates whether initial symmetrical short-circuit current and power have been calculated according to IEC (Ik"). Used for short circuit data exchange according to IEC 6090.
minR1ToX1Ratio
Minimum ratio of positive sequence resistance of Network Feeder to its positive sequence reactance (R(1)/X(1) min). Used for short circuit data exchange according to IEC 60909.
minZ0ToZ1Ratio
Minimum ratio of zero sequence impedance to its positive sequence impedance (Z(0)/Z(1) min). Used for short circuit data exchange according to IEC 60909.
voltageFactor
Voltage factor in pu, which was used to calculate short-circuit current Ik" and power Sk". Used only if short circuit calculations are done according to superposition method.
PU
Per Unit - a positive or negative value referred to a defined base. Values typically range from -10 to +10.
CIMDatatype
value
unit
none
multiplier
none
GroundingImpedance
A fixed impedance device used for grounding.
Description
x
Reactance of device.
IdentifiedObject
This is a root class to provide common identification for all classes needing identification and naming attributes.
mRID
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.
String
A string consisting of a sequence of characters. The character encoding is UTF-8. The string length is unspecified and unlimited.
Primitive
LinearShuntCompensator
A linear shunt compensator has banks or sections with equal admittance values.
Description
b0PerSection
Zero sequence shunt (charging) susceptance per section.
g0PerSection
Zero sequence shunt (charging) conductance per section.
MutualCoupling
This class represents the zero sequence line mutual coupling.
b0ch
Zero sequence mutual coupling shunt (charging) susceptance, uniformly distributed, of the entire line section.
distance11
Distance to the start of the coupled region from the first line's terminal having sequence number equal to 1.
Length
Unit of length. It shall be a positive value or zero.
CIMDatatype
value
unit
m
multiplier
k
distance12
Distance to the end of the coupled region from the first line's terminal with sequence number equal to 1.
distance21
Distance to the start of coupled region from the second line's terminal with sequence number equal to 1.
distance22
Distance to the end of coupled region from the second line's terminal with sequence number equal to 1.
g0ch
Zero sequence mutual coupling shunt (charging) conductance, uniformly distributed, of the entire line section.
r0
Zero sequence branch-to-branch mutual impedance coupling, resistance.
x0
Zero sequence branch-to-branch mutual impedance coupling, reactance.
Second_Terminal
The starting terminal for the calculation of distances along the second branch of the mutual coupling.
Yes
HasSecondMutualCoupling
Mutual couplings with the branch associated as the first branch.
No
First_Terminal
The starting terminal for the calculation of distances along the first branch of the mutual coupling. Normally MutualCoupling would only be used for terminals of AC line segments. The first and second terminals of a mutual coupling should point to different AC line segments.
Yes
HasFirstMutualCoupling
Mutual couplings associated with the branch as the first branch.
No
NonlinearShuntCompensatorPoint
A non linear shunt compensator bank or section admittance value. The number of NonlinearShuntCompenstorPoint instances associated with a NonlinearShuntCompensator shall be equal to ShuntCompensator.maximumSections. ShuntCompensator.sections shall only be set to one of the NonlinearShuntCompenstorPoint.sectionNumber. There is no interpolation between NonlinearShuntCompenstorPoint-s.
Description
b0
Zero sequence shunt (charging) susceptance per section.
g0
Zero sequence shunt (charging) conductance per section.
PetersenCoil
A variable impedance device normally used to offset line charging during single line faults in an ungrounded section of network.
Description
mode
The mode of operation of the Petersen coil.
PetersenCoilModeKind
The mode of operation for a Petersen coil.
fixed
Fixed position.
enum
manual
Manual positioning.
enum
automaticPositioning
Automatic positioning.
enum
nominalU
The nominal voltage for which the coil is designed.
Voltage
Electrical voltage, can be both AC and DC.
CIMDatatype
value
multiplier
k
unit
V
offsetCurrent
The offset current that the Petersen coil controller is operating from the resonant point. This is normally a fixed amount for which the controller is configured and could be positive or negative. Typically 0 to 60 A depending on voltage and resonance conditions.
positionCurrent
The control current used to control the Petersen coil also known as the position current. Typically in the range of 20 mA to 200 mA.
xGroundMax
The maximum reactance.
xGroundMin
The minimum reactance.
xGroundNominal
The nominal reactance. This is the operating point (normally over compensation) that is defined based on the resonance point in the healthy network condition. The impedance is calculated based on nominal voltage divided by position current.
PowerSystemResource
A power system resource (PSR) can be an item of equipment such as a switch, an equipment container containing many individual items of equipment such as a substation, or an organisational entity such as sub-control area. Power system resources can have measurements associated.
PowerTransformer
An electrical device consisting of two or more coupled windings, with or without a magnetic core, for introducing mutual coupling between electric circuits. Transformers can be used to control voltage and phase shift (active power flow).
A power transformer may be composed of separate transformer tanks that need not be identical.
A power transformer can be modelled with or without tanks and is intended for use in both balanced and unbalanced representations. A power transformer typically has two terminals, but may have one (grounding), three or more terminals.
The inherited association ConductingEquipment.BaseVoltage should not be used. The association from TransformerEnd to BaseVoltage should be used instead.
Description
beforeShCircuitHighestOperatingCurrent
The highest operating current (Ib in IEC 60909-0) before short circuit (depends on network configuration and relevant reliability philosophy). It is used for calculation of the impedance correction factor KT defined in IEC 60909-0.
beforeShCircuitHighestOperatingVoltage
The highest operating voltage (Ub in IEC 60909-0) before short circuit. It is used for calculation of the impedance correction factor KT defined in IEC 60909-0. This is worst case voltage on the low side winding (3.7.1 of IEC 60909:2001). Used to define operating conditions.
beforeShortCircuitAnglePf
The angle of power factor before short circuit (phib in IEC 60909-0). It is used for calculation of the impedance correction factor KT defined in IEC 60909-0. This is the worst case power factor. Used to define operating conditions.
AngleDegrees
Measurement of angle in degrees.
CIMDatatype
value
unit
deg
multiplier
none
highSideMinOperatingU
The minimum operating voltage (uQmin in IEC 60909-0) at the high voltage side (Q side) of the unit transformer of the power station unit. A value well established from long-term operating experience of the system. It is used for calculation of the impedance correction factor KG defined in IEC 60909-0.
isPartOfGeneratorUnit
Indicates whether the machine is part of a power station unit. Used for short circuit data exchange according to IEC 60909. It has an impact on how the correction factors are calculated for transformers, since the transformer is not necessarily part of a synchronous machine and generating unit. It is not always possible to derive this information from the model. This is why the attribute is necessary.
operationalValuesConsidered
It is used to define if the data (other attributes related to short circuit data exchange) defines long term operational conditions or not. Used for short circuit data exchange according to IEC 60909.
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).
Description
b0
Zero sequence magnetizing branch susceptance.
phaseAngleClock
Terminal voltage phase angle displacement where 360 degrees are represented with clock hours. The valid values are 0 to 11. For example, for the secondary side end of a transformer with vector group code of 'Dyn11', specify the connection kind as wye with neutral and specify the phase angle of the clock as 11. The clock value of the transformer end number specified as 1, is assumed to be zero. Note the transformer end number is not assumed to be the same as the terminal sequence number.
g0
Zero sequence magnetizing branch conductance (star-model).
r0
Zero sequence series resistance (star-model) of the transformer end.
x0
Zero sequence series reactance of the transformer end.
RegulatingCondEq
A type of conducting equipment that can regulate a quantity (i.e. voltage or flow) at a specific point in the network.
RotatingMachine
A rotating machine which may be used as a generator or motor.
SeriesCompensator
A Series Compensator is a series capacitor or reactor or an AC transmission line without charging susceptance. It is a two terminal device.
Description
r0
Zero sequence resistance.
x0
Zero sequence reactance.
varistorPresent
Describe if a metal oxide varistor (mov) for over voltage protection is configured in parallel with the series compensator. It is used for short circuit calculations.
varistorRatedCurrent
The maximum current the varistor is designed to handle at specified duration. It is used for short circuit calculations and exchanged only if SeriesCompensator.varistorPresent is true.
The attribute shall be a positive value.
varistorVoltageThreshold
The dc voltage at which the varistor starts conducting. It is used for short circuit calculations and exchanged only if SeriesCompensator.varistorPresent is true.
ShuntCompensator
A shunt capacitor or reactor or switchable bank of shunt capacitors or reactors. A section of a shunt compensator is an individual capacitor or reactor. A negative value for bPerSection indicates that the compensator is a reactor. ShuntCompensator is a single terminal device. Ground is implied.
SynchronousMachine
An electromechanical device that operates with shaft rotating synchronously with the network. It is a single machine operating either as a generator or synchronous condenser or pump.
Description
earthing
Indicates whether or not the generator is earthed. Used for short circuit data exchange according to IEC 60909.
earthingStarPointR
Generator star point earthing resistance (Re). Used for short circuit data exchange according to IEC 60909.
earthingStarPointX
Generator star point earthing reactance (Xe). Used for short circuit data exchange according to IEC 60909.
ikk
Steady-state short-circuit current (in A for the profile) of generator with compound excitation during 3-phase short circuit.
- Ikk=0: Generator with no compound excitation.
- Ikk<>0: Generator with compound excitation.
Ikk is used to calculate the minimum steady-state short-circuit current for generators with compound excitation.
(4.6.1.2 in IEC 60909-0:2001).
Used only for single fed short circuit on a generator. (4.3.4.2. in IEC 60909-0:2001).
mu
Factor to calculate the breaking current (Section 4.5.2.1 in IEC 60909-0).
Used only for single fed short circuit on a generator (Section 4.3.4.2. in IEC 60909-0).
x0
Zero sequence reactance of the synchronous machine.
r0
Zero sequence resistance of the synchronous machine.
x2
Negative sequence reactance.
r2
Negative sequence resistance.
r
Equivalent resistance (RG) of generator. RG is considered for the calculation of all currents, except for the calculation of the peak current ip. Used for short circuit data exchange according to IEC 60909.
satDirectSubtransX
Direct-axis subtransient reactance saturated, also known as Xd"sat.
satDirectSyncX
Direct-axes saturated synchronous reactance (xdsat); reciprocal of short-circuit ration. Used for short circuit data exchange, only for single fed short circuit on a generator. (4.3.4.2. in IEC 60909-0:2001).
satDirectTransX
Saturated Direct-axis transient reactance. The attribute is primarily used for short circuit calculations according to ANSI.
shortCircuitRotorType
Type of rotor, used by short circuit applications, only for single fed short circuit according to IEC 60909.
ShortCircuitRotorKind
Type of rotor, used by short circuit applications.
salientPole1
Salient pole 1 in IEC 60909.
enum
salientPole2
Salient pole 2 in IEC 60909.
enum
turboSeries1
Turbo Series 1 in IEC 60909.
enum
turboSeries2
Turbo series 2 in IEC 60909.
enum
voltageRegulationRange
Range of generator voltage regulation (PG in IEC 60909-0) used for calculation of the impedance correction factor KG defined in IEC 60909-0.
This attribute is used to describe the operating voltage of the generating unit.
Terminal
An AC electrical connection point to a piece of conducting equipment. Terminals are connected at physical connection points called connectivity nodes.
TransformerEnd
A conducting connection point of a power transformer. It corresponds to a physical transformer winding terminal. In earlier CIM versions, the TransformerWinding class served a similar purpose, but this class is more flexible because it associates to terminal but is not a specialization of ConductingEquipment.
rground
(for Yn and Zn connections) Resistance part of neutral impedance where 'grounded' is true.
grounded
(for Yn and Zn connections) True if the neutral is solidly grounded.
xground
(for Yn and Zn connections) Reactive part of neutral impedance where 'grounded' is true.
Date
Date as "yyyy-mm-dd", which conforms with ISO 8601. UTC time zone is specified as "yyyy-mm-ddZ". A local timezone relative UTC is specified as "yyyy-mm-dd(+/-)hh:mm".
Primitive