Steady State Hypothesis Vocabulary
keyword: SSH
incompatible with: profile1
landing page: https://www.entsoe.eu/digital/cim/cim-for-grid-models-exchange/
prior version: http://entsoe.eu/CIM/SteadyStateHypothesis/1/1
theme: vocabulary
version IRI: http://iec.ch/TC57/ns/CIM/SteadyStateHypothesis-EU/3.0
conforms to: urn:iso:std:iec:61970-600-2:ed-1
conforms to: urn:iso:std:iec:61970-301:ed-7:amd1
conforms to: urn:iso:std:iec:61970-501:draft:ed-2
version info: 3.0.0
creator: ENTSO-E CIM EG
description: This vocabulary is describing the steady state hypothesis profile from IEC 61970-600-2.
issued: 2021-01-27T12:19:09Z
language: en-GB
modified: 2020-10-12
publisher: ENTSO-E
rights: Copyright
rights holder: ENTSO-E
type: Ontology

SteadyStateHypothesisProfile
type: ClassCategory
comment: A steady state hypothesis dataset which conforms to the IEC 61970-456 steady state hypothesis profile contains all objects required to exchange input parameters to be able to perform load flow simulations. Due to the nature of the SSH profile, all objects in a Steady State Hypothesis instance file should have persistent mRIDs.

ACDCConverter
subclass of: ConductingEquipment
comment: A unit with valves for three phases, together with unit control equipment, essential protective and switching devices, DC storage capacitors, phase reactors and auxiliaries, if any, used for conversion.
belongs to category: SteadyStateHypothesisProfile
type: Class

p
stereotype: attribute
domain: ACDCConverter
data type: ActivePower
multiplicity: M:1..1
comment: Active power at the point of common coupling. Load sign convention is used, i.e. positive sign means flow out from a node. Starting value for a steady state solution in the case a simplified power flow model is used.
type: Property

ActivePower
comment: Product of RMS value of the voltage and the RMS value of the in-phase component of the current.
stereotype: CIMDatatype
belongs to category: SteadyStateHypothesisProfile
type: Class

value
stereotype: attribute
domain: ActivePower
data type: Float
multiplicity: M:0..1
type: Property

Float
comment: A floating point number. The range is unspecified and not limited.
stereotype: Primitive
belongs to category: SteadyStateHypothesisProfile
type: Class

multiplier
stereotype: attribute
domain: ActivePower
range: UnitMultiplier
multiplicity: M:0..1
is fixed: M
type: Property

UnitMultiplier
comment: 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".
belongs to category: SteadyStateHypothesisProfile
stereotype: enumeration
type: Class

y
comment: Yocto 10**-24.
stereotype: enum
type: UnitMultiplier

z
comment: Zepto 10**-21.
stereotype: enum
type: UnitMultiplier

a
comment: Atto 10**-18.
stereotype: enum
type: UnitMultiplier

f
comment: Femto 10**-15.
stereotype: enum
type: UnitMultiplier

p
comment: Pico 10**-12.
stereotype: enum
type: UnitMultiplier

n
comment: Nano 10**-9.
stereotype: enum
type: UnitMultiplier

micro
comment: Micro 10**-6.
stereotype: enum
type: UnitMultiplier

m
comment: Milli 10**-3.
stereotype: enum
type: UnitMultiplier

c
comment: Centi 10**-2.
stereotype: enum
type: UnitMultiplier

d
comment: Deci 10**-1.
stereotype: enum
type: UnitMultiplier

none
comment: No multiplier or equivalently multiply by 1.
stereotype: enum
type: UnitMultiplier

da
comment: Deca 10**1.
stereotype: enum
type: UnitMultiplier

h
comment: Hecto 10**2.
stereotype: enum
type: UnitMultiplier

k
comment: Kilo 10**3.
stereotype: enum
type: UnitMultiplier

M
comment: Mega 10**6.
stereotype: enum
type: UnitMultiplier

G
comment: Giga 10**9.
stereotype: enum
type: UnitMultiplier

T
comment: Tera 10**12.
stereotype: enum
type: UnitMultiplier

P
comment: Peta 10**15.
stereotype: enum
type: UnitMultiplier

E
comment: Exa 10**18.
stereotype: enum
type: UnitMultiplier

Z
comment: Zetta 10**21.
stereotype: enum
type: UnitMultiplier

Y
comment: Yotta 10**24.
stereotype: enum
type: UnitMultiplier

unit
stereotype: attribute
domain: ActivePower
range: UnitSymbol
multiplicity: M:0..1
is fixed: W
type: Property

UnitSymbol
comment: 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.
belongs to category: SteadyStateHypothesisProfile
stereotype: enumeration
type: Class

none
comment: Dimension less quantity, e.g. count, per unit, etc.
stereotype: enum
type: UnitSymbol

m
comment: Length in metres.
stereotype: enum
type: UnitSymbol

kg
comment: Mass in kilograms. Note: multiplier “k” is included in this unit symbol for compatibility with IEC 61850-7-3.
stereotype: enum
type: UnitSymbol

s
comment: Time in seconds.
stereotype: enum
type: UnitSymbol

A
comment: Current in amperes.
stereotype: enum
type: UnitSymbol

K
comment: Temperature in kelvins.
stereotype: enum
type: UnitSymbol

mol
comment: Amount of substance in moles.
stereotype: enum
type: UnitSymbol

cd
comment: Luminous intensity in candelas.
stereotype: enum
type: UnitSymbol

deg
comment: Plane angle in degrees.
stereotype: enum
type: UnitSymbol

rad
comment: Plane angle in radians (m/m).
stereotype: enum
type: UnitSymbol

sr
comment: Solid angle in steradians (m2/m2).
stereotype: enum
type: UnitSymbol

Gy
comment: Absorbed dose in grays (J/kg).
stereotype: enum
type: UnitSymbol

Bq
comment: Radioactivity in becquerels (1/s).
stereotype: enum
type: UnitSymbol

degC
comment: 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.
stereotype: enum
type: UnitSymbol

Sv
comment: Dose equivalent in sieverts (J/kg).
stereotype: enum
type: UnitSymbol

F
comment: Electric capacitance in farads (C/V).
stereotype: enum
type: UnitSymbol

C
comment: Electric charge in coulombs (A·s).
stereotype: enum
type: UnitSymbol

S
comment: Conductance in siemens.
stereotype: enum
type: UnitSymbol

H
comment: Electric inductance in henrys (Wb/A).
stereotype: enum
type: UnitSymbol

V
comment: Electric potential in volts (W/A).
stereotype: enum
type: UnitSymbol

ohm
comment: Electric resistance in ohms (V/A).
stereotype: enum
type: UnitSymbol

J
comment: Energy in joules (N·m = C·V = W·s).
stereotype: enum
type: UnitSymbol

N
comment: Force in newtons (kg·m/s²).
stereotype: enum
type: UnitSymbol

Hz
comment: Frequency in hertz (1/s).
stereotype: enum
type: UnitSymbol

lx
comment: Illuminance in lux (lm/m²).
stereotype: enum
type: UnitSymbol

lm
comment: Luminous flux in lumens (cd·sr).
stereotype: enum
type: UnitSymbol

Wb
comment: Magnetic flux in webers (V·s).
stereotype: enum
type: UnitSymbol

T
comment: Magnetic flux density in teslas (Wb/m2).
stereotype: enum
type: UnitSymbol

W
comment: 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.
stereotype: enum
type: UnitSymbol

Pa
comment: Pressure in pascals (N/m²). Note: the absolute or relative measurement of pressure is implied with this entry. See below for more explicit forms.
stereotype: enum
type: UnitSymbol

m2
comment: Area in square metres (m²).
stereotype: enum
type: UnitSymbol

m3
comment: Volume in cubic metres (m³).
stereotype: enum
type: UnitSymbol

mPers
comment: Velocity in metres per second (m/s).
stereotype: enum
type: UnitSymbol

mPers2
comment: Acceleration in metres per second squared (m/s²).
stereotype: enum
type: UnitSymbol

m3Pers
comment: Volumetric flow rate in cubic metres per second (m³/s).
stereotype: enum
type: UnitSymbol

mPerm3
comment: Fuel efficiency in metres per cubic metres (m/m³).
stereotype: enum
type: UnitSymbol

kgm
comment: 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.
stereotype: enum
type: UnitSymbol

kgPerm3
comment: Density in kilogram/cubic metres (kg/m³). Note: multiplier “k” is included in this unit symbol for compatibility with IEC 61850-7-3.
stereotype: enum
type: UnitSymbol

m2Pers
comment: Viscosity in square metres / second (m²/s).
stereotype: enum
type: UnitSymbol

