vocabulary
ENTSO-E CIM EG
This vocabulary is describing the diagram layout profile from IEC 61970-453.
ENTSO-E
Copyright
Diagram Layout Vocabulary
DiagramLayoutProfile
This standard specifies an exchange profile for schematics with the following characteristics. A generic method for linking the diagram object to the domain data. Domain data and diagram layout data can be exchanged together with the domain data, or separately from each other with the assumption that domain data will have already been imported should diagram layout data be imported separately. It does not require or imply a specific domain data format. Therefore, it supports domain data modelled according to the IEC 61970-301 Common information model (CIM) that is exchanged in the IEC 61970-501 format (CIM RDF schema). Diagram layout data references domain data in compliance with IEC/TR 62541-1, OPC Unified Architecture). The intended usage of this standard is that the source of a diagram will use the standard to encode the layout of their diagram as they created it. It is then incumbent upon any receiver to supply the means of using that diagram layout in their system. In the simplest situation, if the source uses Switch object placements, the receiver creates a generic Switch template in the receiver's system that will be used to render Switches (i.e. there is no exchange of Switch templates). In more complex situations, a 1:1 correspondence may not be desirable, and receivers may have to create generic transformations in order to use exchanges. However, in both situations, it is expected that once an investment is made in a strategy for rendering, repeated imports may be carried out automatically. Supports the exchange of diagram objects that have no relationship to domain data, i.e., pure static background objects. Supports multiple representations of the same domain object in the same or different diagrams. Allows the diagram to be used as the unit of exchange, providing a straightforward approach to partial exchange, or an exchange between systems that have a separate model and repository for diagram layout data. Supports assignment of diagram objects to layers or other means, for showing or hiding information based on zoom level and/or user interest. A generic method for proprietary extensions to enable full round tripping (export and import back into the same system) without information loss within a system, and without breaking the standard exchange format.
Diagram
The diagram being exchanged. The coordinate system is a standard Cartesian coordinate system and the orientation attribute defines the orientation. The initial view related attributes can be used to specify an initial view with the x,y coordinates of the diagonal points.
orientation
Coordinate system orientation of the diagram. A positive orientation gives standard “right-hand” orientation, with negative orientation indicating a “left-hand” orientation. For 2D diagrams, a positive orientation will result in X values increasing from left to right and Y values increasing from bottom to top. A negative orientation gives the “left-hand” orientation (favoured by computer graphics displays) with X values increasing from left to right and Y values increasing from top to bottom.
OrientationKind
The orientation of the coordinate system with respect to top, left, and the coordinate number system.
positive
For 2D diagrams, a positive orientation will result in X values increasing from left to right and Y values increasing from bottom to top. This is also known as a right hand orientation.
negative
For 2D diagrams, a negative orientation gives the left-hand orientation (favoured by computer graphics displays) with X values increasing from left to right and Y values increasing from top to bottom. This is also known as a left hand orientation.
x1InitialView
X coordinate of the first corner of the initial view.
Float
A floating point number. The range is unspecified and not limited.
x2InitialView
X coordinate of the second corner of the initial view.
y1InitialView
Y coordinate of the first corner of the initial view.
y2InitialView
Y coordinate of the second corner of the initial view.
DiagramElements
A diagram is made up of multiple diagram objects.
A DiagramStyle can be used by many Diagrams.
DiagramStyle
DiagramObject
An object that defines one or more points in a given space. This object can be associated with anything that specializes IdentifiedObject. For single line diagrams such objects typically include such items as analog values, breakers, disconnectors, power transformers, and transmission lines.
drawingOrder
The drawing order of this element. The higher the number, the later the element is drawn in sequence. This is used to ensure that elements that overlap are rendered in the correct order.
Integer
An integer number. The range is unspecified and not limited.
isPolygon
Defines whether or not the diagram objects points define the boundaries of a polygon or the routing of a polyline. If this value is true then a receiving application should consider the first and last points to be connected.
Boolean
A type with the value space "true" and "false".
offsetX
The offset in the X direction. This is used for defining the offset from centre for rendering an icon (the default is that a single point specifies the centre of the icon). The offset is in per-unit with 0 indicating there is no offset from the horizontal centre of the icon. -0.5 indicates it is offset by 50% to the left and 0.5 indicates an offset of 50% to the right.
offsetY
The offset in the Y direction. This is used for defining the offset from centre for rendering an icon (the default is that a single point specifies the centre of the icon). The offset is in per-unit with 0 indicating there is no offset from the vertical centre of the icon. The offset direction is dependent on the orientation of the diagram, with -0.5 and 0.5 indicating an offset of +/- 50% on the vertical axis.
rotation
Sets the angle of rotation of the diagram object. Zero degrees is pointing to the top of the diagram. Rotation is clockwise. DiagramObject.rotation=0 has the following meaning: The connection point of an element which has one terminal is pointing to the top side of the diagram. The connection point "From side" of an element which has more than one terminal is pointing to the top side of the diagram. DiagramObject.rotation=90 has the following meaning: The connection point of an element which has one terminal is pointing to the right hand side of the diagram. The connection point "From side" of an element which has more than one terminal is pointing to the right hand side of the diagram.
AngleDegrees
value
unit
UnitSymbol
The derived units defined for usage in the CIM. In some cases, the derived unit is equal to an SI unit. Whenever possible, the standard derived symbol is used instead of the formula for the derived unit. For example, the unit symbol Farad is defined as "F" instead of "CPerV". In cases where a standard symbol does not exist for a derived unit, the formula for the unit is used as the unit symbol. For example, density does not have a standard symbol and so it is represented as "kgPerm3". With the exception of the "kg", which is an SI unit, the unit symbols do not contain multipliers and therefore represent the base derived unit to which a multiplier can be applied as a whole. Every unit symbol is treated as an unparseable text as if it were a single-letter symbol. The meaning of each unit symbol is defined by the accompanying descriptive text and not by the text contents of the unit symbol. To allow the widest possible range of serializations without requiring special character handling, several substitutions are made which deviate from the format described in IEC 80000-1. The division symbol "/" is replaced by the letters "Per". Exponents are written in plain text after the unit as "m3" instead of being formatted as "m" with a superscript of 3 or introducing a symbol as in "m^3". The degree symbol "°" is replaced with the letters "deg". Any clarification of the meaning for a substitution is included in the description for the unit symbol. Non-SI units are included in list of unit symbols to allow sources of data to be correctly labelled with their non-SI units (for example, a GPS sensor that is reporting numbers that represent feet instead of meters). This allows software to use the unit symbol information correctly convert and scale the raw data of those sources into SI-based units. The integer values are used for harmonization with IEC 61850.
none
Dimension less quantity, e.g. count, per unit, etc.
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
multiplier
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
No multiplier or equivalently multiply by 1.
DiagramObjects
The diagram objects that are associated with the domain object.
IdentifiedObject
The domain object to which this diagram object is associated.
DiagramObjectPoints
A diagram object can have 0 or more points to reflect its layout position, routing (for polylines) or boundary (for polygons).
The diagram object with which the points are associated.
VisibilityLayers
A diagram object can be part of multiple visibility layers.
VisibleObjects
A visibility layer can contain one or more diagram objects.
DiagramObjectStyle
A diagram object has a style associated that provides a reference for the style used in the originating system.
StyledObjects
A style can be assigned to multiple diagram objects.
DiagramObjectGluePoint
This is used for grouping diagram object points from different diagram objects that are considered to be glued together in a diagram even if they are not at the exact same coordinates.
A diagram object glue point is associated with 2 or more object points that are considered to be 'glued' together.
The 'glue' point to which this point is associated.
DiagramObjectPoint
A point in a given space defined by 3 coordinates and associated to a diagram object. The coordinates may be positive or negative as the origin does not have to be in the corner of a diagram.
sequenceNumber
The sequence position of the point, used for defining the order of points for diagram objects acting as a polyline or polygon with more than one point. The attribute shall be a positive value.
xPosition
yPosition
zPosition
A reference to a style used by the originating system for a diagram object. A diagram object style describes information such as line thickness, shape such as circle or rectangle etc, and colour.
The diagram style refers to a style used by the originating system for a diagram. A diagram style describes information such as schematic, geographic, etc.
This is a root class to provide common identification for all classes needing identification and naming attributes.
mRID
Master resource identifier issued by a model authority. The mRID is unique within an exchange context. Global uniqueness is easily achieved by using a UUID, as specified in RFC 4122, for the mRID. The use of UUID is strongly recommended. For CIMXML data files in RDF syntax conforming to IEC 61970-552, the mRID is mapped to rdf:ID or rdf:about attributes that identify CIM object elements.
String
A string consisting of a sequence of characters. The character encoding is UTF-8. The string length is unspecified and unlimited.
name
The name is any free human readable and possibly non unique text naming the object.
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.
TextDiagramObject
A diagram object for placing free-text or text derived from an associated domain object.
text
The text that is displayed by this text diagram object.
VisibilityLayer
Layers are typically used for grouping diagram objects according to themes and scales. Themes are used to display or hide certain information (e.g., lakes, borders), while scales are used for hiding or displaying information depending on the current zoom level (hide text when it is too small to be read, or when it exceeds the screen size). This is also called de-cluttering. CIM based graphics exchange supports an m:n relationship between diagram objects and layers. The importing system shall convert an m:n case into an appropriate 1:n representation if the importing system does not support m:n.
The drawing order for this layer. The higher the number, the later the layer and the objects within it are rendered.
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".