DL https://www.entsoe.eu/digital/cim/cim-for-grid-models-exchange/ vocabulary urn:iso:std:iec:61970-600-2:ed-1 urn:iso:std:iec:61970-301:ed-7:amd1 file://iec61970cim17v40_iec61968cim13v13a_iec62325cim03v17a.eap urn:iso:std:iec:61970-501:draft:ed-2 3.0.0 ENTSO-E CIM EG This vocabulary is describing the diagram layout profile from IEC 61970-453. 7b269643-3da3-4dd0-83e8-58d7f13ee3bc 2021-01-27T12:18:26Z en-GB 2020-10-12 ENTSO-E Copyright ENTSO-E 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, <i>OPC Unified Architecture</i>). 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. <ul> <li>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).</li> <li>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.</li> <li>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.</li> </ul> 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. enum 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. enum x1InitialView X coordinate of the first corner of the initial view. Float A floating point number. The range is unspecified and not limited. Primitive 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. Diagram A diagram object is part of a diagram. Yes DiagramElements A diagram is made up of multiple diagram objects. No Diagram A DiagramStyle can be used by many Diagrams. No DiagramStyle A Diagram may have a DiagramStyle. Yes 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. Primitive 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". Primitive 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 Measurement of angle in degrees. CIMDatatype value unit deg UnitSymbol The derived units defined for usage in the CIM. In some cases, the derived unit is equal to an SI unit. Whenever possible, the standard derived symbol is used instead of the formula for the derived unit. For example, the unit symbol Farad is defined as "F" instead of "CPerV". In cases where a standard symbol does not exist for a derived unit, the formula for the unit is used as the unit symbol. For example, density does not have a standard symbol and so it is represented as "kgPerm3". With the exception of the "kg", which is an SI unit, the unit symbols do not contain multipliers and therefore represent the base derived unit to which a multiplier can be applied as a whole. Every unit symbol is treated as an unparseable text as if it were a single-letter symbol. The meaning of each unit symbol is defined by the accompanying descriptive text and not by the text contents of the unit symbol. To allow the widest possible range of serializations without requiring special character handling, several substitutions are made which deviate from the format described in IEC 80000-1. The division symbol "/" is replaced by the letters "Per". Exponents are written in plain text after the unit as "m3" instead of being formatted as "m" with a superscript of 3 or introducing a symbol as in "m^3". The degree symbol "°" is replaced with the letters "deg". Any clarification of the meaning for a substitution is included in the description for the unit symbol. Non-SI units are included in list of unit symbols to allow sources of data to be correctly labelled with their non-SI units (for example, a GPS sensor that is reporting numbers that represent feet instead of meters). This allows software to use the unit symbol information correctly convert and scale the raw data of those sources into SI-based units. The integer values are used for harmonization with IEC 61850. none Dimension less quantity, e.g. count, per unit, etc. enum m Length in metres. enum kg Mass in kilograms. Note: multiplier “k” is included in this unit symbol for compatibility with IEC 61850-7-3. enum s Time in seconds. enum A Current in amperes. enum K Temperature in kelvins. enum mol Amount of substance in moles. enum cd Luminous intensity in candelas. enum deg Plane angle in degrees. enum rad Plane angle in radians (m/m). enum sr Solid angle in steradians (m2/m2). enum Gy Absorbed dose in grays (J/kg). enum Bq Radioactivity in becquerels (1/s). enum degC Relative temperature in degrees Celsius. In the SI unit system the symbol is °C. Electric charge is measured in coulomb that has the unit symbol C. To distinguish degree Celsius from coulomb the symbol used in the UML is degC. The reason for not using °C is that the special character ° is difficult to manage in software. enum Sv Dose equivalent in sieverts (J/kg). enum F Electric capacitance in farads (C/V). enum C Electric charge in coulombs (A·s). enum S Conductance in siemens. enum H Electric inductance in henrys (Wb/A). enum V Electric potential in volts (W/A). enum ohm Electric resistance in ohms (V/A). enum J Energy in joules (N·m = C·V = W·s). enum N Force in newtons (kg·m/s²). enum Hz Frequency in hertz (1/s). enum lx Illuminance in lux (lm/m²). enum lm Luminous flux in lumens (cd·sr). enum Wb Magnetic flux in webers (V·s). enum T Magnetic flux density in teslas (Wb/m2). enum W Real power in watts (J/s). Electrical power may have real and reactive components. The real portion of electrical power (I&#178;R or VIcos(phi)), is expressed in Watts. See also apparent power and reactive power. enum Pa Pressure in pascals (N/m²). Note: the absolute or relative measurement of pressure is implied with this entry. See below for more explicit forms. enum m2 Area in square metres (m²). enum m3 Volume in cubic metres (m³). enum mPers Velocity in metres per second (m/s). enum mPers2 Acceleration in metres per second squared (m/s²). enum m3Pers Volumetric flow rate in cubic metres per second (m³/s). enum mPerm3 Fuel efficiency in metres per cubic metres (m/m³). enum kgm Moment of mass in kilogram metres (kg·m) (first moment of mass). Note: multiplier “k” is included in this unit symbol for compatibility with IEC 61850-7-3. enum kgPerm3 Density in kilogram/cubic metres (kg/m³). Note: multiplier “k” is included in this unit symbol for compatibility with IEC 61850-7-3. enum m2Pers Viscosity in square metres / second (m²/s). enum WPermK Thermal conductivity in watt/metres kelvin. enum JPerK Heat capacity in joules/kelvin. enum ppm Concentration in parts per million. enum rotPers Rotations per second (1/s). See also Hz (1/s). enum radPers Angular velocity in radians per second (rad/s). enum WPerm2 Heat flux density, irradiance, watts per square metre. enum JPerm2 Insulation energy density, joules per square metre or watt second per square metre. enum SPerm Conductance per length (F/m). enum KPers Temperature change rate in kelvins per second. enum PaPers Pressure change rate in pascals per second. enum JPerkgK Specific heat capacity, specific entropy, joules per kilogram Kelvin. enum VA Apparent power in volt amperes. See also real power and reactive power. enum VAr Reactive power in volt amperes reactive. The “reactive” or “imaginary” component of electrical power (VIsin(phi)). (See also real power and apparent power). Note: Different meter designs use different methods to arrive at their results. Some meters may compute reactive power as an arithmetic value, while others compute the value vectorially. The data consumer should determine the method in use and the suitability of the measurement for the intended purpose. enum cosPhi Power factor, dimensionless. Note 1: This definition of power factor only holds for balanced systems. See the alternative definition under code 153. Note 2 : Beware of differing sign conventions in use between the IEC and EEI. It is assumed that the data consumer understands the type of meter in use and the sign convention in use by the utility. enum Vs Volt seconds (Ws/A). enum V2 Volt squared (W²/A²). enum As Ampere seconds (A·s). enum A2 Amperes squared (A²). enum A2s Ampere squared time in square amperes (A²s). enum VAh Apparent energy in volt ampere hours. enum Wh Real energy in watt hours. enum VArh Reactive energy in volt ampere reactive hours. enum VPerHz Magnetic flux in volt per hertz. enum HzPers Rate of change of frequency in hertz per second. enum character Number of characters. enum charPers Data rate (baud) in characters per second. enum kgm2 Moment of mass in kilogram square metres (kg·m²) (Second moment of mass, commonly called the moment of inertia). Note: multiplier “k” is included in this unit symbol for compatibility with IEC 61850-7-3. enum dB Sound pressure level in decibels. Note: multiplier “d” is included in this unit symbol for compatibility with IEC 61850-7-3. enum WPers Ramp rate in watts per second. enum lPers Volumetric flow rate in litres per second. enum dBm Power level (logarithmic ratio of signal strength , Bel-mW), normalized to 1mW. Note: multiplier “d” is included in this unit symbol for compatibility with IEC 61850-7-3. enum h Time in hours, hour = 60 min = 3600 s. enum min Time in minutes, minute = 60 s. enum Q Quantity power, Q. enum Qh Quantity energy, Qh. enum ohmm Resistivity, ohm metres, (rho). enum APerm A/m, magnetic field strength, amperes per metre. enum V2h Volt-squared hour, volt-squared-hours. enum A2h Ampere-squared hour, ampere-squared hour. enum Ah Ampere-hours, ampere-hours. enum count Amount of substance, Counter value. enum ft3 Volume, cubic feet. enum m3Perh Volumetric flow rate, cubic metres per hour. enum gal Volume in gallons, US gallon (1 gal = 231 in3 = 128 fl ounce). enum Btu Energy, British Thermal Units. enum l Volume in litres, litre = dm3 = m3/1000. enum lPerh Volumetric flow rate, litres per hour. enum lPerl Concentration, The ratio of the volume of a solute divided by the volume of the solution. Note: Users may need use a prefix such a ‘µ’ to express a quantity such as ‘µL/L’. enum gPerg Concentration, The ratio of the mass of a solute divided by the mass of the solution. Note: Users may need use a prefix such a ‘µ’ to express a quantity such as ‘µg/g’. enum molPerm3 Concentration, The amount of substance concentration, (c), the amount of solvent in moles divided by the volume of solution in m³. enum molPermol Concentration, Molar fraction, the ratio of the molar amount of a solute divided by the molar amount of the solution. enum molPerkg Concentration, Molality, the amount of solute in moles and the amount of solvent in kilograms. enum sPers Time, Ratio of time. Note: Users may need to supply a prefix such as ‘&#181;’ to show rates such as ‘&#181;s/s’. enum HzPerHz Frequency, rate of frequency change. Note: Users may need to supply a prefix such as ‘m’ to show rates such as ‘mHz/Hz’. enum VPerV Voltage, ratio of voltages. Note: Users may need to supply a prefix such as ‘m’ to show rates such as ‘mV/V’. enum APerA Current, ratio of amperages. Note: Users may need to supply a prefix such as ‘m’ to show rates such as ‘mA/A’. enum VPerVA Power factor, PF, the ratio of the active power to the apparent power. Note: The sign convention used for power factor will differ between IEC meters and EEI (ANSI) meters. It is assumed that the data consumers understand the type of meter being used and agree on the sign convention in use at any given utility. enum rev Amount of rotation, revolutions. enum kat Catalytic activity, katal = mol / s. enum JPerkg Specific energy, Joules / kg. enum m3Uncompensated Volume, cubic metres, with the value uncompensated for weather effects. enum m3Compensated Volume, cubic metres, with the value compensated for weather effects. enum WPerW Signal Strength, ratio of power. Note: Users may need to supply a prefix such as ‘m’ to show rates such as ‘mW/W’. enum therm Energy, therms. enum onePerm Wavenumber, reciprocal metres, (1/m). enum m3Perkg Specific volume, cubic metres per kilogram, v. enum Pas Dynamic viscosity, pascal seconds. enum Nm Moment of force, newton metres. enum NPerm Surface tension, newton per metre. enum radPers2 Angular acceleration, radians per second squared. enum JPerm3 Energy density, joules per cubic metre. enum VPerm Electric field strength, volts per metre. enum CPerm3 Electric charge density, coulombs per cubic metre. enum CPerm2 Surface charge density, coulombs per square metre. enum FPerm Permittivity, farads per metre. enum HPerm Permeability, henrys per metre. enum JPermol Molar energy, joules per mole. enum JPermolK Molar entropy, molar heat capacity, joules per mole kelvin. enum CPerkg Exposure (x rays), coulombs per kilogram. enum GyPers Absorbed dose rate, grays per second. enum WPersr Radiant intensity, watts per steradian. enum WPerm2sr Radiance, watts per square metre steradian. enum katPerm3 Catalytic activity concentration, katals per cubic metre. enum d Time in days, day = 24 h = 86400 s. enum anglemin Plane angle, minutes. enum anglesec Plane angle, seconds. enum ha Area, hectares. enum tonne Mass in tons, “tonne” or “metric ton” (1000 kg = 1 Mg). enum bar Pressure in bars, (1 bar = 100 kPa). enum mmHg Pressure, millimetres of mercury (1 mmHg is approximately 133.3 Pa). enum M Length, nautical miles (1 M = 1852 m). enum kn Speed, knots (1 kn = 1852/3600) m/s. enum Mx Magnetic flux, maxwells (1 Mx = 10-8 Wb). enum G Magnetic flux density, gausses (1 G = 10-4 T). enum Oe Magnetic field in oersteds, (1 Oe = (103/4p) A/m). enum Vh Volt-hour, Volt hours. enum WPerA Active power per current flow, watts per Ampere. enum onePerHz Reciprocal of frequency (1/Hz). enum VPerVAr Power factor, PF, the ratio of the active power to the apparent power. Note: The sign convention used for power factor will differ between IEC meters and EEI (ANSI) meters. It is assumed that the data consumers understand the type of meter being used and agree on the sign convention in use at any given utility. enum ohmPerm Electric resistance per length in ohms per metre ((V/A)/m). enum kgPerJ Weight per energy in kilograms per joule (kg/J). Note: multiplier “k” is included in this unit symbol for compatibility with IEC 61850-7-3. enum JPers Energy rate in joules per second (J/s). enum multiplier none UnitMultiplier The unit multipliers defined for the CIM. When applied to unit symbols, the unit symbol is treated as a derived unit. Regardless of the contents of the unit symbol text, the unit symbol shall be treated as if it were a single-character unit symbol. Unit symbols should not contain multipliers, and it should be left to the multiplier to define the multiple for an entire data type. For example, if a unit symbol is "m2Pers" and the multiplier is "k", then the value is k(m**2/s), and the multiplier applies to the entire final value, not to any individual part of the value. This can be conceptualized by substituting a derived unit symbol for the unit type. If one imagines that the symbol "Þ" represents the derived unit "m2Pers", then applying the multiplier "k" can be conceptualized simply as "kÞ". For example, the SI unit for mass is "kg" and not "g". If the unit symbol is defined as "kg", then the multiplier is applied to "kg" as a whole and does not replace the "k" in front of the "g". In this case, the multiplier of "m" would be used with the unit symbol of "kg" to represent one gram. As a text string, this violates the instructions in IEC 80000-1. However, because the unit symbol in CIM is treated as a derived unit instead of as an SI unit, it makes more sense to conceptualize the "kg" as if it were replaced by one of the proposed replacements for the SI mass symbol. If one imagines that the "kg" were replaced by a symbol "Þ", then it is easier to conceptualize the multiplier "m" as creating the proper unit "mÞ", and not the forbidden unit "mkg". y Yocto 10**-24. enum z Zepto 10**-21. enum a Atto 10**-18. enum f Femto 10**-15. enum p Pico 10**-12. enum n Nano 10**-9. enum micro Micro 10**-6. enum m Milli 10**-3. enum c Centi 10**-2. enum d Deci 10**-1. enum none No multiplier or equivalently multiply by 1. enum da Deca 10**1. enum h Hecto 10**2. enum k Kilo 10**3. enum M Mega 10**6. enum G Giga 10**9. enum T Tera 10**12. enum P Peta 10**15. enum E Exa 10**18. enum Z Zetta 10**21. enum Y Yotta 10**24. enum DiagramObjects The diagram objects that are associated with the domain object. No IdentifiedObject The domain object to which this diagram object is associated. Yes DiagramObjectPoints A diagram object can have 0 or more points to reflect its layout position, routing (for polylines) or boundary (for polygons). No DiagramObject The diagram object with which the points are associated. Yes VisibilityLayers A diagram object can be part of multiple visibility layers. No VisibleObjects A visibility layer can contain one or more diagram objects. Yes DiagramObjectStyle A diagram object has a style associated that provides a reference for the style used in the originating system. Yes StyledObjects A style can be assigned to multiple diagram objects. No 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. DiagramObjectPoints A diagram object glue point is associated with 2 or more object points that are considered to be 'glued' together. No DiagramObjectGluePoint The 'glue' point to which this point is associated. Yes 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 The X coordinate of this point. yPosition The Y coordinate of this point. zPosition The Z coordinate of this point. DiagramObjectStyle 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. DiagramStyle 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. IdentifiedObject This is a root class to provide common identification for all classes needing identification and naming attributes. mRID Master resource identifier issued by a model authority. The mRID is unique within an exchange context. Global uniqueness is easily achieved by using a UUID, as specified in RFC 4122, for the mRID. The use of UUID is strongly recommended. For CIMXML data files in RDF syntax conforming to IEC 61970-552, the mRID is mapped to rdf:ID or rdf:about attributes that identify CIM object elements. String A string consisting of a sequence of characters. The character encoding is UTF-8. The string length is unspecified and unlimited. Primitive 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. drawingOrder 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". Primitive