WPermK
comment: Thermal conductivity in watt/metres kelvin.
stereotype: enum
type: UnitSymbol

JPerK
comment: Heat capacity in joules/kelvin.
stereotype: enum
type: UnitSymbol

ppm
comment: Concentration in parts per million.
stereotype: enum
type: UnitSymbol

rotPers
comment: Rotations per second (1/s). See also Hz (1/s).
stereotype: enum
type: UnitSymbol

radPers
comment: Angular velocity in radians per second (rad/s).
stereotype: enum
type: UnitSymbol

WPerm2
comment: Heat flux density, irradiance, watts per square metre.
stereotype: enum
type: UnitSymbol

JPerm2
comment: Insulation energy density, joules per square metre or watt second per square metre.
stereotype: enum
type: UnitSymbol

SPerm
comment: Conductance per length (F/m).
stereotype: enum
type: UnitSymbol

KPers
comment: Temperature change rate in kelvins per second.
stereotype: enum
type: UnitSymbol

PaPers
comment: Pressure change rate in pascals per second.
stereotype: enum
type: UnitSymbol

JPerkgK
comment: Specific heat capacity, specific entropy, joules per kilogram Kelvin.
stereotype: enum
type: UnitSymbol

VA
comment: Apparent power in volt amperes. See also real power and reactive power.
stereotype: enum
type: UnitSymbol

VAr
comment: 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.
stereotype: enum
type: UnitSymbol

cosPhi
comment: 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.
stereotype: enum
type: UnitSymbol

Vs
comment: Volt seconds (Ws/A).
stereotype: enum
type: UnitSymbol

V2
comment: Volt squared (W²/A²).
stereotype: enum
type: UnitSymbol

As
comment: Ampere seconds (A·s).
stereotype: enum
type: UnitSymbol

A2
comment: Amperes squared (A²).
stereotype: enum
type: UnitSymbol

A2s
comment: Ampere squared time in square amperes (A²s).
stereotype: enum
type: UnitSymbol

VAh
comment: Apparent energy in volt ampere hours.
stereotype: enum
type: UnitSymbol

Wh
comment: Real energy in watt hours.
stereotype: enum
type: UnitSymbol

VArh
comment: Reactive energy in volt ampere reactive hours.
stereotype: enum
type: UnitSymbol

VPerHz
comment: Magnetic flux in volt per hertz.
stereotype: enum
type: UnitSymbol

HzPers
comment: Rate of change of frequency in hertz per second.
stereotype: enum
type: UnitSymbol

character
comment: Number of characters.
stereotype: enum
type: UnitSymbol

charPers
comment: Data rate (baud) in characters per second.
stereotype: enum
type: UnitSymbol

kgm2
comment: 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.
stereotype: enum
type: UnitSymbol

dB
comment: Sound pressure level in decibels. Note: multiplier “d” is included in this unit symbol for compatibility with IEC 61850-7-3.
stereotype: enum
type: UnitSymbol

WPers
comment: Ramp rate in watts per second.
stereotype: enum
type: UnitSymbol

lPers
comment: Volumetric flow rate in litres per second.
stereotype: enum
type: UnitSymbol

dBm
comment: 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.
stereotype: enum
type: UnitSymbol

h
comment: Time in hours, hour = 60 min = 3600 s.
stereotype: enum
type: UnitSymbol

min
comment: Time in minutes, minute = 60 s.
stereotype: enum
type: UnitSymbol

Q
comment: Quantity power, Q.
stereotype: enum
type: UnitSymbol

Qh
comment: Quantity energy, Qh.
stereotype: enum
type: UnitSymbol

ohmm
comment: Resistivity, ohm metres, (rho).
stereotype: enum
type: UnitSymbol

APerm
comment: A/m, magnetic field strength, amperes per metre.
stereotype: enum
type: UnitSymbol

V2h
comment: Volt-squared hour, volt-squared-hours.
stereotype: enum
type: UnitSymbol

A2h
comment: Ampere-squared hour, ampere-squared hour.
stereotype: enum
type: UnitSymbol

Ah
comment: Ampere-hours, ampere-hours.
stereotype: enum
type: UnitSymbol

count
comment: Amount of substance, Counter value.
stereotype: enum
type: UnitSymbol

ft3
comment: Volume, cubic feet.
stereotype: enum
type: UnitSymbol

m3Perh
comment: Volumetric flow rate, cubic metres per hour.
stereotype: enum
type: UnitSymbol

gal
comment: Volume in gallons, US gallon (1 gal = 231 in3 = 128 fl ounce).
stereotype: enum
type: UnitSymbol

Btu
comment: Energy, British Thermal Units.
stereotype: enum
type: UnitSymbol

l
comment: Volume in litres, litre = dm3 = m3/1000.
stereotype: enum
type: UnitSymbol

lPerh
comment: Volumetric flow rate, litres per hour.
stereotype: enum
type: UnitSymbol

lPerl
comment: 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’.
stereotype: enum
type: UnitSymbol

gPerg
comment: 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’.
stereotype: enum
type: UnitSymbol

molPerm3
comment: Concentration, The amount of substance concentration, (c), the amount of solvent in moles divided by the volume of solution in m³.
stereotype: enum
type: UnitSymbol

molPermol
comment: Concentration, Molar fraction, the ratio of the molar amount of a solute divided by the molar amount of the solution.
stereotype: enum
type: UnitSymbol

molPerkg
comment: Concentration, Molality, the amount of solute in moles and the amount of solvent in kilograms.
stereotype: enum
type: UnitSymbol

sPers
comment: Time, Ratio of time. Note: Users may need to supply a prefix such as ‘µ’ to show rates such as ‘µs/s’.
stereotype: enum
type: UnitSymbol

HzPerHz
comment: Frequency, rate of frequency change. Note: Users may need to supply a prefix such as ‘m’ to show rates such as ‘mHz/Hz’.
stereotype: enum
type: UnitSymbol

VPerV
comment: Voltage, ratio of voltages. Note: Users may need to supply a prefix such as ‘m’ to show rates such as ‘mV/V’.
stereotype: enum
type: UnitSymbol

APerA
comment: Current, ratio of amperages. Note: Users may need to supply a prefix such as ‘m’ to show rates such as ‘mA/A’.
stereotype: enum
type: UnitSymbol

VPerVA
comment: 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.
stereotype: enum
type: UnitSymbol

rev
comment: Amount of rotation, revolutions.
stereotype: enum
type: UnitSymbol

kat
comment: Catalytic activity, katal = mol / s.
stereotype: enum
type: UnitSymbol

JPerkg
comment: Specific energy, Joules / kg.
stereotype: enum
type: UnitSymbol

m3Uncompensated
comment: Volume, cubic metres, with the value uncompensated for weather effects.
stereotype: enum
type: UnitSymbol

m3Compensated
comment: Volume, cubic metres, with the value compensated for weather effects.
stereotype: enum
type: UnitSymbol

WPerW
comment: Signal Strength, ratio of power. Note: Users may need to supply a prefix such as ‘m’ to show rates such as ‘mW/W’.
stereotype: enum
type: UnitSymbol

therm
comment: Energy, therms.
stereotype: enum
type: UnitSymbol

onePerm
comment: Wavenumber, reciprocal metres, (1/m).
stereotype: enum
type: UnitSymbol

m3Perkg
comment: Specific volume, cubic metres per kilogram, v.
stereotype: enum
type: UnitSymbol

Pas
comment: Dynamic viscosity, pascal seconds.
stereotype: enum
type: UnitSymbol

Nm
comment: Moment of force, newton metres.
stereotype: enum
type: UnitSymbol

NPerm
comment: Surface tension, newton per metre.
stereotype: enum
type: UnitSymbol

radPers2
comment: Angular acceleration, radians per second squared.
stereotype: enum
type: UnitSymbol

JPerm3
comment: Energy density, joules per cubic metre.
stereotype: enum
type: UnitSymbol

VPerm
comment: Electric field strength, volts per metre.
stereotype: enum
type: UnitSymbol

CPerm3
comment: Electric charge density, coulombs per cubic metre.
stereotype: enum
type: UnitSymbol

CPerm2
comment: Surface charge density, coulombs per square metre.
stereotype: enum
type: UnitSymbol

FPerm
comment: Permittivity, farads per metre.
stereotype: enum
type: UnitSymbol

HPerm
comment: Permeability, henrys per metre.
stereotype: enum
type: UnitSymbol

JPermol
comment: Molar energy, joules per mole.
stereotype: enum
type: UnitSymbol

