vocabulary
ENTSO-E CIM EG
This vocabulary is describing the operation profile from IEC 61970-600-2.
ENTSO-E
Copyright
Operation Vocabulary
OperationProfile
This is the IEC 61970-452 operation profile.
Accumulator
Accumulator represents an accumulated (counted) Measurement, e.g. an energy value.
Measurement to which this value is connected.
AccumulatorValues
The values connected to this measurement.
Measurements
LimitSets
A measurement may have zero or more limit ranges defined for it.
AccumulatorLimit
Limit values for Accumulator measurements.
value
The value to supervise against. The value is positive.
Integer
An integer number. The range is unspecified and not limited.
LimitSet
Limits
The limit values used for supervision of Measurements.
AccumulatorLimitSet
An AccumulatorLimitSet specifies a set of Limits that are associated with an Accumulator measurement.
AccumulatorReset
This command resets the counter value to zero.
AccumulatorValue
The accumulator value that is reset by the command.
The command that resets the accumulator value.
AccumulatorValue represents an accumulated (counted) MeasurementValue.
ACDCTerminal
An electrical connection point (AC or DC) to a piece of conducting equipment. Terminals are connected at physical connection points called connectivity nodes.
Terminal
One or more measurements may be associated with a terminal in the network.
Measurements associated with this terminal defining where the measurement is placed in the network topology. It may be used, for instance, to capture the sensor position, such as a voltage transformer (PT) at a busbar or a current transformer (CT) at the bar between a breaker and an isolator.
Analog
Analog represents an analog Measurement.
positiveFlowIn
If true then this measurement is an active power, reactive power or current with the convention that a positive value measured at the Terminal means power is flowing into the related PowerSystemResource.
Boolean
A type with the value space "true" and "false".
AnalogValues
AnalogControl
An analog control used for supervisory control.
maxValue
Normal value range maximum for any of the Control.value. Used for scaling, e.g. in bar graphs.
Float
A floating point number. The range is unspecified and not limited.
minValue
Normal value range minimum for any of the Control.value. Used for scaling, e.g. in bar graphs.
AnalogValue
The MeasurementValue that is controlled.
The Control variable associated with the MeasurementValue.
AnalogLimit
AnalogLimitSet
An AnalogLimitSet specifies a set of Limits that are associated with an Analog measurement.
AnalogValue represents an analog MeasurementValue.
Command
A Command is a discrete control used for supervisory control.
normalValue
Normal value for Control.value e.g. used for percentage scaling.
The value representing the actuator output.
ValueAliasSet
The ValueAliasSet used for translation of a Control value to a name.
Commands
The Commands using the set for translation.
DiscreteValue
Control
Control is used for supervisory/device control. It represents control outputs that are used to change the state in a process, e.g. close or open breaker, a set point value or a raise lower command.
controlType
Specifies the type of Control. For example, this specifies if the Control represents BreakerOpen, BreakerClose, GeneratorVoltageSetPoint, GeneratorRaise, GeneratorLower, etc.
String
A string consisting of a sequence of characters. The character encoding is UTF-8. The string length is unspecified and unlimited.
operationInProgress
Indicates that a client is currently sending control commands that has not completed.
timeStamp
The last time a control output was sent.
DateTime
Date and time as "yyyy-mm-ddThh:mm:ss.sss", which conforms with ISO 8601. UTC time zone is specified as "yyyy-mm-ddThh:mm:ss.sssZ". A local timezone relative UTC is specified as "yyyy-mm-ddThh:mm:ss.sss-hh:mm". The second component (shown here as "ss.sss") could have any number of digits in its fractional part to allow any kind of precision beyond seconds.
unitMultiplier
The unit multiplier of the controlled quantity.
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".
micro
none
No multiplier or equivalently multiply by 1.
unitSymbol
The unit of measure of the controlled quantity.
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.
Dimension less quantity, e.g. count, per unit, etc.
Mass in kilograms. Note: multiplier “k” is included in this unit symbol for compatibility with IEC 61850-7-3.
mol
deg
rad
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.
ohm
Magnetic flux density in teslas (Wb/m2).
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.
Pressure in pascals (N/m²). Note: the absolute or relative measurement of pressure is implied with this entry. See below for more explicit forms.
mPers
mPers2
Acceleration in metres per second squared (m/s²).
m3Pers
Volumetric flow rate in cubic metres per second (m³/s).
mPerm3
Fuel efficiency in metres per cubic metres (m/m³).
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.
kgPerm3
Density in kilogram/cubic metres (kg/m³). Note: multiplier “k” is included in this unit symbol for compatibility with IEC 61850-7-3.
m2Pers
Viscosity in square metres / second (m²/s).
WPermK
Thermal conductivity in watt/metres kelvin.
JPerK
ppm
rotPers
Rotations per second (1/s). See also Hz (1/s).
radPers
Angular velocity in radians per second (rad/s).
WPerm2
Heat flux density, irradiance, watts per square metre.
JPerm2
Insulation energy density, joules per square metre or watt second per square metre.
SPerm
KPers
Temperature change rate in kelvins per second.
PaPers
Pressure change rate in pascals per second.
JPerkgK
Specific heat capacity, specific entropy, joules per kilogram Kelvin.
Apparent power in volt amperes. See also real power and reactive power.
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.
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.
A2s
Ampere squared time in square amperes (A²s).
VAh
VArh
Reactive energy in volt ampere reactive hours.
VPerHz
HzPers
Rate of change of frequency in hertz per second.
character
charPers
Data rate (baud) in characters per second.
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.
Sound pressure level in decibels. Note: multiplier “d” is included in this unit symbol for compatibility with IEC 61850-7-3.
WPers
lPers
Volumetric flow rate in litres per second.
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.
min
ohmm
APerm
A/m, magnetic field strength, amperes per metre.
V2h
A2h
Ampere-squared hour, ampere-squared hour.
count
ft3
m3Perh
Volumetric flow rate, cubic metres per hour.
gal
Volume in gallons, US gallon (1 gal = 231 in3 = 128 fl ounce).
Btu
Volume in litres, litre = dm3 = m3/1000.
lPerh
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’.
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’.
molPerm3
Concentration, The amount of substance concentration, (c), the amount of solvent in moles divided by the volume of solution in m³.
molPermol
Concentration, Molar fraction, the ratio of the molar amount of a solute divided by the molar amount of the solution.
molPerkg
Concentration, Molality, the amount of solute in moles and the amount of solvent in kilograms.
sPers
Time, Ratio of time. Note: Users may need to supply a prefix such as ‘µ’ to show rates such as ‘µs/s’.
HzPerHz
Frequency, rate of frequency change. Note: Users may need to supply a prefix such as ‘m’ to show rates such as ‘mHz/Hz’.
VPerV
Voltage, ratio of voltages. Note: Users may need to supply a prefix such as ‘m’ to show rates such as ‘mV/V’.
APerA
Current, ratio of amperages. Note: Users may need to supply a prefix such as ‘m’ to show rates such as ‘mA/A’.
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.
rev
kat
JPerkg
m3Uncompensated
Volume, cubic metres, with the value uncompensated for weather effects.
m3Compensated
Volume, cubic metres, with the value compensated for weather effects.
WPerW
Signal Strength, ratio of power. Note: Users may need to supply a prefix such as ‘m’ to show rates such as ‘mW/W’.
therm
onePerm
m3Perkg
Specific volume, cubic metres per kilogram, v.
Pas
NPerm
radPers2
Angular acceleration, radians per second squared.
JPerm3
VPerm
Electric field strength, volts per metre.
CPerm3
Electric charge density, coulombs per cubic metre.
CPerm2
Surface charge density, coulombs per square metre.
FPerm
HPerm
JPermol
JPermolK
Molar entropy, molar heat capacity, joules per mole kelvin.
CPerkg
Exposure (x rays), coulombs per kilogram.
GyPers
WPersr
WPerm2sr
Radiance, watts per square metre steradian.
katPerm3
Catalytic activity concentration, katals per cubic metre.
anglemin
anglesec
tonne
Mass in tons, “tonne” or “metric ton” (1000 kg = 1 Mg).
bar
mmHg
Pressure, millimetres of mercury (1 mmHg is approximately 133.3 Pa).
Magnetic flux, maxwells (1 Mx = 10-8 Wb).
Magnetic flux density, gausses (1 G = 10-4 T).
Magnetic field in oersteds, (1 Oe = (103/4p) A/m).
WPerA
Active power per current flow, watts per Ampere.
onePerHz
VPerVAr
ohmPerm
Electric resistance per length in ohms per metre ((V/A)/m).
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.
JPers
PowerSystemResource
Regulating device governed by this control output.
Controls
The controller outputs used to actually govern a regulating device, e.g. the magnetization of a synchronous machine or capacitor bank breaker actuator.
Discrete
Discrete represents a discrete Measurement, i.e. a Measurement representing discrete values, e.g. a Breaker position.
DiscreteValues
Discretes
The Measurements using the set for translation.
The ValueAliasSet used for translation of a MeasurementValue.value to a name.
DiscreteValue represents a discrete MeasurementValue.
IdentifiedObject
This is a root class to provide common identification for all classes needing identification and naming attributes.
description
The description is a free human readable text describing or naming the object. It may be non unique and may not correlate to a naming hierarchy.
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.
name
The name is any free human readable and possibly non unique text naming the object.
IOPoint
The class describe a measurement or control value. The purpose is to enable having attributes and associations common for measurement and control.
Limit
Specifies one limit value for a Measurement. A Measurement typically has several limits that are kept together by the LimitSet class. The actual meaning and use of a Limit instance (i.e., if it is an alarm or warning limit or if it is a high or low limit) is not captured in the Limit class. However the name of a Limit instance may indicate both meaning and use.
Specifies a set of Limits that are associated with a Measurement. A Measurement may have several LimitSets corresponding to seasonal or other changing conditions. The condition is captured in the name and description attributes. The same LimitSet may be used for several Measurements. In particular percentage limits are used this way.
isPercentageLimits
Tells if the limit values are in percentage of normalValue or the specified Unit for Measurements and Controls.
Measurement
A Measurement represents any measured, calculated or non-measured non-calculated quantity. Any piece of equipment may contain Measurements, e.g. a substation may have temperature measurements and door open indications, a transformer may have oil temperature and tank pressure measurements, a bay may contain a number of power flow measurements and a Breaker may contain a switch status measurement. The PSR - Measurement association is intended to capture this use of Measurement and is included in the naming hierarchy based on EquipmentContainer. The naming hierarchy typically has Measurements as leaves, e.g. Substation-VoltageLevel-Bay-Switch-Measurement. Some Measurements represent quantities related to a particular sensor location in the network, e.g. a voltage transformer (VT) or potential transformer (PT) at a busbar or a current transformer (CT) at the bar between a breaker and an isolator. The sensing position is not captured in the PSR - Measurement association. Instead it is captured by the Measurement - Terminal association that is used to define the sensing location in the network topology. The location is defined by the connection of the Terminal to ConductingEquipment. If both a Terminal and PSR are associated, and the PSR is of type ConductingEquipment, the associated Terminal should belong to that ConductingEquipment instance. When the sensor location is needed both Measurement-PSR and Measurement-Terminal are used. The Measurement-Terminal association is never used alone.
measurementType
Specifies the type of measurement. For example, this specifies if the measurement represents an indoor temperature, outdoor temperature, bus voltage, line flow, etc. When the measurementType is set to "Specialization", the type of Measurement is defined in more detail by the specialized class which inherits from Measurement.
phases
Indicates to which phases the measurement applies and avoids the need to use 'measurementType' to also encode phase information (which would explode the types). The phase information in Measurement, along with 'measurementType' and 'phases' uniquely defines a Measurement for a device, based on normal network phase. Their meaning will not change when the computed energizing phasing is changed due to jumpers or other reasons. If the attribute is missing three phases (ABC) shall be assumed.
PhaseCode
An unordered enumeration of phase identifiers. Allows designation of phases for both transmission and distribution equipment, circuits and loads. The enumeration, by itself, does not describe how the phases are connected together or connected to ground. Ground is not explicitly denoted as a phase. Residential and small commercial loads are often served from single-phase, or split-phase, secondary circuits. For the example of s12N, phases 1 and 2 refer to hot wires that are 180 degrees out of phase, while N refers to the neutral wire. Through single-phase transformer connections, these secondary circuits may be served from one or two of the primary phases A, B, and C. For three-phase loads, use the A, B, C phase codes instead of s12N. The integer values are from IEC 61968-9 to support revenue metering applications.
ABCN
ABC
ABN
ACN
BCN
s1N
s2N
s12N
s12
XYN
Two unknown non-neutral phases plus neutral.
The unit multiplier of the measured quantity.
The unit of measure of the measured quantity.
The power system resource that contains the measurement.
The measurements associated with this power system resource.
MeasurementValue
The current state for a measurement. A state value is an instance of a measurement from a specific source. Measurements can be associated with many state values, each representing a different source for the measurement.
The time when the value was last updated.
sensorAccuracy
The limit, expressed as a percentage of the sensor maximum, that errors will not exceed when the sensor is used under reference conditions.
PerCent
Percentage on a defined base. For example, specify as 100 to indicate at the defined base.
unit
multiplier
A MeasurementValue has a MeasurementValueQuality associated with it.
MeasurementValueQuality
MeasurementValueSource
A reference to the type of source that updates the MeasurementValue, e.g. SCADA, CCLink, manual, etc. User conventions for the names of sources are contained in the introduction to IEC 61970-301.
MeasurementValues
The MeasurementValues updated by the source.
Measurement quality flags. Bits 0-10 are defined for substation automation in IEC 61850-7-3. Bits 11-15 are reserved for future expansion by that document. Bits 16-31 are reserved for EMS applications.
MeasurementValueSource describes the alternative sources updating a MeasurementValue. User conventions for how to use the MeasurementValueSource attributes are defined in IEC 61970-301.
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.
Quality61850
Quality flags in this class are as defined in IEC 61850, except for estimatorReplaced, which has been included in this class for convenience.
badReference
Measurement value may be incorrect due to a reference being out of calibration.
estimatorReplaced
Value has been replaced by State Estimator. estimatorReplaced is not an IEC61850 quality bit but has been put in this class for convenience.
failure
This identifier indicates that a supervision function has detected an internal or external failure, e.g. communication failure.
oldData
Measurement value is old and possibly invalid, as it has not been successfully updated during a specified time interval.
operatorBlocked
Measurement value is blocked and hence unavailable for transmission.
oscillatory
To prevent some overload of the communication it is sensible to detect and suppress oscillating (fast changing) binary inputs. If a signal changes in a defined time twice in the same direction (from 0 to 1 or from 1 to 0) then oscillation is detected and the detail quality identifier "oscillatory" is set. If it is detected a configured numbers of transient changes could be passed by. In this time the validity status "questionable" is set. If after this defined numbers of changes the signal is still in the oscillating state the value shall be set either to the opposite state of the previous stable value or to a defined default value. In this case the validity status "questionable" is reset and "invalid" is set as long as the signal is oscillating. If it is configured such that no transient changes should be passed by then the validity status "invalid" is set immediately in addition to the detail quality identifier "oscillatory" (used for status information only).
outOfRange
Measurement value is beyond a predefined range of value.
overFlow
Measurement value is beyond the capability of being represented properly. For example, a counter value overflows from maximum count back to a value of zero.
source
Source gives information related to the origin of a value. The value may be acquired from the process, defaulted or substituted.
Source
Source gives information related to the origin of a value.
PROCESS
The value is provided by input from the process I/O or being calculated from some function.
DEFAULTED
SUBSTITUTED
The value is provided by input of an operator or by an automatic source.
suspect
A correlation function has detected that the value is not consistent with other values. Typically set by a network State Estimator.
test
Measurement value is transmitted for test purposes.
validity
Validity
GOOD
The value is marked good if no abnormal condition of the acquisition function or the information source is detected.
QUESTIONABLE
The value is marked questionable if a supervision function detects an abnormal behaviour, however the value could still be valid. The client is responsible for determining whether or not values marked "questionable" should be used.
INVALID
The value is marked invalid when a supervision function recognises abnormal conditions of the acquisition function or the information source (missing or non-operating updating devices). The value is not defined under this condition. The mark invalid is used to indicate to the client that the value may be incorrect and shall not be used.
RaiseLowerCommand
An analog control that increases or decreases a set point value with pulses. Unless otherwise specified, one pulse moves the set point by one.
RaiseLowerCommands
SetPoint
An analog control that issues a set point value.
StringMeasurement
StringMeasurement represents a measurement with values of type string.
StringMeasurementValues
StringMeasurementValue
StringMeasurementValue represents a measurement value of type string.
An AC electrical connection point to a piece of conducting equipment. Terminals are connected at physical connection points called connectivity nodes.
Describes the translation of a set of values into a name and is intendend to facilitate custom translations. Each ValueAliasSet has a name, description etc. A specific Measurement may represent a discrete state like Open, Closed, Intermediate etc. This requires a translation from the MeasurementValue.value number to a string, e.g. 0->"Invalid", 1->"Open", 2->"Closed", 3->"Intermediate". Each ValueToAlias member in ValueAliasSet.Value describe a mapping for one particular value to a name.
The ValueAliasSet having the ValueToAlias mappings.
Values
The ValueToAlias mappings included in the set.
ValueToAlias
Describes the translation of one particular value into a name, e.g. 1 as "Open".
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".