EQ 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 core equipment profile from IEC 61970-600-2. 9fd00587-84d4-4910-bbd4-e003ed7e0821 2021-01-27T12:09:21Z en-GB 2020-10-12 ENTSO-E Copyright ENTSO-E Core Equipment Vocabulary CoreEquipmentProfile This is the IEC 61970-452 core equipment profile. ACDCConverter 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. baseS Base apparent power of the converter pole. The attribute shall be a positive value. ApparentPower Product of the RMS value of the voltage and the RMS value of the current. CIMDatatype value Float A floating point number. The range is unspecified and not limited. Primitive multiplier M 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 unit VA 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 idleLoss Active power loss in pole at no power transfer. It is converter’s configuration data used in power flow. The attribute shall be a positive value. ActivePower Product of RMS value of the voltage and the RMS value of the in-phase component of the current. CIMDatatype value multiplier M unit W maxUdc The maximum voltage on the DC side at which the converter should operate. It is converter’s configuration data used in power flow. The attribute shall be a positive value. Voltage Electrical voltage, can be both AC and DC. CIMDatatype value multiplier k unit V minUdc The minimum voltage on the DC side at which the converter should operate. It is converter’s configuration data used in power flow. The attribute shall be a positive value. numberOfValves Number of valves in the converter. Used in loss calculations. Integer An integer number. The range is unspecified and not limited. Primitive ratedUdc Rated converter DC voltage, also called UdN. The attribute shall be a positive value. It is converter’s configuration data used in power flow. For instance a bipolar HVDC link with value 200 kV has a 400kV difference between the dc lines. resistiveLoss It is converter’s configuration data used in power flow. Refer to poleLossP. The attribute shall be a positive value. Resistance Resistance (real part of impedance). CIMDatatype value unit ohm multiplier none switchingLoss Switching losses, relative to the base apparent power 'baseS'. Refer to poleLossP. The attribute shall be a positive value. ActivePowerPerCurrentFlow Active power variation with current flow. CIMDatatype multiplier M unit WPerA value valveU0 Valve threshold voltage, also called Uvalve. Forward voltage drop when the valve is conducting. Used in loss calculations, i.e. the switchLoss depend on numberOfValves * valveU0. maxP Maximum active power limit. The value is overwritten by values of VsCapabilityCurve, if present. minP Minimum active power limit. The value is overwritten by values of VsCapabilityCurve, if present. ConverterDCSides All converters' DC sides linked to this point of common coupling terminal. No PccTerminal Point of common coupling terminal for this converter DC side. It is typically the terminal on the power transformer (or switch) closest to the AC network. Yes DCConductingEquipment A DC converter terminal belong to an DC converter. Yes DCTerminals A DC converter have DC converter terminals. A converter has two DC converter terminals. No ACDCConverterDCTerminal 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. polarity Represents the normal network polarity condition. Depending on the converter configuration the value shall be set as follows: - For a monopole with two converter terminals use DCPolarityKind “positive” and “negative”. - For a bi-pole or symmetric monopole with three converter terminals use DCPolarityKind “positive”, “middle” and “negative”. DCPolarityKind Polarity for DC circuits. positive Positive pole. The converter terminal is intended to operate at a positive voltage relative the midpoint or negative terminal. enum middle Middle pole. The converter terminal is the midpoint in a bipolar or symmetric monopole configuration. The midpoint can be grounded and/or have a metallic return. enum negative Negative pole. The converter terminal is intended to operate at a negative voltage relative the midpoint or positive terminal. enum ACDCTerminal An electrical connection point (AC or DC) to a piece of conducting equipment. Terminals are connected at physical connection points called connectivity nodes. sequenceNumber The orientation of the terminal connections for a multiple terminal conducting equipment. The sequence numbering starts with 1 and additional terminals should follow in increasing order. The first terminal is the "starting point" for a two terminal branch. Terminal The terminal where the operational limit set apply. Yes OperationalLimitSet The operational limit sets at the terminal. No Terminal The terminals associated with this bus name marker. No BusNameMarker The bus name marker used to name the bus (topological node). Yes ACLineSegment A wire or combination of wires, with consistent electrical characteristics, building a single electrical system, used to carry alternating current between points in the power system. For symmetrical, transposed three phase lines, it is sufficient to use attributes of the line segment, which describe impedances and admittances for the entire length of the segment. Additionally impedances can be computed by using length and associated per length impedances. The BaseVoltage at the two ends of ACLineSegments in a Line shall have the same BaseVoltage.nominalVoltage. However, boundary lines may have slightly different BaseVoltage.nominalVoltages and variation is allowed. Larger voltage difference in general requires use of an equivalent branch. bch Positive sequence shunt (charging) susceptance, uniformly distributed, of the entire line section. This value represents the full charging over the full length of the line. Susceptance Imaginary part of admittance. CIMDatatype value unit S multiplier none gch Positive sequence shunt (charging) conductance, uniformly distributed, of the entire line section. Conductance Factor by which voltage must be multiplied to give corresponding power lost from a circuit. Real part of admittance. CIMDatatype value unit S multiplier none r Positive sequence series resistance of the entire line section. x Positive sequence series reactance of the entire line section. Reactance Reactance (imaginary part of impedance), at rated frequency. CIMDatatype value unit ohm multiplier none ACLineSegment The line segment to which the clamp is connected. Yes Clamp The clamps connected to the line segment. No ACLineSegment The line segment to which the cut is applied. Yes Cut Cuts applied to the line segment. No ActivePowerLimit Limit on active power flow. normalValue The normal value of active power limit. The attribute shall be a positive value or zero. ApparentPowerLimit Apparent power limit. normalValue The normal apparent power limit. The attribute shall be a positive value or zero. AsynchronousMachine A rotating machine whose shaft rotates asynchronously with the electrical field. Also known as an induction machine with no external connection to the rotor windings, e.g. squirrel-cage induction machine. nominalFrequency Nameplate data indicates if the machine is 50 Hz or 60 Hz. Frequency Cycles per second. CIMDatatype value unit Hz multiplier none nominalSpeed Nameplate data. Depends on the slip and number of pole pairs. RotationSpeed Number of revolutions per second. CIMDatatype multiplier none unit Hz value AuxiliaryEquipment AuxiliaryEquipment describe equipment that is not performing any primary functions but support for the equipment performing the primary function. AuxiliaryEquipment is attached to primary equipment via an association with Terminal. Terminal The Terminal at the equipment where the AuxiliaryEquipment is attached. Yes AuxiliaryEquipment The auxiliary equipment connected to the terminal. No BaseVoltage Defines a system base voltage which is referenced. nominalVoltage The power system resource's base voltage. Shall be a positive value and not zero. BaseVoltage Base voltage of this conducting equipment. Use only when there is no voltage level container used and only one base voltage applies. For example, not used for transformers. Yes ConductingEquipment All conducting equipment with this base voltage. Use only when there is no voltage level container used and only one base voltage applies. For example, not used for transformers. No BaseVoltage The base voltage used for all equipment within the voltage level. Yes VoltageLevel The voltage levels having this base voltage. No BaseVoltage Base voltage of the transformer end. This is essential for PU calculation. Yes TransformerEnds Transformer ends at the base voltage. This is essential for PU calculation. No BasicIntervalSchedule Schedule of values at points in time. startTime The time for the first time point. The value can be a time of day, not a specific date. 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. Primitive value1Unit Value1 units of measure. value2Unit Value2 units of measure. BatteryUnit An electrochemical energy storage device. ratedE Full energy storage capacity of the battery. The attribute shall be a positive value. RealEnergy Real electrical energy. CIMDatatype multiplier M unit Wh value Bay A collection of power system resources (within a given substation) including conducting equipment, protection relays, measurements, and telemetry. A bay typically represents a physical grouping related to modularization of equipment. Bays The bays within this voltage level. No VoltageLevel The voltage level containing this bay. Yes BoundaryPoint Designates a connection point at which one or more model authority sets shall connect to. The location of the connection point as well as other properties are agreed between organisations responsible for the interconnection, hence all attributes of the class represent this agreement. It is primarily used in a boundary model authority set which can contain one or many BoundaryPoint-s among other Equipment-s and their connections. European fromEndIsoCode European The ISO code of the region which the "From" side of the Boundary point belongs to or it is connected to. The ISO code is a two-character country code as defined by ISO 3166 (http://www.iso.org/iso/country_codes). The length of the string is 2 characters maximum. String A string consisting of a sequence of characters. The character encoding is UTF-8. The string length is unspecified and unlimited. Primitive fromEndName European A human readable name with length of the string 64 characters maximum. It covers the following two cases: -if the Boundary point is placed on a tie-line, it is the name (IdentifiedObject.name) of the substation at which the "From" side of the tie-line is connected to. -if the Boundary point is placed in a substation, it is the name (IdentifiedObject.name) of the element (e.g. PowerTransformer, ACLineSegment, Switch, etc.) at which the "From" side of the Boundary point is connected to. fromEndNameTso European Identifies the name of the transmission system operator, distribution system operator or other entity at which the "From" side of the interconnection is connected to. The length of the string is 64 characters maximum. toEndIsoCode European The ISO code of the region which the "To" side of the Boundary point belongs to or is connected to. The ISO code is a two-character country code as defined by ISO 3166 (http://www.iso.org/iso/country_codes). The length of the string is 2 characters maximum. toEndName European A human readable name with length of the string 64 characters maximum. It covers the following two cases: -if the Boundary point is placed on a tie-line, it is the name (IdentifiedObject.name) of the substation at which the "To" side of the tie-line is connected to. -if the Boundary point is placed in a substation, it is the name (IdentifiedObject.name) of the element (e.g. PowerTransformer, ACLineSegment, Switch, etc.) at which the "To" side of the Boundary point is connected to. toEndNameTso European Identifies the name of the transmission system operator, distribution system operator or other entity at which the "To" side of the interconnection is connected to. The length of the string is 64 characters maximum. isDirectCurrent European If true, this boundary point is a point of common coupling (PCC) of a direct current (DC) interconnection, otherwise the interconnection is AC (default). Boolean A type with the value space "true" and "false". Primitive isExcludedFromAreaInterchange European If true, this boundary point is on the interconnection that is excluded from control area interchange calculation and consequently has no related tie flows. Otherwise, the interconnection is included in control area interchange and a TieFlow is required at all sides of the boundary point (default). ConnectivityNode The connectivity node that is designated as a boundary point. Yes European BoundaryPoint The boundary point associated with the connectivity node. No European Breaker 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. BusbarSection A conductor, or group of conductors, with negligible impedance, that serve to connect other conducting equipment within a single substation. Voltage measurements are typically obtained from voltage transformers that are connected to busbar sections. A bus bar section may have many physical terminals but for analysis is modelled with exactly one logical terminal. BusNameMarker Used to apply user standard names to TopologicalNodes. Associated with one or more terminals that are normally connected with the bus name. The associated terminals are normally connected by non-retained switches. For a ring bus station configuration, all BusbarSection terminals in the ring are typically associated. For a breaker and a half scheme, both BusbarSections would normally be associated. For a ring bus, all BusbarSections would normally be associated. For a "straight" busbar configuration, normally only the main terminal at the BusbarSection would be associated. priority Priority of bus name marker for use as topology bus name. Use 0 for do not care. Use 1 for highest priority. Use 2 as priority is less than 1 and so on. BusNameMarker The bus name markers that belong to this reporting group. No ReportingGroup The reporting group to which this bus name marker belongs. Yes CAESPlant Compressed air energy storage plant. CAESPlant A thermal generating unit may be a member of a compressed air energy storage plant. Yes ThermalGeneratingUnit A thermal generating unit may be a member of a compressed air energy storage plant. No Clamp A Clamp is a galvanic connection at a line segment where other equipment is connected. A Clamp does not cut the line segment. A Clamp is ConductingEquipment and has one Terminal with an associated ConnectivityNode. Any other ConductingEquipment can be connected to the Clamp ConnectivityNode. lengthFromTerminal1 The length to the place where the clamp is located starting from side one of the line segment, i.e. the line segment terminal with sequence number equal to 1. Length Unit of length. It shall be a positive value or zero. CIMDatatype value unit m multiplier k ConformLoadSchedule A curve of load versus time (X-axis) showing the active power values (Y1-axis) and reactive power (Y2-axis) for each unit of the period covered. This curve represents a typical pattern of load over the time period for a given day type and season. ConformLoadSchedules The ConformLoadSchedules in the ConformLoadGroup. No ConformLoadGroup The ConformLoadGroup where the ConformLoadSchedule belongs. Yes CogenerationPlant A set of thermal generating units for the production of electrical energy and process steam (usually from the output of the steam turbines). The steam sendout is typically used for industrial purposes or for municipal heating and cooling. CogenerationPlant A thermal generating unit may be a member of a cogeneration plant. Yes ThermalGeneratingUnits A thermal generating unit may be a member of a cogeneration plant. No CombinedCyclePlant A set of combustion turbines and steam turbines where the exhaust heat from the combustion turbines is recovered to make steam for the steam turbines, resulting in greater overall plant efficiency. CombinedCyclePlant A thermal generating unit may be a member of a combined cycle plant. Yes ThermalGeneratingUnits A thermal generating unit may be a member of a combined cycle plant. No ConductingEquipment The parts of the AC power system that are designed to carry current or that are conductively connected through terminals. ConductingEquipment The conducting equipment of the terminal. Conducting equipment have terminals that may be connected to other conducting equipment terminals via connectivity nodes or topological nodes. Yes Terminals Conducting equipment have terminals that may be connected to other conducting equipment terminals via connectivity nodes or topological nodes. No Conductor Combination of conducting material with consistent electrical characteristics, building a single electrical system, used to carry current between points in the power system. length Segment length for calculating line section capabilities. ConformLoad ConformLoad represent loads that follow a daily load change pattern where the pattern can be used to scale the load with a system load. EnergyConsumers Conform loads assigned to this ConformLoadGroup. No LoadGroup Group of this ConformLoad. Yes ConformLoadGroup A group of loads conforming to an allocation pattern. ConnectivityNode Connectivity nodes are points where terminals of AC conducting equipment are connected together with zero impedance. Terminals Terminals interconnected with zero impedance at a this connectivity node. No ConnectivityNode The connectivity node to which this terminal connects with zero impedance. Yes ConnectivityNodeContainer Container of this connectivity node. Yes ConnectivityNodes Connectivity nodes which belong to this connectivity node container. No ConnectivityNodeContainer A base class for all objects that may contain connectivity nodes or topological nodes. Connector A conductor, or group of conductors, with negligible impedance, that serve to connect other conducting equipment within a single substation and are modelled with a single logical terminal. ControlArea 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. type The primary type of control area definition used to determine if this is used for automatic generation control, for planning interchange control, or other purposes. A control area specified with primary type of automatic generation control could still be forecast and used as an interchange area in power flow analysis. ControlAreaTypeKind The type of control area. AGC Used for automatic generation control. enum Forecast Used for load forecast. enum Interchange Used for interchange specification or control. enum ControlArea The control area of the tie flows. Yes TieFlow The tie flows associated with the control area. No ControlArea The parent control area for the generating unit specifications. Yes ControlAreaGeneratingUnit The generating unit specifications for the control area. No ControlArea The control area specification that is used for the load forecast. No EnergyArea The energy area that is forecast from this control area specification. Yes ControlAreaGeneratingUnit A control area generating unit. This class is needed so that alternate control area definitions may include the same generating unit. It should be noted that only one instance within a control area should reference a specific generating unit. GeneratingUnit The generating unit specified for this control area. Note that a control area should include a GeneratingUnit only once. Yes ControlAreaGeneratingUnit ControlArea specifications for this generating unit. No CsConverter 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. maxAlpha Maximum firing angle. It is converter’s configuration data used in power flow. The attribute shall be a positive value. AngleDegrees Measurement of angle in degrees. CIMDatatype value unit deg multiplier none maxGamma Maximum extinction angle. It is converter’s configuration data used in power flow. The attribute shall be a positive value. maxIdc The maximum direct current (Id) on the DC side at which the converter should operate. It is converter’s configuration data use in power flow. The attribute shall be a positive value. CurrentFlow Electrical current with sign convention: positive flow is out of the conducting equipment into the connectivity node. Can be both AC and DC. CIMDatatype value multiplier none unit A minAlpha Minimum firing angle. It is converter’s configuration data used in power flow. The attribute shall be a positive value. minGamma Minimum extinction angle. It is converter’s configuration data used in power flow. The attribute shall be a positive value. minIdc The minimum direct current (Id) on the DC side at which the converter should operate. It is converter’s configuration data used in power flow. The attribute shall be a positive value. ratedIdc Rated converter DC current, also called IdN. The attribute shall be a positive value. It is converter’s configuration data used in power flow. CurrentLimit Operational limit on current. normalValue The normal value for limit on current flow. The attribute shall be a positive value or zero. CurrentTransformer Instrument transformer used to measure electrical qualities of the circuit that is being protected and/or monitored. Typically used as current transducer for the purpose of metering or protection. A typical secondary current rating would be 5A. Curve A multi-purpose curve or functional relationship between an independent variable (X-axis) and dependent (Y-axis) variables. curveStyle The style or shape of the curve. CurveStyle Style or shape of curve. constantYValue The Y-axis values are assumed constant until the next curve point and prior to the first curve point. enum straightLineYValues The Y-axis values are assumed to be a straight line between values. Also known as linear interpolation. enum xUnit The X-axis units of measure. y1Unit The Y1-axis units of measure. y2Unit The Y2-axis units of measure. CurveDatas The point data values that define this curve. No Curve The curve of this curve data point. Yes CurveData Multi-purpose data points for defining a curve. The use of this generic class is discouraged if a more specific class can be used to specify the X and Y axis values along with their specific data types. xvalue The data value of the X-axis variable, depending on the X-axis units. y1value The data value of the first Y-axis variable, depending on the Y-axis units. y2value The data value of the second Y-axis variable (if present), depending on the Y-axis units. Cut A cut separates a line segment into two parts. The cut appears as a switch inserted between these two parts and connects them together. As the cut is normally open there is no galvanic connection between the two line segment parts. But it is possible to close the cut to get galvanic connection. The cut terminals are oriented towards the line segment terminals with the same sequence number. Hence the cut terminal with sequence number equal to 1 is oriented to the line segment's terminal with sequence number equal to 1. The cut terminals also act as connection points for jumpers and other equipment, e.g. a mobile generator. To enable this, connectivity nodes are placed at the cut terminals. Once the connectivity nodes are in place any conducting equipment can be connected at them. lengthFromTerminal1 The length to the place where the cut is located starting from side one of the cut line segment, i.e. the line segment Terminal with sequenceNumber equal to 1. DayType Group of similar days. For example it could be used to represent weekdays, weekend, or holidays. DayType DayType for the Schedule. Yes SeasonDayTypeSchedules Schedules that use this DayType. No DCBaseTerminal 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. DCTerminals DC base terminals interconnected with zero impedance at a this DC connectivity node. No DCNode The DC connectivity node to which this DC base terminal connects with zero impedance. Yes DCBreaker A breaker within a DC system. DCBusbar A busbar within a DC system. DCChopper Low resistance equipment used in the internal DC circuit to balance voltages. It has typically positive and negative pole terminals and a ground. DCConductingEquipment The parts of the DC power system that are designed to carry current or that are conductively connected through DC terminals. ratedUdc Rated DC device voltage. The attribute shall be a positive value. It is configuration data used in power flow. DCTerminals A DC conducting equipment has DC terminals. No DCConductingEquipment An DC terminal belong to a DC conducting equipment. Yes DCConverterUnit Indivisible operative unit comprising all equipment between the point of common coupling on the AC side and the point of common coupling – DC side, essentially one or more converters, together with one or more converter transformers, converter control equipment, essential protective and switching devices and auxiliaries, if any, used for conversion. operationMode The operating mode of an HVDC bipole (bipolar, monopolar metallic return, etc). DCConverterOperatingModeKind The operating mode of an HVDC bipole. bipolar Bipolar operation. enum monopolarMetallicReturn Monopolar operation with metallic return. enum monopolarGroundReturn Monopolar operation with ground return. enum Substation The containing substation of the DC converter unit. Yes DCConverterUnit The DC converter unit belonging of the substation. No DCDisconnector A disconnector within a DC system. DCEquipmentContainer A modelling construct to provide a root class for containment of DC as well as AC equipment. The class differ from the EquipmentContaner for AC in that it may also contain DCNode-s. Hence it can contain both AC and DC equipment. DCEquipmentContainer The DC container for the DC nodes. Yes DCNodes The DC nodes contained in the DC equipment container. No DCGround A ground within a DC system. inductance Inductance to ground. Inductance Inductive part of reactance (imaginary part of impedance), at rated frequency. CIMDatatype value unit H multiplier none r Resistance to ground. DCLine Overhead lines and/or cables connecting two or more HVDC substations. Region The SubGeographicalRegion containing the DC line. Yes DCLines The DC lines in this sub-geographical region. No DCLineSegment A wire or combination of wires not insulated from one another, with consistent electrical characteristics, used to carry direct current between points in the DC region of the power system. capacitance Capacitance of the DC line segment. Significant for cables only. Capacitance Capacitive part of reactance (imaginary part of impedance), at rated frequency. CIMDatatype value unit F multiplier none inductance Inductance of the DC line segment. Negligible compared with DCSeriesDevice used for smoothing. resistance Resistance of the DC line segment. length Segment length for calculating line section capabilities. DCNode DC nodes are points where terminals of DC conducting equipment are connected together with zero impedance. RegulationSchedule A pre-established pattern over time for a controlled variable, e.g., busbar voltage. RegulatingControl Regulating controls that have this schedule. Yes RegulationSchedule Schedule for this regulating control. No DCSeriesDevice A series device within the DC system, typically a reactor used for filtering or smoothing. Needed for transient and short circuit studies. inductance Inductance of the device. resistance Resistance of the DC device. DCShunt A shunt device within the DC system, typically used for filtering. Needed for transient and short circuit studies. capacitance Capacitance of the DC shunt. resistance Resistance of the DC device. DCSwitch A switch within the DC system. DCTerminal An electrical connection point to generic DC conducting equipment. Disconnector 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. DisconnectingCircuitBreaker A circuit breaking device including disconnecting function, eliminating the need for separate disconnectors. EarthFaultCompensator A conducting equipment used to represent a connection to ground which is typically used to compensate earth faults. An earth fault compensator device modelled with a single terminal implies a second terminal solidly connected to ground. If two terminals are modelled, the ground is not assumed and normal connection rules apply. EnergyArea Describes an area having energy production or consumption. Specializations are intended to support the load allocation function as typically required in energy management systems or planning studies to allocate hypothesized load levels to individual load points for power flow analysis. Often the energy area can be linked to both measured and forecast load levels. EnergyConnection A connection of energy generation or consumption on the power system model. EnergyConsumer 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. pfixed Active power of the load that is a fixed quantity and does not vary as load group value varies. Load sign convention is used, i.e. positive sign means flow out from a node. pfixedPct Fixed active power as a percentage of load group fixed active power. Used to represent the time-varying components. Load sign convention is used, i.e. positive sign means flow out from a node. PerCent Percentage on a defined base. For example, specify as 100 to indicate at the defined base. CIMDatatype value Normally 0 to 100 on a defined base. unit none multiplier none qfixed Reactive power of the load that is a fixed quantity and does not vary as load group value varies. Load sign convention is used, i.e. positive sign means flow out from a node. ReactivePower Product of RMS value of the voltage and the RMS value of the quadrature component of the current. CIMDatatype value unit VAr multiplier M qfixedPct Fixed reactive power as a percentage of load group fixed reactive power. Used to represent the time-varying components. Load sign convention is used, i.e. positive sign means flow out from a node. LoadResponse The load response characteristic of this load. If missing, this load is assumed to be constant power. Yes EnergyConsumer The set of loads that have the response characteristics. No EnergySchedulingType Used to define the type of generation for scheduling purposes. EnergySource Energy Source of a particular Energy Scheduling Type. No EnergySchedulingType Energy Scheduling Type of an Energy Source. Yes TapSchedule A pre-established pattern over time for a tap step. TapChanger A TapSchedule is associated with a TapChanger. Yes TapSchedules A TapChanger can have TapSchedules. No EnergySource A generic equivalent for an energy supplier on a transmission or distribution voltage level. nominalVoltage Phase-to-phase nominal voltage. pMin This is the minimum active power that can be produced by the source. Load sign convention is used, i.e. positive sign means flow out from a TopologicalNode (bus) into the conducting equipment. pMax This is the maximum active power that can be produced by the source. Load sign convention is used, i.e. positive sign means flow out from a TopologicalNode (bus) into the conducting equipment. Equipment The parts of a power system that are physical devices, electronic or mechanical. aggregate The aggregate flag provides an alternative way of representing an aggregated (equivalent) element. It is applicable in cases when the dedicated classes for equivalent equipment do not have all of the attributes necessary to represent the required level of detail. In case the flag is set to “true” the single instance of equipment represents multiple pieces of equipment that have been modelled together as an aggregate equivalent obtained by a network reduction procedure. Examples would be power transformers or synchronous machines operating in parallel modelled as a single aggregate power transformer or aggregate synchronous machine. The attribute is not used for EquivalentBranch, EquivalentShunt and EquivalentInjection. normallyInService Specifies the availability of the equipment under normal operating conditions. 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. Equipments Contained equipment. No EquipmentContainer Container of this equipment. Yes Equipment The equipment to which the limit set applies. Yes OperationalLimitSet The operational limit sets associated with this equipment. No EquipmentContainer A modelling construct to provide a root class for containing equipment. EquivalentBranch The class represents equivalent branches. In cases where a transformer phase shift is modelled and the EquivalentBranch is spanning the same nodes, the impedance quantities for the EquivalentBranch shall consider the needed phase shift. r Positive sequence series resistance of the reduced branch. r21 Resistance from terminal sequence 2 to terminal sequence 1 .Used for steady state power flow. This attribute is optional and represent unbalanced network such as off-nominal phase shifter. If only EquivalentBranch.r is given, then EquivalentBranch.r21 is assumed equal to EquivalentBranch.r. Usage rule : EquivalentBranch is a result of network reduction prior to the data exchange. x Positive sequence series reactance of the reduced branch. x21 Reactance from terminal sequence 2 to terminal sequence 1. Used for steady state power flow. This attribute is optional and represents an unbalanced network such as off-nominal phase shifter. If only EquivalentBranch.x is given, then EquivalentBranch.x21 is assumed equal to EquivalentBranch.x. Usage rule: EquivalentBranch is a result of network reduction prior to the data exchange. EquivalentEquipment The class represents equivalent objects that are the result of a network reduction. The class is the base for equivalent objects of different types. EquivalentEquipments The associated reduced equivalents. No EquivalentNetwork The equivalent where the reduced model belongs. Yes EquivalentInjection This class represents equivalent injections (generation or load). Voltage regulation is allowed only at the point of connection. maxP Maximum active power of the injection. maxQ Maximum reactive power of the injection. Used for modelling of infeed for load flow exchange. Not used for short circuit modelling. If maxQ and minQ are not used ReactiveCapabilityCurve can be used. minP Minimum active power of the injection. minQ Minimum reactive power of the injection. Used for modelling of infeed for load flow exchange. Not used for short circuit modelling. If maxQ and minQ are not used ReactiveCapabilityCurve can be used. regulationCapability Specifies whether or not the EquivalentInjection has the capability to regulate the local voltage. If true the EquivalentInjection can regulate. If false the EquivalentInjection cannot regulate. ReactiveCapabilityCurve can only be associated with EquivalentInjection if the flag is true. ReactiveCapabilityCurve The reactive capability curve used by this equivalent injection. Yes EquivalentInjection The equivalent injection using this reactive capability curve. No EquivalentNetwork A class that groups electrical equivalents, including internal nodes, of a network that has been reduced. The ConnectivityNodes contained in the equivalent are intended to reflect internal nodes of the equivalent. The boundary Connectivity nodes where the equivalent connects outside itself are not contained by the equivalent. EquivalentShunt The class represents equivalent shunts. b Positive sequence shunt susceptance. g Positive sequence shunt conductance. ExternalNetworkInjection This class represents the external network and it is used for IEC 60909 calculations. governorSCD Power Frequency Bias. This is the change in power injection divided by the change in frequency and negated. A positive value of the power frequency bias provides additional power injection upon a drop in frequency. ActivePowerPerFrequency Active power variation with frequency. CIMDatatype multiplier M unit WPers value maxP Maximum active power of the injection. maxQ Maximum reactive power limit. It is used for modelling of infeed for load flow exchange and not for short circuit modelling. minP Minimum active power of the injection. minQ Minimum reactive power limit. It is used for modelling of infeed for load flow exchange and not for short circuit modelling. FaultIndicator A FaultIndicator is typically only an indicator (which may or may not be remotely monitored), and not a piece of equipment that actually initiates a protection event. It is used for FLISR (Fault Location, Isolation and Restoration) purposes, assisting with the dispatch of crews to "most likely" part of the network (i.e. assists with determining circuit section where the fault most likely happened). FossilFuel The fossil fuel consumed by the non-nuclear thermal generating unit. For example, coal, oil, gas, etc. These are the specific fuels that the generating unit can consume. fossilFuelType The type of fossil fuel, such as coal, oil, or gas. FuelType Type of fuel. coal Generic coal, not including lignite type. enum oil Oil. enum gas Natural gas. enum lignite The fuel is lignite coal. Note that this is a special type of coal, so the other enum of coal is reserved for hard coal types or if the exact type of coal is not known. enum hardCoal Hard coal. enum oilShale Oil Shale. enum brownCoalLignite Brown coal lignite. enum coalDerivedGas Coal derived gas. enum peat Peat. enum other Any fuel type not included in the rest of the enumerated value. enum FossilFuels A thermal generating unit may have one or more fossil fuels. No ThermalGeneratingUnit A thermal generating unit may have one or more fossil fuels. Yes Fuse 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. GeneratingUnit 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. genControlSource The source of controls for a generating unit. Defines the control status of the generating unit. GeneratorControlSource The source of controls for a generating unit. unavailable Not available. enum offAGC Off of automatic generation control (AGC). enum onAGC On automatic generation control (AGC). enum plantControl Plant is controlling. enum governorSCD Governor Speed Changer Droop. This is the change in generator power output divided by the change in frequency normalized by the nominal power of the generator and the nominal frequency and expressed in percent and negated. A positive value of speed change droop provides additional generator output upon a drop in frequency. longPF Generating unit long term economic participation factor. maximumAllowableSpinningReserve Maximum allowable spinning reserve. Spinning reserve will never be considered greater than this value regardless of the current operating point. maxOperatingP This is the maximum operating active power limit the dispatcher can enter for this unit. minOperatingP This is the minimum operating active power limit the dispatcher can enter for this unit. nominalP The nominal power of the generating unit. Used to give precise meaning to percentage based attributes such as the governor speed change droop (governorSCD attribute). The attribute shall be a positive value equal to or less than RotatingMachine.ratedS. ratedGrossMaxP The unit's gross rated maximum capacity (book value). The attribute shall be a positive value. ratedGrossMinP The gross rated minimum generation level which the unit can safely operate at while delivering power to the transmission grid. The attribute shall be a positive value. ratedNetMaxP The net rated maximum capacity determined by subtracting the auxiliary power used to operate the internal plant machinery from the rated gross maximum capacity. The attribute shall be a positive value. shortPF Generating unit short term economic participation factor. startupCost The initial startup cost incurred for each start of the GeneratingUnit. Money Amount of money. CIMDatatype unit Currency Monetary currencies. ISO 4217 standard including 3-character currency code. AED United Arab Emirates dirham. enum AFN Afghan afghani. enum ALL Albanian lek. enum AMD Armenian dram. enum ANG Netherlands Antillean guilder. enum AOA Angolan kwanza. enum ARS Argentine peso. enum AUD Australian dollar. enum AWG Aruban florin. enum AZN Azerbaijani manat. enum BAM Bosnia and Herzegovina convertible mark. enum BBD Barbados dollar. enum BDT Bangladeshi taka. enum BGN Bulgarian lev. enum BHD Bahraini dinar. enum BIF Burundian franc. enum BMD Bermudian dollar (customarily known as Bermuda dollar). enum BND Brunei dollar. enum BOB Boliviano. enum BOV Bolivian Mvdol (funds code). enum BRL Brazilian real. enum BSD Bahamian dollar. enum BTN Bhutanese ngultrum. enum BWP Botswana pula. enum BYR Belarusian ruble. enum BZD Belize dollar. enum CAD Canadian dollar. enum CDF Congolese franc. enum CHF Swiss franc. enum CLF Unidad de Fomento (funds code), Chile. enum CLP Chilean peso. enum CNY Chinese yuan. enum COP Colombian peso. enum COU Unidad de Valor Real. enum CRC Costa Rican colon. enum CUC Cuban convertible peso. enum CUP Cuban peso. enum CVE Cape Verde escudo. enum CZK Czech koruna. enum DJF Djiboutian franc. enum DKK Danish krone. enum DOP Dominican peso. enum DZD Algerian dinar. enum EEK Estonian kroon. enum EGP Egyptian pound. enum ERN Eritrean nakfa. enum ETB Ethiopian birr. enum EUR Euro. enum FJD Fiji dollar. enum FKP Falkland Islands pound. enum GBP Pound sterling. enum GEL Georgian lari. enum GHS Ghanaian cedi. enum GIP Gibraltar pound. enum GMD Gambian dalasi. enum GNF Guinean franc. enum GTQ Guatemalan quetzal. enum GYD Guyanese dollar. enum HKD Hong Kong dollar. enum HNL Honduran lempira. enum HRK Croatian kuna. enum HTG Haitian gourde. enum HUF Hungarian forint. enum IDR Indonesian rupiah. enum ILS Israeli new sheqel. enum INR Indian rupee. enum IQD Iraqi dinar. enum IRR Iranian rial. enum ISK Icelandic króna. enum JMD Jamaican dollar. enum JOD Jordanian dinar. enum JPY Japanese yen. enum KES Kenyan shilling. enum KGS Kyrgyzstani som. enum KHR Cambodian riel. enum KMF Comoro franc. enum KPW North Korean won. enum KRW South Korean won. enum KWD Kuwaiti dinar. enum KYD Cayman Islands dollar. enum KZT Kazakhstani tenge. enum LAK Lao kip. enum LBP Lebanese pound. enum LKR Sri Lanka rupee. enum LRD Liberian dollar. enum LSL Lesotho loti. enum LTL Lithuanian litas. enum LVL Latvian lats. enum LYD Libyan dinar. enum MAD Moroccan dirham. enum MDL Moldovan leu. enum MGA Malagasy ariary. enum MKD Macedonian denar. enum MMK Myanma kyat. enum MNT Mongolian tugrik. enum MOP Macanese pataca. enum MRO Mauritanian ouguiya. enum MUR Mauritian rupee. enum MVR Maldivian rufiyaa. enum MWK Malawian kwacha. enum MXN Mexican peso. enum MYR Malaysian ringgit. enum MZN Mozambican metical. enum NAD Namibian dollar. enum NGN Nigerian naira. enum NIO Cordoba oro. enum NOK Norwegian krone. enum NPR Nepalese rupee. enum NZD New Zealand dollar. enum OMR Omani rial. enum PAB Panamanian balboa. enum PEN Peruvian nuevo sol. enum PGK Papua New Guinean kina. enum PHP Philippine peso. enum PKR Pakistani rupee. enum PLN Polish zloty. enum PYG Paraguayan guaraní. enum QAR Qatari rial. enum RON Romanian new leu. enum RSD Serbian dinar. enum RUB Russian rouble. enum RWF Rwandan franc. enum SAR Saudi riyal. enum SBD Solomon Islands dollar. enum SCR Seychelles rupee. enum SDG Sudanese pound. enum SEK Swedish krona/kronor. enum SGD Singapore dollar. enum SHP Saint Helena pound. enum SLL Sierra Leonean leone. enum SOS Somali shilling. enum SRD Surinamese dollar. enum STD São Tomé and Príncipe dobra. enum SYP Syrian pound. enum SZL Lilangeni. enum THB Thai baht. enum TJS Tajikistani somoni. enum TMT Turkmenistani manat. enum TND Tunisian dinar. enum TOP Tongan pa'anga. enum TRY Turkish lira. enum TTD Trinidad and Tobago dollar. enum TWD New Taiwan dollar. enum TZS Tanzanian shilling. enum UAH Ukrainian hryvnia. enum UGX Ugandan shilling. enum USD United States dollar. enum UYU Uruguayan peso. enum UZS Uzbekistan som. enum VEF Venezuelan bolívar fuerte. enum VND Vietnamese Dong. enum VUV Vanuatu vatu. enum WST Samoan tala. enum XAF CFA franc BEAC. enum XCD East Caribbean dollar. enum XOF CFA Franc BCEAO. enum XPF CFP franc. enum YER Yemeni rial. enum ZAR South African rand. enum ZMK Zambian kwacha. enum ZWL Zimbabwe dollar. enum multiplier none value Decimal Decimal is the base-10 notational system for representing real numbers. Primitive variableCost The variable cost component of production per unit of ActivePower. startupTime Time it takes to get the unit on-line, from the time that the prime mover mechanical power is applied. Seconds Time, in seconds. CIMDatatype value Time, in seconds unit s multiplier none totalEfficiency The efficiency of the unit in converting the fuel into electrical energy. GeneratingUnit A generating unit may have a gross active power to net active power curve, describing the losses and auxiliary power requirements of the unit. Yes GrossToNetActivePowerCurves A generating unit may have a gross active power to net active power curve, describing the losses and auxiliary power requirements of the unit. No GeneratingUnit A synchronous machine may operate as a generator and as such becomes a member of a generating unit. Yes RotatingMachine A synchronous machine may operate as a generator and as such becomes a member of a generating unit. No GeographicalRegion A geographical region of a power system network model. Regions All sub-geographical regions within this geographical region. No Region The geographical region which this sub-geographical region is within. Yes GrossToNetActivePowerCurve Relationship between the generating unit's gross active power output on the X-axis (measured at the terminals of the machine(s)) and the generating unit's net active power output on the Y-axis (based on utility-defined measurements at the power station). Station service loads, when modelled, should be treated as non-conforming bus loads. There may be more than one curve, depending on the auxiliary equipment that is in service. Ground A point where the system is grounded used for connecting conducting equipment to ground. The power system model can have any number of grounds. GroundDisconnector A manually operated or motor operated mechanical switching device used for isolating a circuit or equipment from ground. GroundingImpedance A fixed impedance device used for grounding. HydroGeneratingUnit A generating unit whose prime mover is a hydraulic turbine (e.g., Francis, Pelton, Kaplan). energyConversionCapability Energy conversion capability for generating. HydroEnergyConversionKind Specifies the capability of the hydro generating unit to convert energy as a generator or pump. generator Able to generate power, but not able to pump water for energy storage. enum pumpAndGenerator Able to both generate power and pump water for energy storage. enum dropHeight The height water drops from the reservoir mid-point to the turbine. turbineType Type of turbine. HydroTurbineKind Type of turbine. francis Francis. enum pelton Pelton. enum kaplan Kaplan. enum HydroGeneratingUnits The hydro generating unit belongs to a hydro power plant. No HydroPowerPlant The hydro generating unit belongs to a hydro power plant. Yes HydroPowerPlant A hydro power station which can generate or pump. When generating, the generator turbines receive water from an upper reservoir. When pumping, the pumps receive their water from a lower reservoir. hydroPlantStorageType The type of hydro power plant water storage. HydroPlantStorageKind The type of hydro power plant. runOfRiver Run of river. enum pumpedStorage Pumped storage. enum storage Storage. enum HydroPumps The hydro pump may be a member of a pumped storage plant or a pump for distributing water. No HydroPowerPlant The hydro pump may be a member of a pumped storage plant or a pump for distributing water. Yes HydroPump A synchronous motor-driven pump, typically associated with a pumped storage plant. RotatingMachine The synchronous machine drives the turbine which moves the water from a low elevation to a higher elevation. The direction of machine rotation for pumping may or may not be the same as for generating. Yes HydroPump The synchronous machine drives the turbine which moves the water from a low elevation to a higher elevation. The direction of machine rotation for pumping may or may not be the same as for generating. No 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. energyIdentCodeEic European deprecated The attribute is used for an exchange of the EIC code (Energy identification Code). The length of the string is 16 characters as defined by the EIC code. For details on EIC scheme please refer to ENTSO-E web site. 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. shortName European deprecated The attribute is used for an exchange of a human readable short name with length of the string 12 characters maximum. Jumper 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. Junction A point where one or more conducting equipments are connected with zero resistance. Line Contains equipment beyond a substation belonging to a power transmission line. Lines The lines within the sub-geographical region. No Region The sub-geographical region of the line. Yes LinearShuntCompensator A linear shunt compensator has banks or sections with equal admittance values. bPerSection Positive sequence shunt (charging) susceptance per section. gPerSection Positive sequence shunt (charging) conductance per section. LoadArea The class is the root or first level in a hierarchical structure for grouping of loads for the purpose of load flow load scaling. SubLoadAreas The SubLoadAreas in the LoadArea. No LoadArea The LoadArea where the SubLoadArea belongs. Yes LoadBreakSwitch A mechanical switching device capable of making, carrying, and breaking currents under normal operating conditions. LoadGroup The class is the third level in a hierarchical structure for grouping of loads for the purpose of load flow load scaling. LoadGroups The Loadgroups in the SubLoadArea. No SubLoadArea The SubLoadArea where the Loadgroup belongs. Yes LoadResponseCharacteristic Models the characteristic response of the load demand due to changes in system conditions such as voltage and frequency. It is not related to demand response. If LoadResponseCharacteristic.exponentModel is True, the exponential voltage or frequency dependent models are specified and used as to calculate active and reactive power components of the load model. The equations to calculate active and reactive power components of the load model are internal to the power flow calculation, hence they use different quantities depending on the use case of the data exchange. The equations for exponential voltage dependent load model injected power are: pInjection= Pnominal* (Voltage/cim:BaseVoltage.nominalVoltage) ** cim:LoadResponseCharacteristic.pVoltageExponent qInjection= Qnominal* (Voltage/cim:BaseVoltage.nominalVoltage) ** cim:LoadResponseCharacteristic.qVoltageExponent Where: 1) * means "multiply" and ** is "raised to power of"; 2) Pnominal and Qnominal represent the active power and reactive power at nominal voltage as any load described by the voltage exponential model shall be given at nominal voltage. This means that EnergyConsumer.p and EnergyConsumer.q are at nominal voltage. 3) After power flow is solved: -pInjection and qInjection correspond to SvPowerflow.p and SvPowerflow.q respectively. - Voltage corresponds to SvVoltage.v at the TopologicalNode where the load is connected. exponentModel Indicates the exponential voltage dependency model is to be used. If false, the coefficient model is to be used. The exponential voltage dependency model consist of the attributes: - pVoltageExponent - qVoltageExponent - pFrequencyExponent - qFrequencyExponent. The coefficient model consist of the attributes: - pConstantImpedance - pConstantCurrent - pConstantPower - qConstantImpedance - qConstantCurrent - qConstantPower. The sum of pConstantImpedance, pConstantCurrent and pConstantPower shall equal 1. The sum of qConstantImpedance, qConstantCurrent and qConstantPower shall equal 1. pConstantCurrent Portion of active power load modelled as constant current. pConstantImpedance Portion of active power load modelled as constant impedance. pConstantPower Portion of active power load modelled as constant power. pFrequencyExponent Exponent of per unit frequency effecting active power. pVoltageExponent Exponent of per unit voltage effecting real power. qConstantCurrent Portion of reactive power load modelled as constant current. qConstantImpedance Portion of reactive power load modelled as constant impedance. qConstantPower Portion of reactive power load modelled as constant power. qFrequencyExponent Exponent of per unit frequency effecting reactive power. qVoltageExponent Exponent of per unit voltage effecting reactive power. NonConformLoad NonConformLoad represents loads that do not follow a daily load change pattern and whose changes are not correlated with the daily load change pattern. LoadGroup Group of this ConformLoad. Yes EnergyConsumers Conform loads assigned to this ConformLoadGroup. No NonConformLoadGroup Loads that do not follow a daily and seasonal load variation pattern. NonConformLoadSchedules The NonConformLoadSchedules in the NonConformLoadGroup. No NonConformLoadGroup The NonConformLoadGroup where the NonConformLoadSchedule belongs. Yes NonConformLoadSchedule An active power (Y1-axis) and reactive power (Y2-axis) schedule (curves) versus time (X-axis) for non-conforming loads, e.g., large industrial load or power station service (where modelled). NonlinearShuntCompensator 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. NonlinearShuntCompensator Non-linear shunt compensator owning this point. Yes NonlinearShuntCompensatorPoints All points of the non-linear shunt compensator. No NonlinearShuntCompensatorPoint A non linear shunt compensator bank or section admittance value. The number of NonlinearShuntCompenstorPoint instances associated with a NonlinearShuntCompensator shall be equal to ShuntCompensator.maximumSections. ShuntCompensator.sections shall only be set to one of the NonlinearShuntCompenstorPoint.sectionNumber. There is no interpolation between NonlinearShuntCompenstorPoint-s. b Positive sequence shunt (charging) susceptance per section. g Positive sequence shunt (charging) conductance per section. sectionNumber The number of the section. NuclearGeneratingUnit A nuclear generating unit. OperationalLimit 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. OperationalLimitValue Values of equipment limits. No OperationalLimitSet The limit set to which the limit values belong. Yes OperationalLimitType The limit type associated with this limit. Yes OperationalLimit The operational limits associated with this type of limit. No OperationalLimitSet A set of limits associated with equipment. Sets of limits might apply to a specific temperature, or season for example. A set of limits may contain different severities of limit levels that would apply to the same equipment. The set may contain limits of different types such as apparent power and current limits or high and low voltage limits that are logically applied together as a set. OperationalLimitType The operational meaning of a category of limits. acceptableDuration The nominal acceptable duration of the limit. Limits are commonly expressed in terms of the time limit for which the limit is normally acceptable. The actual acceptable duration of a specific limit may depend on other local factors such as temperature or wind speed. The attribute has meaning only if the flag isInfiniteDuration is set to false, hence it shall not be exchanged when isInfiniteDuration is set to true. direction The direction of the limit. OperationalLimitDirectionKind The direction attribute describes the side of a limit that is a violation. high High means that a monitored value above the limit value is a violation. If applied to a terminal flow, the positive direction is into the terminal. enum low Low means a monitored value below the limit is a violation. If applied to a terminal flow, the positive direction is into the terminal. enum absoluteValue An absoluteValue limit means that a monitored absolute value above the limit value is a violation. enum isInfiniteDuration Defines if the operational limit type has infinite duration. If true, the limit has infinite duration. If false, the limit has definite duration which is defined by the attribute acceptableDuration. kind European Types of limits defined in the ENTSO-E Operational Handbook Policy 3. LimitKind Limit kinds. European patl The Permanent Admissible Transmission Loading (PATL) is the loading in amperes, MVA or MW that can be accepted by a network branch for an unlimited duration without any risk for the material. The OperationnalLimitType.isInfiniteDuration is set to true. There shall be only one OperationalLimitType of kind PATL per OperationalLimitSet if the PATL is ApparentPowerLimit, ActivePowerLimit, or CurrentLimit for a given Terminal or Equipment. enum European patlt Permanent Admissible Transmission Loading Threshold (PATLT) is a value in engineering units defined for PATL and calculated using a percentage less than 100 % of the PATL type intended to alert operators of an arising condition. The percentage should be given in the name of the OperationalLimitSet. The aceptableDuration is another way to express the severity of the limit. enum European tatl Temporarily Admissible Transmission Loading (TATL) which is the loading in amperes, MVA or MW that can be accepted by a branch for a certain limited duration. The TATL can be defined in different ways: <ul> <li>as a fixed percentage of the PATL for a given time (for example, 115% of the PATL that can be accepted during 15 minutes),</li> </ul> <ul> <li>pairs of TATL type and Duration calculated for each line taking into account its particular configuration and conditions of functioning (for example, it can define a TATL acceptable during 20 minutes and another one acceptable during 10 minutes).</li> </ul> Such a definition of TATL can depend on the initial operating conditions of the network element (sag situation of a line). The duration attribute can be used to define several TATL limit types. Hence multiple TATL limit values may exist having different durations. enum European tc Tripping Current (TC) is the ultimate intensity without any delay. It is defined as the threshold the line will trip without any possible remedial actions. The tripping of the network element is ordered by protections against short circuits or by overload protections, but in any case, the activation delay of these protections is not compatible with the reaction delay of an operator (less than one minute). The duration is always zero if the OperationalLimitType.acceptableDuration is exchanged. Only one limit value exists for the TC type. enum European tct Tripping Current Threshold (TCT) is a value in engineering units defined for TC and calculated using a percentage less than 100 % of the TC type intended to alert operators of an arising condition. The percentage should be given in the name of the OperationalLimitSet. The aceptableDuration is another way to express the severity of the limit. enum European highVoltage Referring to the rating of the equipments, a voltage too high can lead to accelerated ageing or the destruction of the equipment. This limit type may or may not have duration. enum European lowVoltage A too low voltage can disturb the normal operation of some protections and transformer equipped with on-load tap changers, electronic power devices or can affect the behaviour of the auxiliaries of generation units. This limit type may or may not have duration. enum European operationalVoltageLimit Operational voltage limit. enum European alarmVoltage Voltage alarm. enum European warningVoltage Voltage warning. enum European stability Stability. enum European PetersenCoil A variable impedance device normally used to offset line charging during single line faults in an ungrounded section of network. PhaseTapChanger 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. TransformerEnd Transformer end to which this phase tap changer belongs. Yes PhaseTapChanger Phase tap changer associated with this transformer end. No PhaseTapChangerAsymmetrical 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. windingConnectionAngle The phase angle between the in-phase winding and the out-of -phase winding used for creating phase shift. The out-of-phase winding produces what is known as the difference voltage. Setting this angle to 90 degrees is not the same as a symmetrical transformer. The attribute can only be multiples of 30 degrees. The allowed range is -150 degrees to 150 degrees excluding 0. PhaseTapChangerLinear 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. stepPhaseShiftIncrement Phase shift per step position. A positive value indicates a positive angle variation from the Terminal at the PowerTransformerEnd, where the TapChanger is located, into the transformer. The actual phase shift increment might be more accurately computed from the symmetrical or asymmetrical models or a tap step table lookup if those are available. xMax The reactance depends on the tap position according to a "u" shaped curve. The maximum reactance (xMax) appears at the low and high tap positions. Depending on the “u” curve the attribute can be either higher or lower than PowerTransformerEnd.x. xMin deprecated The reactance depends on the tap position according to a "u" shaped curve. The minimum reactance (xMin) appears at the mid tap position. PowerTransformerEnd.x shall be consistent with PhaseTapChangerLinear.xMin and PhaseTapChangerNonLinear.xMin. In case of inconsistency, PowerTransformerEnd.x shall be used. PhaseTapChangerNonLinear 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. voltageStepIncrement The voltage step increment on the out of phase winding (the PowerTransformerEnd where the TapChanger is located) specified in percent of rated voltage of the PowerTransformerEnd. A positive value means a positive voltage variation from the Terminal at the PowerTransformerEnd, where the TapChanger is located, into the transformer. When the increment is negative, the voltage decreases when the tap step increases. xMax The reactance depends on the tap position according to a "u" shaped curve. The maximum reactance (xMax) appears at the low and high tap positions. Depending on the “u” curve the attribute can be either higher or lower than PowerTransformerEnd.x. xMin deprecated The reactance depend on the tap position according to a "u" shaped curve. The minimum reactance (xMin) appear at the mid tap position. PowerTransformerEnd.x shall be consistent with PhaseTapChangerLinear.xMin and PhaseTapChangerNonLinear.xMin. In case of inconsistency, PowerTransformerEnd.x shall be used. PhaseTapChangerSymmetrical 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. PhaseTapChangerTable Describes a tabular curve for how the phase angle difference and impedance varies with the tap step. PhaseTapChangerTable The table of this point. Yes PhaseTapChangerTablePoint The points of this table. No PhaseTapChangerTabular The phase tap changers to which this phase tap table applies. No PhaseTapChangerTable The phase tap changer table for this phase tap changer. Yes PhaseTapChangerTablePoint Describes each tap step in the phase tap changer tabular curve. angle The angle difference in degrees. A positive value indicates a positive angle variation from the Terminal at the PowerTransformerEnd, where the TapChanger is located, into the transformer. PhaseTapChangerTabular Describes a tap changer with a table defining the relation between the tap step and the phase angle difference across the transformer. PhotoVoltaicUnit A photovoltaic device or an aggregation of such devices. PostLineSensor A sensor used mainly in overhead distribution networks as the source of both current and voltage measurements. PotentialTransformer Instrument transformer (also known as Voltage Transformer) used to measure electrical qualities of the circuit that is being protected and/or monitored. Typically used as voltage transducer for the purpose of metering, protection, or sometimes auxiliary substation supply. A typical secondary voltage rating would be 120V. PowerElectronicsConnection A connection to the AC network for energy production or consumption that uses power electronics rather than rotating machines. maxQ Maximum reactive power limit. This is the maximum (nameplate) limit for the unit. minQ Minimum reactive power limit for the unit. This is the minimum (nameplate) limit for the unit. ratedS Nameplate apparent power rating for the unit. The attribute shall have a positive value. ratedU Rated voltage (nameplate data, Ur in IEC 60909-0). It is primarily used for short circuit data exchange according to IEC 60909. The attribute shall be a positive value. PowerElectronicsUnit An AC network connection may have several power electronics units connecting through it. Yes PowerElectronicsConnection A power electronics unit has a connection to the AC network. No PowerElectronicsUnit A generating unit or battery or aggregation that connects to the AC network using power electronics rather than rotating machines. maxP Maximum active power limit. This is the maximum (nameplate) limit for the unit. minP Minimum active power limit. This is the minimum (nameplate) limit for the unit. PowerElectronicsWindUnit A wind generating unit that connects to the AC network with power electronics rather than rotating machines or an aggregation of such units. PowerSystemResource A power system resource (PSR) can be an item of equipment such as a switch, an equipment container containing many individual items of equipment such as a substation, or an organisational entity such as sub-control area. Power system resources can have measurements associated. PowerTransformer An electrical device consisting of two or more coupled windings, with or without a magnetic core, for introducing mutual coupling between electric circuits. Transformers can be used to control voltage and phase shift (active power flow). A power transformer may be composed of separate transformer tanks that need not be identical. A power transformer can be modelled with or without tanks and is intended for use in both balanced and unbalanced representations. A power transformer typically has two terminals, but may have one (grounding), three or more terminals. The inherited association ConductingEquipment.BaseVoltage should not be used. The association from TransformerEnd to BaseVoltage should be used instead. PowerTransformer The power transformer of this power transformer end. Yes PowerTransformerEnd The ends of this power transformer. No PowerTransformerEnd A PowerTransformerEnd is associated with each Terminal of a PowerTransformer. The impedance values r, r0, x, and x0 of a PowerTransformerEnd represents a star equivalent as follows. 1) for a two Terminal PowerTransformer the high voltage (TransformerEnd.endNumber=1) PowerTransformerEnd has non zero values on r, r0, x, and x0 while the low voltage (TransformerEnd.endNumber=2) PowerTransformerEnd has zero values for r, r0, x, and x0. Parameters are always provided, even if the PowerTransformerEnds have the same rated voltage. In this case, the parameters are provided at the PowerTransformerEnd which has TransformerEnd.endNumber equal to 1. 2) for a three Terminal PowerTransformer the three PowerTransformerEnds represent a star equivalent with each leg in the star represented by r, r0, x, and x0 values. 3) For a three Terminal transformer each PowerTransformerEnd shall have g, g0, b and b0 values corresponding to the no load losses distributed on the three PowerTransformerEnds. The total no load loss shunt impedances may also be placed at one of the PowerTransformerEnds, preferably the end numbered 1, having the shunt values on end 1. This is the preferred way. 4) for a PowerTransformer with more than three Terminals the PowerTransformerEnd impedance values cannot be used. Instead use the TransformerMeshImpedance or split the transformer into multiple PowerTransformers. Each PowerTransformerEnd must be contained by a PowerTransformer. Because a PowerTransformerEnd (or any other object) can not be contained by more than one parent, a PowerTransformerEnd can not have an association to an EquipmentContainer (Substation, VoltageLevel, etc). b Magnetizing branch susceptance (B mag). The value can be positive or negative. connectionKind Kind of connection. WindingConnection Winding connection type. D Delta. enum Y Wye. enum Z ZigZag. enum Yn Wye, with neutral brought out for grounding. enum Zn ZigZag, with neutral brought out for grounding. enum A Autotransformer common winding. enum I Independent winding, for single-phase connections. enum ratedS Normal apparent power rating. The attribute shall be a positive value. For a two-winding transformer the values for the high and low voltage sides shall be identical. g Magnetizing branch conductance. ratedU Rated voltage: phase-phase for three-phase windings, and either phase-phase or phase-neutral for single-phase windings. A high voltage side, as given by TransformerEnd.endNumber, shall have a ratedU that is greater than or equal to ratedU for the lower voltage sides. The attribute shall be a positive value. r Resistance (star-model) of the transformer end. The attribute shall be equal to or greater than zero for non-equivalent transformers. x Positive sequence series reactance (star-model) of the transformer end. ProtectedSwitch A ProtectedSwitch is a switching device that can be operated by ProtectionEquipment. RatioTapChanger 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). stepVoltageIncrement Tap step increment, in per cent of rated voltage of the power transformer end, per step position. When the increment is negative, the voltage decreases when the tap step increases. RatioTapChanger The ratio tap changer of this tap ratio table. No RatioTapChangerTable The tap ratio table for this ratio tap changer. Yes TransformerEnd Transformer end to which this ratio tap changer belongs. Yes RatioTapChanger Ratio tap changer associated with this transformer end. No RatioTapChangerTable Describes a curve for how the voltage magnitude and impedance varies with the tap step. RatioTapChangerTablePoint Points of this table. No RatioTapChangerTable Table of this point. Yes RatioTapChangerTablePoint Describes each tap step in the ratio tap changer tabular curve. ReactiveCapabilityCurve Reactive power rating envelope versus the synchronous machine's active power, in both the generating and motoring modes. For each active power value there is a corresponding high and low reactive power limit value. Typically there will be a separate curve for each coolant condition, such as hydrogen pressure. The Y1 axis values represent reactive minimum and the Y2 axis values represent reactive maximum. InitialReactiveCapabilityCurve The default reactive capability curve for use by a synchronous machine. Yes InitiallyUsedBySynchronousMachines Synchronous machines using this curve as default. No RegulatingCondEq A type of conducting equipment that can regulate a quantity (i.e. voltage or flow) at a specific point in the network. RegulatingControl The regulating control scheme in which this equipment participates. Yes RegulatingCondEq The equipment that participates in this regulating control scheme. No RegulatingControl 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. mode The regulating control mode presently available. This specification allows for determining the kind of regulation without need for obtaining the units from a schedule. RegulatingControlModeKind The kind of regulation model. For example regulating voltage, reactive power, active power, etc. voltage Voltage is specified. enum activePower Active power is specified. enum reactivePower Reactive power is specified. enum currentFlow Current flow is specified. enum admittance Admittance is specified. enum timeScheduled Control switches on/off by time of day. The times may change on the weekend, or in different seasons. enum temperature Control switches on/off based on the local temperature (i.e., a thermostat). enum powerFactor Power factor is specified. enum Terminal The terminal associated with this regulating control. The terminal is associated instead of a node, since the terminal could connect into either a topological node or a connectivity node. Sometimes it is useful to model regulation at a terminal of a bus bar object. Yes RegulatingControl The controls regulating this terminal. No RegularTimePoint Time point for a schedule where the time between the consecutive points is constant. sequenceNumber The position of the regular time point in the sequence. Note that time points don't have to be sequential, i.e. time points may be omitted. The actual time for a RegularTimePoint is computed by multiplying the associated regular interval schedule's time step with the regular time point sequence number and adding the associated schedules start time. To specify values for the start time, use sequence number 0. The sequence number cannot be negative. value1 The first value at the time. The meaning of the value is defined by the derived type of the associated schedule. value2 The second value at the time. The meaning of the value is defined by the derived type of the associated schedule. TimePoints The regular interval time point data values that define this schedule. No IntervalSchedule Regular interval schedule containing this time point. Yes RegularIntervalSchedule The schedule has time points where the time between them is constant. timeStep The time between each pair of subsequent regular time points in sequence order. endTime The time for the last time point. The value can be a time of day, not a specific date. ReportingGroup A reporting group is used for various ad-hoc groupings used for reporting. RotatingMachine A rotating machine which may be used as a generator or motor. ratedPowerFactor Power factor (nameplate data). It is primarily used for short circuit data exchange according to IEC 60909. The attribute cannot be a negative value. ratedS Nameplate apparent power rating for the unit. The attribute shall have a positive value. ratedU Rated voltage (nameplate data, Ur in IEC 60909-0). It is primarily used for short circuit data exchange according to IEC 60909. The attribute shall be a positive value. Season A specified time period of the year. endDate Date season ends. MonthDay MonthDay format as "--mm-dd", which conforms with XSD data type gMonthDay. Primitive startDate Date season starts. Season Season for the Schedule. Yes SeasonDayTypeSchedules Schedules that use this Season. No Sensor This class describe devices that transform a measured quantity into signals that can be presented at displays, used in control or be recorded. SeasonDayTypeSchedule A time schedule covering a 24 hour period, with curve data for a specific type of season and day. SeriesCompensator A Series Compensator is a series capacitor or reactor or an AC transmission line without charging susceptance. It is a two terminal device. r Positive sequence resistance. x Positive sequence reactance. ShuntCompensator A shunt capacitor or reactor or switchable bank of shunt capacitors or reactors. A section of a shunt compensator is an individual capacitor or reactor. A negative value for bPerSection indicates that the compensator is a reactor. ShuntCompensator is a single terminal device. Ground is implied. aVRDelay An automatic voltage regulation delay (AVRDelay) which is the time delay from a change in voltage to when the capacitor is allowed to change state. This filters out temporary changes in voltage. grounded Used for Yn and Zn connections. True if the neutral is solidly grounded. maximumSections The maximum number of sections that may be switched in. nomU The voltage at which the nominal reactive power may be calculated. This should normally be within 10% of the voltage at which the capacitor is connected to the network. normalSections The normal number of sections switched in. The value shall be between zero and ShuntCompensator.maximumSections. voltageSensitivity Voltage sensitivity required for the device to regulate the bus voltage, in voltage/reactive power. VoltagePerReactivePower Voltage variation with reactive power. CIMDatatype value unit VPerVAr multiplier none SolarGeneratingUnit A solar thermal generating unit, connected to the grid by means of a rotating machine. This class does not represent photovoltaic (PV) generation. SolarGeneratingUnits A solar generating unit or units may be a member of a solar power plant. No European SolarPowerPlant A solar power plant may have solar generating units. Yes European SolarPowerPlant Solar power plant. European StaticVarCompensator 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. capacitiveRating Capacitive reactance at maximum capacitive reactive power. Shall always be positive. inductiveRating Inductive reactance at maximum inductive reactive power. Shall always be negative. slope The characteristics slope of an SVC defines how the reactive power output changes in proportion to the difference between the regulated bus voltage and the voltage setpoint. The attribute shall be a positive value or zero. sVCControlMode deprecated SVC control mode. SVCControlMode Static VAr Compensator control mode. deprecated reactivePower Reactive power control. enum voltage Voltage control. enum voltageSetPoint deprecated The reactive power output of the SVC is proportional to the difference between the voltage at the regulated bus and the voltage setpoint. When the regulated bus voltage is equal to the voltage setpoint, the reactive power output is zero. StationSupply Station supply with load derived from the station output. SubGeographicalRegion A subset of a geographical region of a power system network model. Substations The substations in this sub-geographical region. No Region The SubGeographicalRegion containing the substation. Yes SubLoadArea The class is the second level in a hierarchical structure for grouping of loads for the purpose of load flow load scaling. Substation A collection of equipment for purposes other than generation or utilization, through which electric energy in bulk is passed for the purposes of switching or modifying its characteristics. VoltageLevels The voltage levels within this substation. No Substation The substation of the voltage level. Yes SurgeArrester Shunt device, installed on the network, usually in the proximity of electrical equipment in order to protect the said equipment against transient voltage transients caused by lightning or switching activity. Switch 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. normalOpen The attribute is used in cases when no Measurement for the status value is present. If the Switch has a status measurement the Discrete.normalValue is expected to match with the Switch.normalOpen. ratedCurrent The maximum continuous current carrying capacity in amps governed by the device material and construction. The attribute shall be a positive value. retained Branch is retained in the topological solution. The flow through retained switches will normally be calculated in power flow. Switch A SwitchSchedule is associated with a Switch. Yes SwitchSchedules A Switch can be associated with SwitchSchedules. No SwitchSchedule A schedule of switch positions. If RegularTimePoint.value1 is 0, the switch is open. If 1, the switch is closed. SynchronousMachine An electromechanical device that operates with shaft rotating synchronously with the network. It is a single machine operating either as a generator or synchronous condenser or pump. maxQ Maximum reactive power limit. This is the maximum (nameplate) limit for the unit. minQ Minimum reactive power limit for the unit. qPercent Part of the coordinated reactive control that comes from this machine. The attribute is used as a participation factor not necessarily summing up to 100% for the participating devices in the control. type Modes that this synchronous machine can operate in. SynchronousMachineKind Synchronous machine type. generator Indicates the synchronous machine can operate as a generator. enum condenser Indicates the synchronous machine can operate as a condenser. enum generatorOrCondenser Indicates the synchronous machine can operate as a generator or as a condenser. enum motor Indicates the synchronous machine can operate as a motor. enum generatorOrMotor Indicates the synchronous machine can operate as a generator or as a motor. enum motorOrCondenser Indicates the synchronous machine can operate as a motor or as a condenser. enum generatorOrCondenserOrMotor Indicates the synchronous machine can operate as a generator or as a condenser or as a motor. enum TapChanger Mechanism for changing transformer winding tap positions. highStep Highest possible tap step position, advance from neutral. The attribute shall be greater than lowStep. lowStep Lowest possible tap step position, retard from neutral. ltcFlag Specifies whether or not a TapChanger has load tap changing capabilities. neutralStep The neutral tap step position for this winding. The attribute shall be equal to or greater than lowStep and equal or less than highStep. It is the step position where the voltage is neutralU when the other terminals of the transformer are at the ratedU. If there are other tap changers on the transformer those taps are kept constant at their neutralStep. neutralU Voltage at which the winding operates at the neutral tap setting. It is the voltage at the terminal of the PowerTransformerEnd associated with the tap changer when all tap changers on the transformer are at their neutralStep position. Normally neutralU of the tap changer is the same as ratedU of the PowerTransformerEnd, but it can differ in special cases such as when the tapping mechanism is separate from the winding more common on lower voltage transformers. This attribute is not relevant for PhaseTapChangerAsymmetrical, PhaseTapChangerSymmetrical and PhaseTapChangerLinear. normalStep The tap step position used in "normal" network operation for this winding. For a "Fixed" tap changer indicates the current physical tap setting. The attribute shall be equal to or greater than lowStep and equal to or less than highStep. TapChanger The tap changers that participates in this regulating tap control scheme. No TapChangerControl The regulating control scheme in which this tap changer participates. Yes TapChangerControl 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. TapChangerTablePoint Describes each tap step in the tabular curve. b The magnetizing branch susceptance deviation as a percentage of nominal value. The actual susceptance is calculated as follows: calculated magnetizing susceptance = b(nominal) * (1 + b(from this class)/100). The b(nominal) is defined as the static magnetizing susceptance on the associated power transformer end or ends. This model assumes the star impedance (pi model) form. g The magnetizing branch conductance deviation as a percentage of nominal value. The actual conductance is calculated as follows: calculated magnetizing conductance = g(nominal) * (1 + g(from this class)/100). The g(nominal) is defined as the static magnetizing conductance on the associated power transformer end or ends. This model assumes the star impedance (pi model) form. r The resistance deviation as a percentage of nominal value. The actual reactance is calculated as follows: calculated resistance = r(nominal) * (1 + r(from this class)/100). The r(nominal) is defined as the static resistance on the associated power transformer end or ends. This model assumes the star impedance (pi model) form. ratio The voltage at the tap step divided by rated voltage of the transformer end having the tap changer. Hence this is a value close to one. For example, if the ratio at step 1 is 1.01, and the rated voltage of the transformer end is 110kV, then the voltage obtained by setting the tap changer to step 1 to is 111.1kV. step The tap step. x The series reactance deviation as a percentage of nominal value. The actual reactance is calculated as follows: calculated reactance = x(nominal) * (1 + x(from this class)/100). The x(nominal) is defined as the static series reactance on the associated power transformer end or ends. This model assumes the star impedance (pi model) form. Terminal An AC electrical connection point to a piece of conducting equipment. Terminals are connected at physical connection points called connectivity nodes. phases Represents the normal network phasing condition. If the attribute is missing, three phases (ABC) shall be assumed, except for terminals of grounding classes (specializations of EarthFaultCompensator, GroundDisconnector, and Ground) which will be assumed to be N. Therefore, phase code ABCN is explicitly declared when needed, e.g. for star point grounding equipment. The phase code on terminals connecting same ConnectivityNode or same TopologicalNode as well as for equipment between two terminals shall be consistent. 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 Phases A, B, C, and N. enum ABC Phases A, B, and C. enum ABN Phases A, B, and neutral. enum ACN Phases A, C and neutral. enum BCN Phases B, C, and neutral. enum AB Phases A and B. enum AC Phases A and C. enum BC Phases B and C. enum AN Phases A and neutral. enum BN Phases B and neutral. enum CN Phases C and neutral. enum A Phase A. enum B Phase B. enum C Phase C. enum N Neutral phase. enum s1N Secondary phase 1 and neutral. enum s2N Secondary phase 2 and neutral. enum s12N Secondary phases 1, 2, and neutral. enum s1 Secondary phase 1. enum s2 Secondary phase 2. enum s12 Secondary phase 1 and 2. enum none No phases specified. enum X Unknown non-neutral phase. enum XY Two unknown non-neutral phases. enum XN Unknown non-neutral phase plus neutral. enum XYN Two unknown non-neutral phases plus neutral. enum Terminal Terminal of the power transformer to which this transformer end belongs. Yes TransformerEnd All transformer ends connected at this terminal. No Terminal The terminal to which this tie flow belongs. Yes TieFlow The control area tie flows to which this terminal associates. No ThermalGeneratingUnit A generating unit whose prime mover could be a steam turbine, combustion turbine, or diesel engine. TieFlow Defines the structure (in terms of location and direction) of the net interchange constraint for a control area. This constraint may be used by either AGC or power flow. positiveFlowIn Specifies the sign of the tie flow associated with a control area. True if positive flow into the terminal (load convention) is also positive flow into the control area. See the description of ControlArea for further explanation of how TieFlow.positiveFlowIn is used. TransformerEnd A conducting connection point of a power transformer. It corresponds to a physical transformer winding terminal. In earlier CIM versions, the TransformerWinding class served a similar purpose, but this class is more flexible because it associates to terminal but is not a specialization of ConductingEquipment. endNumber Number for this transformer end, corresponding to the end's order in the power transformer vector group or phase angle clock number. Highest voltage winding should be 1. Each end within a power transformer should have a unique subsequent end number. Note the transformer end number need not match the terminal sequence number. VoltageLevel A collection of equipment at one common system voltage forming a switchgear. The equipment typically consists of breakers, busbars, instrumentation, control, regulation and protection devices as well as assemblies of all these. highVoltageLimit The bus bar's high voltage limit. The limit applies to all equipment and nodes contained in a given VoltageLevel. It is not required that it is exchanged in pair with lowVoltageLimit. It is preferable to use operational VoltageLimit, which prevails, if present. lowVoltageLimit The bus bar's low voltage limit. The limit applies to all equipment and nodes contained in a given VoltageLevel. It is not required that it is exchanged in pair with highVoltageLimit. It is preferable to use operational VoltageLimit, which prevails, if present. VoltageLimit 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. normalValue The normal 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. VsCapabilityCurve The P-Q capability curve for a voltage source converter, with P on X-axis and Qmin and Qmax on Y1-axis and Y2-axis. VsConverterDCSides All converters with this capability curve. No CapabilityCurve Capability curve of this converter. Yes VsConverter DC side of the voltage source converter (VSC). maxModulationIndex The maximum quotient between the AC converter voltage (Uc) and DC voltage (Ud). A factor typically less than 1. It is converter’s configuration data used in power flow. WaveTrap Line traps are devices that impede high frequency power line carrier signals yet present a negligible impedance at the main power frequency. WindGeneratingUnit 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. windGenUnitType The kind of wind generating unit. WindGenUnitKind Kind of wind generating unit. offshore The wind generating unit is located offshore. enum onshore The wind generating unit is located onshore. enum WindGeneratingUnits A wind generating unit or units may be a member of a wind power plant. No European WindPowerPlant A wind power plant may have wind generating units. Yes European WindPowerPlant Wind power plant. European 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