JPermolK
comment: Molar entropy, molar heat capacity, joules per mole kelvin.
stereotype: enum
type: UnitSymbol

CPerkg
comment: Exposure (x rays), coulombs per kilogram.
stereotype: enum
type: UnitSymbol

GyPers
comment: Absorbed dose rate, grays per second.
stereotype: enum
type: UnitSymbol

WPersr
comment: Radiant intensity, watts per steradian.
stereotype: enum
type: UnitSymbol

WPerm2sr
comment: Radiance, watts per square metre steradian.
stereotype: enum
type: UnitSymbol

katPerm3
comment: Catalytic activity concentration, katals per cubic metre.
stereotype: enum
type: UnitSymbol

d
comment: Time in days, day = 24 h = 86400 s.
stereotype: enum
type: UnitSymbol

anglemin
comment: Plane angle, minutes.
stereotype: enum
type: UnitSymbol

anglesec
comment: Plane angle, seconds.
stereotype: enum
type: UnitSymbol

ha
comment: Area, hectares.
stereotype: enum
type: UnitSymbol

tonne
comment: Mass in tons, “tonne” or “metric ton” (1000 kg = 1 Mg).
stereotype: enum
type: UnitSymbol

bar
comment: Pressure in bars, (1 bar = 100 kPa).
stereotype: enum
type: UnitSymbol

mmHg
comment: Pressure, millimetres of mercury (1 mmHg is approximately 133.3 Pa).
stereotype: enum
type: UnitSymbol

M
comment: Length, nautical miles (1 M = 1852 m).
stereotype: enum
type: UnitSymbol

kn
comment: Speed, knots (1 kn = 1852/3600) m/s.
stereotype: enum
type: UnitSymbol

Mx
comment: Magnetic flux, maxwells (1 Mx = 10-8 Wb).
stereotype: enum
type: UnitSymbol

G
comment: Magnetic flux density, gausses (1 G = 10-4 T).
stereotype: enum
type: UnitSymbol

Oe
comment: Magnetic field in oersteds, (1 Oe = (103/4p) A/m).
stereotype: enum
type: UnitSymbol

Vh
comment: Volt-hour, Volt hours.
stereotype: enum
type: UnitSymbol

WPerA
comment: Active power per current flow, watts per Ampere.
stereotype: enum
type: UnitSymbol

onePerHz
comment: Reciprocal of frequency (1/Hz).
stereotype: enum
type: UnitSymbol

VPerVAr
comment: 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.
stereotype: enum
type: UnitSymbol

ohmPerm
comment: Electric resistance per length in ohms per metre ((V/A)/m).
stereotype: enum
type: UnitSymbol

kgPerJ
comment: 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.
stereotype: enum
type: UnitSymbol

JPers
comment: Energy rate in joules per second (J/s).
stereotype: enum
type: UnitSymbol

q
stereotype: attribute
domain: ACDCConverter
data type: ReactivePower
multiplicity: M:1..1
comment: Reactive power at the point of common coupling. Load sign convention is used, i.e. positive sign means flow out from a node. Starting value for a steady state solution in the case a simplified power flow model is used.
type: Property

ReactivePower
comment: Product of RMS value of the voltage and the RMS value of the quadrature component of the current.
stereotype: CIMDatatype
belongs to category: SteadyStateHypothesisProfile
type: Class

value
stereotype: attribute
domain: ReactivePower
data type: Float
multiplicity: M:0..1
type: Property

unit
stereotype: attribute
domain: ReactivePower
range: UnitSymbol
multiplicity: M:0..1
is fixed: VAr
type: Property

multiplier
stereotype: attribute
domain: ReactivePower
range: UnitMultiplier
multiplicity: M:0..1
is fixed: M
type: Property

targetPpcc
stereotype: attribute
domain: ACDCConverter
data type: ActivePower
multiplicity: M:0..1
comment: Real power injection target in AC grid, at point of common coupling. Load sign convention is used, i.e. positive sign means flow out from a node.
type: Property

targetUdc
stereotype: attribute
domain: ACDCConverter
data type: Voltage
multiplicity: M:0..1
comment: Target value for DC voltage magnitude. The attribute shall be a positive value.
type: Property

Voltage
comment: Electrical voltage, can be both AC and DC.
stereotype: CIMDatatype
belongs to category: SteadyStateHypothesisProfile
type: Class

value
stereotype: attribute
domain: Voltage
data type: Float
multiplicity: M:0..1
type: Property

multiplier
stereotype: attribute
domain: Voltage
range: UnitMultiplier
multiplicity: M:0..1
is fixed: k
type: Property

unit
stereotype: attribute
domain: Voltage
range: UnitSymbol
multiplicity: M:0..1
is fixed: V
type: Property

ACDCConverterDCTerminal
subclass of: DCBaseTerminal
comment: A DC electrical connection point at the AC/DC converter. The AC/DC converter is electrically connected also to the AC side. The AC connection is inherited from the AC conducting equipment in the same way as any other AC equipment. The AC/DC converter DC terminal is separate from generic DC terminal to restrict the connection with the AC side to AC/DC converter and so that no other DC conducting equipment can be connected to the AC side.
stereotype: Description
belongs to category: SteadyStateHypothesisProfile
stereotype: concrete
type: Class

ACDCTerminal
subclass of: IdentifiedObject
comment: An electrical connection point (AC or DC) to a piece of conducting equipment. Terminals are connected at physical connection points called connectivity nodes.
belongs to category: SteadyStateHypothesisProfile
type: Class

connected
stereotype: attribute
domain: ACDCTerminal
data type: Boolean
multiplicity: M:1..1
comment: The connected status is related to a bus-branch model and the topological node to terminal relation. True implies the terminal is connected to the related topological node and false implies it is not. In a bus-branch model, the connected status is used to tell if equipment is disconnected without having to change the connectivity described by the topological node to terminal relation. A valid case is that conducting equipment can be connected in one end and open in the other. In particular for an AC line segment, where the reactive line charging can be significant, this is a relevant case.
type: Property

Boolean
comment: A type with the value space "true" and "false".
stereotype: Primitive
belongs to category: SteadyStateHypothesisProfile
type: Class

ActivePowerLimit
subclass of: OperationalLimit
comment: Limit on active power flow.
stereotype: Description
belongs to category: SteadyStateHypothesisProfile
stereotype: concrete
type: Class

value
stereotype: attribute
domain: ActivePowerLimit
data type: ActivePower
multiplicity: M:1..1
comment: Value of active power limit. The attribute shall be a positive value or zero.
type: Property

ApparentPowerLimit
subclass of: OperationalLimit
comment: Apparent power limit.
stereotype: Description
belongs to category: SteadyStateHypothesisProfile
stereotype: concrete
type: Class

value
stereotype: attribute
domain: ApparentPowerLimit
data type: ApparentPower
multiplicity: M:1..1
comment: The apparent power limit. The attribute shall be a positive value or zero.
type: Property

ApparentPower
comment: Product of the RMS value of the voltage and the RMS value of the current.
stereotype: CIMDatatype
belongs to category: SteadyStateHypothesisProfile
type: Class

value
stereotype: attribute
domain: ApparentPower
data type: Float
multiplicity: M:0..1
type: Property

multiplier
stereotype: attribute
domain: ApparentPower
range: UnitMultiplier
multiplicity: M:0..1
is fixed: M
type: Property

unit
stereotype: attribute
domain: ApparentPower
range: UnitSymbol
multiplicity: M:0..1
is fixed: VA
type: Property

AsynchronousMachine
subclass of: RotatingMachine
comment: 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.
stereotype: Description
belongs to category: SteadyStateHypothesisProfile
stereotype: concrete
type: Class

asynchronousMachineType
stereotype: attribute
domain: AsynchronousMachine
range: AsynchronousMachineKind
multiplicity: M:1..1
comment: Indicates the type of Asynchronous Machine (motor or generator).
type: Property

AsynchronousMachineKind
comment: Kind of Asynchronous Machine.
belongs to category: SteadyStateHypothesisProfile
stereotype: enumeration
type: Class

generator
comment: The Asynchronous Machine is a generator.
stereotype: enum
type: AsynchronousMachineKind

motor
comment: The Asynchronous Machine is a motor.
stereotype: enum
type: AsynchronousMachineKind

BatteryUnit
subclass of: PowerElectronicsUnit
comment: An electrochemical energy storage device.
stereotype: Description
belongs to category: SteadyStateHypothesisProfile
stereotype: concrete
type: Class

batteryState
stereotype: attribute
domain: BatteryUnit
range: BatteryStateKind
multiplicity: M:1..1
comment: The current state of the battery (charging, full, etc.).
type: Property

BatteryStateKind
comment: The state of the battery unit.
belongs to category: SteadyStateHypothesisProfile
stereotype: enumeration
type: Class

discharging
comment: Stored energy is decreasing.
stereotype: enum
type: BatteryStateKind

full
comment: Unable to charge, and not discharging.
stereotype: enum
type: BatteryStateKind

waiting
comment: Neither charging nor discharging, but able to do so.
stereotype: enum
type: BatteryStateKind

charging
comment: Stored energy is increasing.
stereotype: enum
type: BatteryStateKind

empty
comment: Unable to discharge, and not charging.
stereotype: enum
type: BatteryStateKind

storedE
stereotype: attribute
domain: BatteryUnit
data type: RealEnergy
multiplicity: M:1..1
comment: Amount of energy currently stored. The attribute shall be a positive value or zero and lower than BatteryUnit.ratedE.
type: Property

RealEnergy
comment: Real electrical energy.
stereotype: CIMDatatype
belongs to category: SteadyStateHypothesisProfile
type: Class

multiplier
stereotype: attribute
domain: RealEnergy
range: UnitMultiplier
multiplicity: M:0..1
is fixed: M
type: Property

unit
stereotype: attribute
domain: RealEnergy
range: UnitSymbol
multiplicity: M:0..1
is fixed: Wh
type: Property

value
stereotype: attribute
domain: RealEnergy
data type: Float
multiplicity: M:0..1
type: Property

Breaker
subclass of: ProtectedSwitch
comment: A mechanical switching device capable of making, carrying, and breaking currents under normal circuit conditions and also making, carrying for a specified time, and breaking currents under specified abnormal circuit conditions e.g. those of short circuit.
stereotype: Description
belongs to category: SteadyStateHypothesisProfile
stereotype: concrete
type: Class

ConductingEquipment
subclass of: Equipment
comment: The parts of the AC power system that are designed to carry current or that are conductively connected through terminals.
belongs to category: SteadyStateHypothesisProfile
type: Class

ConformLoad
subclass of: EnergyConsumer
comment: ConformLoad represent loads that follow a daily load change pattern where the pattern can be used to scale the load with a system load.
stereotype: Description
belongs to category: SteadyStateHypothesisProfile
stereotype: concrete
type: Class

ControlArea
subclass of: PowerSystemResource
comment: A control area is a grouping of generating units and/or loads and a cutset of tie lines (as terminals) which may be used for a variety of purposes including automatic generation control, power flow solution area interchange control specification, and input to load forecasting. All generation and load within the area defined by the terminals on the border are considered in the area interchange control. Note that any number of overlapping control area specifications can be superimposed on the physical model. The following general principles apply to ControlArea: 1. The control area orientation for net interchange is positive for an import, negative for an export. 2. The control area net interchange is determined by summing flows in Terminals. The Terminals are identified by creating a set of TieFlow objects associated with a ControlArea object. Each TieFlow object identifies one Terminal. 3. In a single network model, a tie between two control areas must be modelled in both control area specifications, such that the two representations of the tie flow sum to zero. 4. The normal orientation of Terminal flow is positive for flow into the conducting equipment that owns the Terminal. (i.e. flow from a bus into a device is positive.) However, the orientation of each flow in the control area specification must align with the control area convention, i.e. import is positive. If the orientation of the Terminal flow referenced by a TieFlow is positive into the control area, then this is confirmed by setting TieFlow.positiveFlowIn flag TRUE. If not, the orientation must be reversed by setting the TieFlow.positiveFlowIn flag FALSE.
stereotype: Description
belongs to category: SteadyStateHypothesisProfile
stereotype: concrete
type: Class

netInterchange
stereotype: attribute
domain: ControlArea
data type: ActivePower
multiplicity: M:1..1
comment: The specified positive net interchange into the control area, i.e. positive sign means flow into the area.
type: Property

pTolerance
stereotype: attribute
domain: ControlArea
data type: ActivePower
multiplicity: M:0..1
comment: Active power net interchange tolerance. The attribute shall be a positive value or zero.
type: Property

CsConverter
subclass of: ACDCConverter
comment: DC side of the current source converter (CSC). The firing angle controls the dc voltage at the converter, both for rectifier and inverter. The difference between the dc voltages of the rectifier and inverter determines the dc current. The extinction angle is used to limit the dc voltage at the inverter, if needed, and is not used in active power control. The firing angle, transformer tap position and number of connected filters are the primary means to control a current source dc line. Higher level controls are built on top, e.g. dc voltage, dc current and active power. From a steady state perspective it is sufficient to specify the wanted active power transfer (ACDCConverter.targetPpcc) and the control functions will set the dc voltage, dc current, firing angle, transformer tap position and number of connected filters to meet this. Therefore attributes targetAlpha and targetGamma are not applicable in this case. The reactive power consumed by the converter is a function of the firing angle, transformer tap position and number of connected filter, which can be approximated with half of the active power. The losses is a function of the dc voltage and dc current. The attributes minAlpha and maxAlpha define the range of firing angles for rectifier operation between which no discrete tap changer action takes place. The range is typically 10-18 degrees. The attributes minGamma and maxGamma define the range of extinction angles for inverter operation between which no discrete tap changer action takes place. The range is typically 17-20 degrees.
stereotype: Description
belongs to category: SteadyStateHypothesisProfile
stereotype: concrete
type: Class

operatingMode
stereotype: attribute
domain: CsConverter
range: CsOperatingModeKind
multiplicity: M:1..1
comment: Indicates whether the DC pole is operating as an inverter or as a rectifier. It is converter’s control variable used in power flow.
type: Property

CsOperatingModeKind
comment: Operating mode for HVDC line operating as Current Source Converter.
belongs to category: SteadyStateHypothesisProfile
stereotype: enumeration
type: Class

inverter
comment: Operating as inverter, which is the power receiving end.
stereotype: enum
type: CsOperatingModeKind

rectifier
comment: Operating as rectifier, which is the power sending end.
stereotype: enum
type: CsOperatingModeKind

pPccControl
stereotype: attribute
domain: CsConverter
range: CsPpccControlKind
multiplicity: M:1..1
comment: Kind of active power control.
type: Property

CsPpccControlKind
comment: Active power control modes for HVDC line operating as Current Source Converter.
belongs to category: SteadyStateHypothesisProfile
stereotype: enumeration
type: Class

activePower
comment: Control is active power control at AC side, at point of common coupling. Target is provided by ACDCConverter.targetPpcc.
stereotype: enum
type: CsPpccControlKind

dcVoltage
comment: Control is DC voltage with target value provided by ACDCConverter.targetUdc.
stereotype: enum
type: CsPpccControlKind

dcCurrent
comment: Control is DC current with target value provided by CsConverter.targetIdc.
stereotype: enum
type: CsPpccControlKind

targetAlpha
stereotype: attribute
domain: CsConverter
data type: AngleDegrees
multiplicity: M:0..1
comment: Target firing angle. It is converter’s control variable used in power flow. It is only applicable for rectifier if continuous tap changer control is used. Allowed values are within the range minAlpha<=targetAlpha<=maxAlpha. The attribute shall be a positive value.
type: Property

AngleDegrees
comment: Measurement of angle in degrees.
stereotype: CIMDatatype
belongs to category: SteadyStateHypothesisProfile
type: Class

value
stereotype: attribute
domain: AngleDegrees
data type: Float
multiplicity: M:0..1
type: Property

unit
stereotype: attribute
domain: AngleDegrees
range: UnitSymbol
multiplicity: M:0..1
is fixed: deg
type: Property

multiplier
stereotype: attribute
domain: AngleDegrees
range: UnitMultiplier
multiplicity: M:0..1
is fixed: none
type: Property

targetGamma
stereotype: attribute
domain: CsConverter
data type: AngleDegrees
multiplicity: M:0..1
comment: Target extinction angle. It is converter’s control variable used in power flow. It is only applicable for inverter if continuous tap changer control is used. Allowed values are within the range minGamma<=targetGamma<=maxGamma. The attribute shall be a positive value.
type: Property

targetIdc
stereotype: attribute
domain: CsConverter
data type: CurrentFlow
multiplicity: M:0..1
comment: DC current target value. It is converter’s control variable used in power flow. The attribute shall be a positive value.
type: Property

CurrentFlow
comment: Electrical current with sign convention: positive flow is out of the conducting equipment into the connectivity node. Can be both AC and DC.
stereotype: CIMDatatype
belongs to category: SteadyStateHypothesisProfile
type: Class

value
stereotype: attribute
domain: CurrentFlow
data type: Float
multiplicity: M:0..1
type: Property

multiplier
stereotype: attribute
domain: CurrentFlow
range: UnitMultiplier
multiplicity: M:0..1
is fixed: none
type: Property

unit
stereotype: attribute
domain: CurrentFlow
range: UnitSymbol
multiplicity: M:0..1
is fixed: A
type: Property

CurrentLimit
subclass of: OperationalLimit
comment: Operational limit on current.
stereotype: Description
belongs to category: SteadyStateHypothesisProfile
stereotype: concrete
type: Class

value
stereotype: attribute
domain: CurrentLimit
data type: CurrentFlow
multiplicity: M:1..1
comment: Limit on current flow. The attribute shall be a positive value or zero.
type: Property

DCBaseTerminal
subclass of: ACDCTerminal
comment: An electrical connection point at a piece of DC conducting equipment. DC terminals are connected at one physical DC node that may have multiple DC terminals connected. A DC node is similar to an AC connectivity node. The model requires that DC connections are distinct from AC connections.
belongs to category: SteadyStateHypothesisProfile
type: Class

DCTerminal
subclass of: DCBaseTerminal
comment: An electrical connection point to generic DC conducting equipment.
stereotype: Description
belongs to category: SteadyStateHypothesisProfile
stereotype: concrete
type: Class

Disconnector
subclass of: Switch
comment: A manually operated or motor operated mechanical switching device used for changing the connections in a circuit, or for isolating a circuit or equipment from a source of power. It is required to open or close circuits when negligible current is broken or made.
stereotype: Description
belongs to category: SteadyStateHypothesisProfile
stereotype: concrete
type: Class

DisconnectingCircuitBreaker
subclass of: Breaker
comment: A circuit breaking device including disconnecting function, eliminating the need for separate disconnectors.
stereotype: Description
belongs to category: SteadyStateHypothesisProfile
stereotype: concrete
type: Class

EnergyConnection
subclass of: ConductingEquipment
comment: A connection of energy generation or consumption on the power system model.
belongs to category: SteadyStateHypothesisProfile
type: Class

EnergyConsumer
subclass of: EnergyConnection
comment: 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.
stereotype: Description
belongs to category: SteadyStateHypothesisProfile
stereotype: concrete
type: Class

p
stereotype: attribute
domain: EnergyConsumer
data type: ActivePower
multiplicity: M:1..1
comment: Active power of the load. Load sign convention is used, i.e. positive sign means flow out from a node. For voltage dependent loads the value is at rated voltage. Starting value for a steady state solution.
type: Property

q
stereotype: attribute
domain: EnergyConsumer
data type: ReactivePower
multiplicity: M:1..1
comment: Reactive power of the load. Load sign convention is used, i.e. positive sign means flow out from a node. For voltage dependent loads the value is at rated voltage. Starting value for a steady state solution.
type: Property

EnergySource
subclass of: EnergyConnection
comment: A generic equivalent for an energy supplier on a transmission or distribution voltage level.
stereotype: Description
belongs to category: SteadyStateHypothesisProfile
stereotype: concrete
type: Class

activePower
stereotype: attribute
domain: EnergySource
data type: ActivePower
multiplicity: M:1..1
comment: High voltage source active injection. Load sign convention is used, i.e. positive sign means flow out from a node. Starting value for steady state solutions.
type: Property

reactivePower
stereotype: attribute
domain: EnergySource
data type: ReactivePower
multiplicity: M:1..1
comment: High voltage source reactive injection. Load sign convention is used, i.e. positive sign means flow out from a node. Starting value for steady state solutions.
type: Property

voltageAngle
stereotype: attribute
domain: EnergySource
data type: AngleRadians
multiplicity: M:0..1
comment: Phase angle of a-phase open circuit used when voltage characteristics need to be imposed at the node associated with the terminal of the energy source, such as when voltages and angles from the transmission level are used as input to the distribution network. The attribute shall be a positive value or zero.
type: Property

AngleRadians
comment: Phase angle in radians.
stereotype: CIMDatatype
belongs to category: SteadyStateHypothesisProfile
type: Class

value
stereotype: attribute
domain: AngleRadians
data type: Float
multiplicity: M:0..1
type: Property

unit
stereotype: attribute
domain: AngleRadians
range: UnitSymbol
multiplicity: M:0..1
is fixed: rad
type: Property

multiplier
stereotype: attribute
domain: AngleRadians
range: UnitMultiplier
multiplicity: M:0..1
is fixed: none
type: Property

voltageMagnitude
stereotype: attribute
domain: EnergySource
data type: Voltage
multiplicity: M:0..1
comment: Phase-to-phase open circuit voltage magnitude used when voltage characteristics need to be imposed at the node associated with the terminal of the energy source, such as when voltages and angles from the transmission level are used as input to the distribution network. The attribute shall be a positive value or zero.
type: Property

Equipment
subclass of: PowerSystemResource
comment: The parts of a power system that are physical devices, electronic or mechanical.
belongs to category: SteadyStateHypothesisProfile
stereotype: concrete
type: Class

inService
stereotype: attribute
domain: Equipment
data type: Boolean
multiplicity: M:1..1
comment: Specifies the availability of the equipment. 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.
type: Property

EquivalentEquipment
subclass of: ConductingEquipment
comment: The class represents equivalent objects that are the result of a network reduction. The class is the base for equivalent objects of different types.
belongs to category: SteadyStateHypothesisProfile
type: Class

EquivalentInjection
subclass of: EquivalentEquipment
comment: This class represents equivalent injections (generation or load). Voltage regulation is allowed only at the point of connection.
stereotype: Description
belongs to category: SteadyStateHypothesisProfile
stereotype: concrete
type: Class

regulationStatus
stereotype: attribute
domain: EquivalentInjection
data type: Boolean
multiplicity: M:0..1
comment: Specifies the regulation status of the EquivalentInjection. True is regulating. False is not regulating.
type: Property

regulationTarget
stereotype: attribute
domain: EquivalentInjection
data type: Voltage
multiplicity: M:0..1
comment: The target voltage for voltage regulation. The attribute shall be a positive value.
type: Property

p
stereotype: attribute
domain: EquivalentInjection
data type: ActivePower
multiplicity: M:1..1
comment: Equivalent active power injection. Load sign convention is used, i.e. positive sign means flow out from a node. Starting value for steady state solutions.
type: Property

q
stereotype: attribute
domain: EquivalentInjection
data type: ReactivePower
multiplicity: M:1..1
comment: Equivalent reactive power injection. Load sign convention is used, i.e. positive sign means flow out from a node. Starting value for steady state solutions.
type: Property

ExternalNetworkInjection
subclass of: RegulatingCondEq
comment: This class represents the external network and it is used for IEC 60909 calculations.
stereotype: Description
belongs to category: SteadyStateHypothesisProfile
stereotype: concrete
type: Class

referencePriority
stereotype: attribute
domain: ExternalNetworkInjection
data type: Integer
multiplicity: M:1..1
comment: Priority of unit for use as powerflow voltage phase angle reference bus selection. 0 = don t care (default) 1 = highest priority. 2 is less than 1 and so on.
type: Property

Integer
comment: An integer number. The range is unspecified and not limited.
stereotype: Primitive
belongs to category: SteadyStateHypothesisProfile
type: Class

p
stereotype: attribute
domain: ExternalNetworkInjection
data type: ActivePower
multiplicity: M:1..1
comment: Active power injection. Load sign convention is used, i.e. positive sign means flow out from a node. Starting value for steady state solutions.
type: Property

q
stereotype: attribute
domain: ExternalNetworkInjection
data type: ReactivePower
multiplicity: M:1..1
comment: Reactive power injection. Load sign convention is used, i.e. positive sign means flow out from a node. Starting value for steady state solutions.
type: Property

Fuse
subclass of: Switch
comment: An overcurrent protective device with a circuit opening fusible part that is heated and severed by the passage of overcurrent through it. A fuse is considered a switching device because it breaks current.
stereotype: Description
belongs to category: SteadyStateHypothesisProfile
stereotype: concrete
type: Class

GeneratingUnit
subclass of: Equipment
comment: 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.
stereotype: Description
belongs to category: SteadyStateHypothesisProfile
stereotype: concrete
type: Class

normalPF
stereotype: attribute
domain: GeneratingUnit
data type: Float
multiplicity: M:1..1
comment: Generating unit economic participation factor. The sum of the participation factors across generating units does not have to sum to one. It is used for representing distributed slack participation factor. The attribute shall be a positive value or zero.
type: Property

GroundDisconnector
subclass of: Switch
comment: A manually operated or motor operated mechanical switching device used for isolating a circuit or equipment from ground.
stereotype: Description
belongs to category: SteadyStateHypothesisProfile
stereotype: concrete
type: Class

HydroGeneratingUnit
subclass of: GeneratingUnit
comment: A generating unit whose prime mover is a hydraulic turbine (e.g., Francis, Pelton, Kaplan).
stereotype: Description
belongs to category: SteadyStateHypothesisProfile
stereotype: concrete
type: Class

IdentifiedObject
comment: This is a root class to provide common identification for all classes needing identification and naming attributes.
belongs to category: SteadyStateHypothesisProfile
type: Class

mRID
stereotype: attribute
domain: IdentifiedObject
data type: String
multiplicity: M:1..1
comment: 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.
type: Property

String
comment: A string consisting of a sequence of characters. The character encoding is UTF-8. The string length is unspecified and unlimited.
stereotype: Primitive
belongs to category: SteadyStateHypothesisProfile
type: Class

Jumper
subclass of: Switch
comment: A short section of conductor with negligible impedance which can be manually removed and replaced if the circuit is de-energized. Note that zero-impedance branches can potentially be modelled by other equipment types.
stereotype: Description
belongs to category: SteadyStateHypothesisProfile
stereotype: concrete
type: Class

LinearShuntCompensator
subclass of: ShuntCompensator
comment: A linear shunt compensator has banks or sections with equal admittance values.
stereotype: Description
belongs to category: SteadyStateHypothesisProfile
stereotype: concrete
type: Class

LoadBreakSwitch
subclass of: ProtectedSwitch
comment: A mechanical switching device capable of making, carrying, and breaking currents under normal operating conditions.
stereotype: Description
belongs to category: SteadyStateHypothesisProfile
stereotype: concrete
type: Class

NonConformLoad
subclass of: EnergyConsumer
comment: NonConformLoad represents loads that do not follow a daily load change pattern and whose changes are not correlated with the daily load change pattern.
stereotype: Description
belongs to category: SteadyStateHypothesisProfile
stereotype: concrete
type: Class

NonlinearShuntCompensator
subclass of: ShuntCompensator
comment: A non linear shunt compensator has bank or section admittance values that differ. The attributes g, b, g0 and b0 of the associated NonlinearShuntCompensatorPoint describe the total conductance and admittance of a NonlinearShuntCompensatorPoint at a section number specified by NonlinearShuntCompensatorPoint.sectionNumber.
stereotype: Description
belongs to category: SteadyStateHypothesisProfile
stereotype: concrete
type: Class

NuclearGeneratingUnit
subclass of: GeneratingUnit
comment: A nuclear generating unit.
stereotype: Description
belongs to category: SteadyStateHypothesisProfile
stereotype: concrete
type: Class

OperationalLimit
subclass of: IdentifiedObject
comment: A value and normal value associated with a specific kind of limit. The sub class value and normalValue attributes vary inversely to the associated OperationalLimitType.acceptableDuration (acceptableDuration for short). If a particular piece of equipment has multiple operational limits of the same kind (apparent power, current, etc.), the limit with the greatest acceptableDuration shall have the smallest limit value and the limit with the smallest acceptableDuration shall have the largest limit value. Note: A large current can only be allowed to flow through a piece of equipment for a short duration without causing damage, but a lesser current can be allowed to flow for a longer duration.
belongs to category: SteadyStateHypothesisProfile
type: Class

PhaseTapChanger
subclass of: TapChanger
comment: A transformer phase shifting tap model that controls the phase angle difference across the power transformer and potentially the active power flow through the power transformer. This phase tap model may also impact the voltage magnitude.
belongs to category: SteadyStateHypothesisProfile
type: Class

PhaseTapChangerAsymmetrical
subclass of: PhaseTapChangerNonLinear
comment: Describes the tap model for an asymmetrical phase shifting transformer in which the difference voltage vector adds to the in-phase winding. The out-of-phase winding is the transformer end where the tap changer is located. The angle between the in-phase and out-of-phase windings is named the winding connection angle. The phase shift depends on both the difference voltage magnitude and the winding connection angle.
stereotype: Description
belongs to category: SteadyStateHypothesisProfile
stereotype: concrete
type: Class

PhaseTapChangerLinear
subclass of: PhaseTapChanger
comment: Describes a tap changer with a linear relation between the tap step and the phase angle difference across the transformer. This is a mathematical model that is an approximation of a real phase tap changer. The phase angle is computed as stepPhaseShiftIncrement times the tap position. The voltage magnitude of both sides is the same.
stereotype: Description
belongs to category: SteadyStateHypothesisProfile
stereotype: concrete
type: Class

PhaseTapChangerNonLinear
subclass of: PhaseTapChanger
comment: The non-linear phase tap changer describes the non-linear behaviour of a phase tap changer. This is a base class for the symmetrical and asymmetrical phase tap changer models. The details of these models can be found in IEC 61970-301.
belongs to category: SteadyStateHypothesisProfile
type: Class

PhaseTapChangerSymmetrical
subclass of: PhaseTapChangerNonLinear
comment: Describes a symmetrical phase shifting transformer tap model in which the voltage magnitude of both sides is the same. The difference voltage magnitude is the base in an equal-sided triangle where the sides corresponds to the primary and secondary voltages. The phase angle difference corresponds to the top angle and can be expressed as twice the arctangent of half the total difference voltage.
stereotype: Description
belongs to category: SteadyStateHypothesisProfile
stereotype: concrete
type: Class

PhaseTapChangerTabular
subclass of: PhaseTapChanger
comment: Describes a tap changer with a table defining the relation between the tap step and the phase angle difference across the transformer.
stereotype: Description
belongs to category: SteadyStateHypothesisProfile
stereotype: concrete
type: Class

PowerElectronicsConnection
subclass of: RegulatingCondEq
comment: A connection to the AC network for energy production or consumption that uses power electronics rather than rotating machines.
stereotype: Description
belongs to category: SteadyStateHypothesisProfile
stereotype: concrete
type: Class

p
stereotype: attribute
domain: PowerElectronicsConnection
data type: ActivePower
multiplicity: M:1..1
comment: Active power injection. Load sign convention is used, i.e. positive sign means flow out from a node. Starting value for a steady state solution.
type: Property

q
stereotype: attribute
domain: PowerElectronicsConnection
data type: ReactivePower
multiplicity: M:1..1
comment: Reactive power injection. Load sign convention is used, i.e. positive sign means flow out from a node. Starting value for a steady state solution.
type: Property

PowerElectronicsUnit
subclass of: Equipment
comment: A generating unit or battery or aggregation that connects to the AC network using power electronics rather than rotating machines.
belongs to category: SteadyStateHypothesisProfile
type: Class

PowerSystemResource
subclass of: IdentifiedObject
comment: 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.
belongs to category: SteadyStateHypothesisProfile
type: Class

ProtectedSwitch
subclass of: Switch
comment: A ProtectedSwitch is a switching device that can be operated by ProtectionEquipment.
belongs to category: SteadyStateHypothesisProfile
type: Class

RatioTapChanger
subclass of: TapChanger
comment: A tap changer that changes the voltage ratio impacting the voltage magnitude but not the phase angle across the transformer. Angle sign convention (general): Positive value indicates a positive phase shift from the winding where the tap is located to the other winding (for a two-winding transformer).
stereotype: Description
belongs to category: SteadyStateHypothesisProfile
stereotype: concrete
type: Class

RegulatingCondEq
subclass of: EnergyConnection
comment: A type of conducting equipment that can regulate a quantity (i.e. voltage or flow) at a specific point in the network.
stereotype: Description
belongs to category: SteadyStateHypothesisProfile
type: Class

controlEnabled
stereotype: attribute
domain: RegulatingCondEq
data type: Boolean
multiplicity: M:1..1
comment: Specifies the regulation status of the equipment. True is regulating, false is not regulating.
type: Property

RegulatingControl
subclass of: PowerSystemResource
comment: Specifies a set of equipment that works together to control a power system quantity such as voltage or flow. Remote bus voltage control is possible by specifying the controlled terminal located at some place remote from the controlling equipment. The specified terminal shall be associated with the connectivity node of the controlled point. The most specific subtype of RegulatingControl shall be used in case such equipment participate in the control, e.g. TapChangerControl for tap changers. For flow control, load sign convention is used, i.e. positive sign means flow out from a TopologicalNode (bus) into the conducting equipment. The attribute minAllowedTargetValue and maxAllowedTargetValue are required in the following cases: - For a power generating module operated in power factor control mode to specify maximum and minimum power factor values; - Whenever it is necessary to have an off center target voltage for the tap changer regulator. For instance, due to long cables to off shore wind farms and the need to have a simpler setup at the off shore transformer platform, the voltage is controlled from the land at the connection point for the off shore wind farm. Since there usually is a voltage rise along the cable, there is typical and overvoltage of up 3-4 kV compared to the on shore station. Thus in normal operation the tap changer on the on shore station is operated with a target set point, which is in the lower parts of the dead band. The attributes minAllowedTargetValue and maxAllowedTargetValue are not related to the attribute targetDeadband and thus they are not treated as an alternative of the targetDeadband. They are needed due to limitations in the local substation controller. The attribute targetDeadband is used to prevent the power flow from move the tap position in circles (hunting) that is to be used regardless of the attributes minAllowedTargetValue and maxAllowedTargetValue.
stereotype: Description
belongs to category: SteadyStateHypothesisProfile
stereotype: concrete
type: Class

discrete
stereotype: attribute
domain: RegulatingControl
data type: Boolean
multiplicity: M:1..1
comment: The regulation is performed in a discrete mode. This applies to equipment with discrete controls, e.g. tap changers and shunt compensators.
type: Property

enabled
stereotype: attribute
domain: RegulatingControl
data type: Boolean
multiplicity: M:1..1
comment: The flag tells if regulation is enabled.
type: Property

targetDeadband
stereotype: attribute
domain: RegulatingControl
data type: Float
multiplicity: M:0..1
comment: This is a deadband used with discrete control to avoid excessive update of controls like tap changers and shunt compensator banks while regulating. The units of those appropriate for the mode. The attribute shall be a positive value or zero. If RegulatingControl.discrete is set to "false", the RegulatingControl.targetDeadband is to be ignored. Note that for instance, if the targetValue is 100 kV and the targetDeadband is 2 kV the range is from 99 to 101 kV.
type: Property

targetValue
stereotype: attribute
domain: RegulatingControl
data type: Float
multiplicity: M:1..1
comment: The target value specified for case input. This value can be used for the target value without the use of schedules. The value has the units appropriate to the mode attribute.
type: Property

targetValueUnitMultiplier
stereotype: attribute
domain: RegulatingControl
range: UnitMultiplier
multiplicity: M:1..1
comment: Specify the multiplier for used for the targetValue.
type: Property

maxAllowedTargetValue
stereotype: attribute
domain: RegulatingControl
data type: Float
multiplicity: M:0..1
comment: Maximum allowed target value (RegulatingControl.targetValue).
type: Property

minAllowedTargetValue
stereotype: attribute
domain: RegulatingControl
data type: Float
multiplicity: M:0..1
comment: Minimum allowed target value (RegulatingControl.targetValue).
type: Property

RotatingMachine
subclass of: RegulatingCondEq
comment: A rotating machine which may be used as a generator or motor.
belongs to category: SteadyStateHypothesisProfile
type: Class

p
stereotype: attribute
domain: RotatingMachine
data type: ActivePower
multiplicity: M:1..1
comment: Active power injection. Load sign convention is used, i.e. positive sign means flow out from a node. Starting value for a steady state solution.
type: Property

q
stereotype: attribute
domain: RotatingMachine
data type: ReactivePower
multiplicity: M:1..1
comment: Reactive power injection. Load sign convention is used, i.e. positive sign means flow out from a node. Starting value for a steady state solution.
type: Property

ShuntCompensator
subclass of: RegulatingCondEq
comment: 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.
belongs to category: SteadyStateHypothesisProfile
type: Class

sections
stereotype: attribute
domain: ShuntCompensator
data type: Float
multiplicity: M:1..1
comment: Shunt compensator sections in use. Starting value for steady state solution. The attribute shall be a positive value or zero. Non integer values are allowed to support continuous variables. The reasons for continuous value are to support study cases where no discrete shunt compensators has yet been designed, a solutions where a narrow voltage band force the sections to oscillate or accommodate for a continuous solution as input. For LinearShuntConpensator the value shall be between zero and ShuntCompensator.maximumSections. At value zero the shunt compensator conductance and admittance is zero. Linear interpolation of conductance and admittance between the previous and next integer section is applied in case of non-integer values. For NonlinearShuntCompensator-s shall only be set to one of the NonlinearShuntCompenstorPoint.sectionNumber. There is no interpolation between NonlinearShuntCompenstorPoint-s.
type: Property

SolarGeneratingUnit
subclass of: GeneratingUnit
comment: A solar thermal generating unit, connected to the grid by means of a rotating machine. This class does not represent photovoltaic (PV) generation.
stereotype: Description
belongs to category: SteadyStateHypothesisProfile
stereotype: concrete
type: Class

StaticVarCompensator
subclass of: RegulatingCondEq
comment: A facility for providing variable and controllable shunt reactive power. The SVC typically consists of a stepdown transformer, filter, thyristor-controlled reactor, and thyristor-switched capacitor arms. The SVC may operate in fixed MVar output mode or in voltage control mode. When in voltage control mode, the output of the SVC will be proportional to the deviation of voltage at the controlled bus from the voltage setpoint. The SVC characteristic slope defines the proportion. If the voltage at the controlled bus is equal to the voltage setpoint, the SVC MVar output is zero.
stereotype: Description
belongs to category: SteadyStateHypothesisProfile
stereotype: concrete
type: Class

q
stereotype: attribute
domain: StaticVarCompensator
data type: ReactivePower
multiplicity: M:1..1
comment: Reactive power injection. Load sign convention is used, i.e. positive sign means flow out from a node. Starting value for a steady state solution.
type: Property

StationSupply
subclass of: EnergyConsumer
comment: Station supply with load derived from the station output.
stereotype: Description
belongs to category: SteadyStateHypothesisProfile
stereotype: concrete
type: Class

Switch
subclass of: ConductingEquipment
comment: A generic device designed to close, or open, or both, one or more electric circuits. All switches are two terminal devices including grounding switches. The ACDCTerminal.connected at the two sides of the switch shall not be considered for assessing switch connectivity, i.e. only Switch.open, .normalOpen and .locked are relevant.
stereotype: Description
belongs to category: SteadyStateHypothesisProfile
stereotype: concrete
type: Class

open
stereotype: attribute
domain: Switch
data type: Boolean
multiplicity: M:1..1
comment: The attribute tells if the switch is considered open when used as input to topology processing.
type: Property

locked
stereotype: attribute
domain: Switch
data type: Boolean
multiplicity: M:1..1
comment: If true, the switch is locked. The resulting switch state is a combination of locked and Switch.open attributes as follows: locked=true and Switch.open=true. The resulting state is open and locked; locked=false and Switch.open=true. The resulting state is open; locked=false and Switch.open=false. The resulting state is closed.
type: Property

SynchronousMachine
subclass of: RotatingMachine
comment: 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.
stereotype: Description
belongs to category: SteadyStateHypothesisProfile
stereotype: concrete
type: Class

operatingMode
stereotype: attribute
domain: SynchronousMachine
range: SynchronousMachineOperatingMode
multiplicity: M:1..1
comment: Current mode of operation.
type: Property

SynchronousMachineOperatingMode
comment: Synchronous machine operating mode.
belongs to category: SteadyStateHypothesisProfile
stereotype: enumeration
type: Class

generator
comment: Operating as generator.
stereotype: enum
type: SynchronousMachineOperatingMode

condenser
comment: Operating as condenser.
stereotype: enum
type: SynchronousMachineOperatingMode

motor
comment: Operating as motor.
stereotype: enum
type: SynchronousMachineOperatingMode

referencePriority
stereotype: attribute
domain: SynchronousMachine
data type: Integer
multiplicity: M:1..1
comment: Priority of unit for use as powerflow voltage phase angle reference bus selection. 0 = don t care (default) 1 = highest priority. 2 is less than 1 and so on.
type: Property

TapChanger
subclass of: PowerSystemResource
comment: Mechanism for changing transformer winding tap positions.
belongs to category: SteadyStateHypothesisProfile
type: Class

controlEnabled
stereotype: attribute
domain: TapChanger
data type: Boolean
multiplicity: M:1..1
comment: Specifies the regulation status of the equipment. True is regulating, false is not regulating.
type: Property

step
stereotype: attribute
domain: TapChanger
data type: Float
multiplicity: M:1..1
comment: Tap changer position. Starting step for a steady state solution. Non integer values are allowed to support continuous tap variables. The reasons for continuous value are to support study cases where no discrete tap changer has yet been designed, a solution where a narrow voltage band forces the tap step to oscillate or to accommodate for a continuous solution as input. The attribute shall be equal to or greater than lowStep and equal to or less than highStep.
type: Property

TapChangerControl
subclass of: RegulatingControl
comment: Describes behaviour specific to tap changers, e.g. how the voltage at the end of a line varies with the load level and compensation of the voltage drop by tap adjustment.
stereotype: Description
belongs to category: SteadyStateHypothesisProfile
stereotype: concrete
type: Class

Terminal
subclass of: ACDCTerminal
comment: An AC electrical connection point to a piece of conducting equipment. Terminals are connected at physical connection points called connectivity nodes.
stereotype: Description
belongs to category: SteadyStateHypothesisProfile
stereotype: concrete
type: Class

ThermalGeneratingUnit
subclass of: GeneratingUnit
comment: A generating unit whose prime mover could be a steam turbine, combustion turbine, or diesel engine.
stereotype: Description
belongs to category: SteadyStateHypothesisProfile
stereotype: concrete
type: Class

VoltageLimit
subclass of: OperationalLimit
comment: Operational limit applied to voltage. The use of operational VoltageLimit is preferred instead of limits defined at VoltageLevel. The operational VoltageLimits are used, if present.
stereotype: Description
belongs to category: SteadyStateHypothesisProfile
stereotype: concrete
type: Class

value
stereotype: attribute
domain: VoltageLimit
data type: Voltage
multiplicity: M:1..1
comment: Limit on voltage. High or low limit nature of the limit depends upon the properties of the operational limit type. The attribute shall be a positive value or zero.
type: Property

VsConverter
subclass of: ACDCConverter
comment: DC side of the voltage source converter (VSC).
stereotype: Description
belongs to category: SteadyStateHypothesisProfile
stereotype: concrete
type: Class

droop
stereotype: attribute
domain: VsConverter
data type: PU
multiplicity: M:0..1
comment: Droop constant. The pu value is obtained as D [kV/MW] x Sb / Ubdc. The attribute shall be a positive value.
type: Property

PU
comment: Per Unit - a positive or negative value referred to a defined base. Values typically range from -10 to +10.
stereotype: CIMDatatype
belongs to category: SteadyStateHypothesisProfile
type: Class

value
stereotype: attribute
domain: PU
data type: Float
multiplicity: M:0..1
type: Property

unit
stereotype: attribute
domain: PU
range: UnitSymbol
multiplicity: M:0..1
is fixed: none
type: Property

multiplier
stereotype: attribute
domain: PU
range: UnitMultiplier
multiplicity: M:0..1
is fixed: none
type: Property

droopCompensation
stereotype: attribute
domain: VsConverter
data type: Resistance
multiplicity: M:0..1
comment: Compensation constant. Used to compensate for voltage drop when controlling voltage at a distant bus. The attribute shall be a positive value.
type: Property

Resistance
comment: Resistance (real part of impedance).
stereotype: CIMDatatype
belongs to category: SteadyStateHypothesisProfile
type: Class

value
stereotype: attribute
domain: Resistance
data type: Float
multiplicity: M:0..1
type: Property

unit
stereotype: attribute
domain: Resistance
range: UnitSymbol
multiplicity: M:0..1
is fixed: ohm
type: Property

multiplier
stereotype: attribute
domain: Resistance
range: UnitMultiplier
multiplicity: M:0..1
is fixed: none
type: Property

pPccControl
stereotype: attribute
domain: VsConverter
range: VsPpccControlKind
multiplicity: M:1..1
comment: Kind of control of real power and/or DC voltage.
type: Property

VsPpccControlKind
comment: Types applicable to the control of real power and/or DC voltage by voltage source converter.
belongs to category: SteadyStateHypothesisProfile
stereotype: enumeration
type: Class

pPcc
comment: Control is real power at point of common coupling. The target value is provided by ACDCConverter.targetPpcc.
stereotype: enum
type: VsPpccControlKind

udc
comment: Control is DC voltage with target value provided by ACDCConverter.targetUdc.
stereotype: enum
type: VsPpccControlKind

pPccAndUdcDroop
comment: Control is active power at point of common coupling and local DC voltage, with the droop. Target values are provided by ACDCConverter.targetPpcc, ACDCConverter.targetUdc and VsConverter.droop.
stereotype: enum
type: VsPpccControlKind

pPccAndUdcDroopWithCompensation
comment: Control is active power at point of common coupling and compensated DC voltage, with the droop. Compensation factor is the resistance, as an approximation of the DC voltage of a common (real or virtual) node in the DC network. Targets are provided by ACDCConverter.targetPpcc, ACDCConverter.targetUdc, VsConverter.droop and VsConverter.droopCompensation.
stereotype: enum
type: VsPpccControlKind

pPccAndUdcDroopPilot
comment: Control is active power at point of common coupling and the pilot DC voltage, with the droop. The mode is used for Multi Terminal High Voltage DC (MTDC) systems where multiple HVDC Substations are connected to the HVDC transmission lines. The pilot voltage is then used to coordinate the control the DC voltage across the HVDC substations. Targets are provided by ACDCConverter.targetPpcc, ACDCConverter.targetUdc and VsConverter.droop.
stereotype: enum
type: VsPpccControlKind

phasePcc
comment: Control is phase at point of common coupling. Target is provided by VsConverter.targetPhasePcc.
stereotype: enum
type: VsPpccControlKind

qPccControl
stereotype: attribute
domain: VsConverter
range: VsQpccControlKind
multiplicity: M:1..1
comment: Kind of reactive power control.
type: Property

VsQpccControlKind
comment: Kind of reactive power control at point of common coupling for a voltage source converter.
belongs to category: SteadyStateHypothesisProfile
stereotype: enumeration
type: Class

reactivePcc
comment: Control is reactive power at point of common coupling. Target is provided by VsConverter.targetQpcc.
stereotype: enum
type: VsQpccControlKind

voltagePcc
comment: Control is voltage at point of common coupling. Target is provided by VsConverter.targetUpcc.
stereotype: enum
type: VsQpccControlKind

powerFactorPcc
comment: Control is power factor at point of common coupling. Target is provided by VsConverter.targetPowerFactorPcc.
stereotype: enum
type: VsQpccControlKind

pulseWidthModulation
comment: No explicit control. Pulse-modulation factor is directly set in magnitude (VsConverter.targetPWMfactor) and phase (VsConverter.targetPhasePcc).
stereotype: enum
type: VsQpccControlKind

qShare
stereotype: attribute
domain: VsConverter
data type: PerCent
multiplicity: M:0..1
comment: Reactive power sharing factor among parallel converters on Uac control. The attribute shall be a positive value or zero.
type: Property

PerCent
comment: Percentage on a defined base. For example, specify as 100 to indicate at the defined base.
stereotype: CIMDatatype
belongs to category: SteadyStateHypothesisProfile
type: Class

value
stereotype: attribute
domain: PerCent
data type: Float
multiplicity: M:0..1
comment: Normally 0 to 100 on a defined base.
type: Property

unit
stereotype: attribute
domain: PerCent
range: UnitSymbol
multiplicity: M:0..1
is fixed: none
type: Property

multiplier
stereotype: attribute
domain: PerCent
range: UnitMultiplier
multiplicity: M:0..1
is fixed: none
type: Property

targetQpcc
stereotype: attribute
domain: VsConverter
data type: ReactivePower
multiplicity: M:0..1
comment: Reactive power injection target in AC grid, at point of common coupling. Load sign convention is used, i.e. positive sign means flow out from a node.
type: Property

targetUpcc
stereotype: attribute
domain: VsConverter
data type: Voltage
multiplicity: M:0..1
comment: Voltage target in AC grid, at point of common coupling. The attribute shall be a positive value.
type: Property

targetPowerFactorPcc
stereotype: attribute
domain: VsConverter
data type: Float
multiplicity: M:0..1
comment: Power factor target at the AC side, at point of common coupling. The attribute shall be a positive value.
type: Property

targetPhasePcc
stereotype: attribute
domain: VsConverter
data type: AngleDegrees
multiplicity: M:0..1
comment: Phase target at AC side, at point of common coupling. The attribute shall be a positive value.
type: Property

targetPWMfactor
stereotype: attribute
domain: VsConverter
data type: Float
multiplicity: M:0..1
comment: Magnitude of pulse-modulation factor. The attribute shall be a positive value.
type: Property

WindGeneratingUnit
subclass of: GeneratingUnit
comment: A wind driven generating unit, connected to the grid by means of a rotating machine. May be used to represent a single turbine or an aggregation.
stereotype: Description
belongs to category: SteadyStateHypothesisProfile
stereotype: concrete
type: Class

Date
comment: 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".
stereotype: Primitive
belongs to category: SteadyStateHypothesisProfile
type: Class