SSH 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 steady state hypothesis profile from IEC 61970-600-2. 5aabb9bd-8fe3-4f3c-a0fa-f6902e767ce5 2021-01-27T12:19:09Z en-GB 2020-10-12 ENTSO-E Copyright ENTSO-E Steady State Hypothesis Vocabulary SteadyStateHypothesisProfile A steady state hypothesis dataset which conforms to the IEC 61970-456 steady state hypothesis profile contains all objects required to exchange input parameters to be able to perform load flow simulations. Due to the nature of the SSH profile, all objects in a Steady State Hypothesis instance file should have persistent mRIDs. ACDCConverter 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. p Active power at the point of common coupling. Load sign convention is used, i.e. positive sign means flow out from a node. Starting value for a steady state solution in the case a simplified power flow model is used. ActivePower Product of RMS value of the voltage and the RMS value of the in-phase component 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 W 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 q Reactive power at the point of common coupling. Load sign convention is used, i.e. positive sign means flow out from a node. Starting value for a steady state solution in the case a simplified power flow model is used. 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 targetPpcc Real power injection target in AC grid, at point of common coupling. Load sign convention is used, i.e. positive sign means flow out from a node. targetUdc Target value for DC voltage magnitude. The attribute shall be a positive value. Voltage Electrical voltage, can be both AC and DC. CIMDatatype value multiplier k unit V 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. Description ACDCTerminal An electrical connection point (AC or DC) to a piece of conducting equipment. Terminals are connected at physical connection points called connectivity nodes. connected The connected status is related to a bus-branch model and the topological node to terminal relation. True implies the terminal is connected to the related topological node and false implies it is not. In a bus-branch model, the connected status is used to tell if equipment is disconnected without having to change the connectivity described by the topological node to terminal relation. A valid case is that conducting equipment can be connected in one end and open in the other. In particular for an AC line segment, where the reactive line charging can be significant, this is a relevant case. Boolean A type with the value space "true" and "false". Primitive ActivePowerLimit Limit on active power flow. Description value Value of active power limit. The attribute shall be a positive value or zero. ApparentPowerLimit Apparent power limit. Description value The apparent power limit. The attribute shall be a positive value or zero. ApparentPower Product of the RMS value of the voltage and the RMS value of the current. CIMDatatype value multiplier M unit VA 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. Description asynchronousMachineType Indicates the type of Asynchronous Machine (motor or generator). AsynchronousMachineKind Kind of Asynchronous Machine. generator The Asynchronous Machine is a generator. enum motor The Asynchronous Machine is a motor. enum BatteryUnit An electrochemical energy storage device. Description batteryState The current state of the battery (charging, full, etc.). BatteryStateKind The state of the battery unit. discharging Stored energy is decreasing. enum full Unable to charge, and not discharging. enum waiting Neither charging nor discharging, but able to do so. enum charging Stored energy is increasing. enum empty Unable to discharge, and not charging. enum storedE Amount of energy currently stored. The attribute shall be a positive value or zero and lower than BatteryUnit.ratedE. RealEnergy Real electrical energy. CIMDatatype multiplier M unit Wh value 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. Description ConductingEquipment The parts of the AC power system that are designed to carry current or that are conductively connected through terminals. 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. Description 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. Description netInterchange The specified positive net interchange into the control area, i.e. positive sign means flow into the area. pTolerance Active power net interchange tolerance. The attribute shall be a positive value or zero. 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. Description operatingMode Indicates whether the DC pole is operating as an inverter or as a rectifier. It is converter’s control variable used in power flow. CsOperatingModeKind Operating mode for HVDC line operating as Current Source Converter. inverter Operating as inverter, which is the power receiving end. enum rectifier Operating as rectifier, which is the power sending end. enum pPccControl Kind of active power control. CsPpccControlKind Active power control modes for HVDC line operating as Current Source Converter. activePower Control is active power control at AC side, at point of common coupling. Target is provided by ACDCConverter.targetPpcc. enum dcVoltage Control is DC voltage with target value provided by ACDCConverter.targetUdc. enum dcCurrent Control is DC current with target value provided by CsConverter.targetIdc. enum targetAlpha Target firing angle. It is converter’s control variable used in power flow. It is only applicable for rectifier if continuous tap changer control is used. Allowed values are within the range minAlpha&lt;=targetAlpha&lt;=maxAlpha. The attribute shall be a positive value. AngleDegrees Measurement of angle in degrees. CIMDatatype value unit deg multiplier none targetGamma Target extinction angle. It is converter’s control variable used in power flow. It is only applicable for inverter if continuous tap changer control is used. Allowed values are within the range minGamma&lt;=targetGamma&lt;=maxGamma. The attribute shall be a positive value. targetIdc DC current target value. It is converter’s control variable used 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 CurrentLimit Operational limit on current. Description value Limit on current flow. The attribute shall be a positive value or zero. 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. DCTerminal An electrical connection point to generic DC conducting equipment. Description 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. Description DisconnectingCircuitBreaker A circuit breaking device including disconnecting function, eliminating the need for separate disconnectors. Description 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. Description p Active power of the load. Load sign convention is used, i.e. positive sign means flow out from a node. For voltage dependent loads the value is at rated voltage. Starting value for a steady state solution. q Reactive power of the load. Load sign convention is used, i.e. positive sign means flow out from a node. For voltage dependent loads the value is at rated voltage. Starting value for a steady state solution. EnergySource A generic equivalent for an energy supplier on a transmission or distribution voltage level. Description activePower High voltage source active injection. Load sign convention is used, i.e. positive sign means flow out from a node. Starting value for steady state solutions. reactivePower High voltage source reactive injection. Load sign convention is used, i.e. positive sign means flow out from a node. Starting value for steady state solutions. voltageAngle Phase angle of a-phase open circuit used when voltage characteristics need to be imposed at the node associated with the terminal of the energy source, such as when voltages and angles from the transmission level are used as input to the distribution network. The attribute shall be a positive value or zero. AngleRadians Phase angle in radians. CIMDatatype value unit rad multiplier none voltageMagnitude Phase-to-phase open circuit voltage magnitude used when voltage characteristics need to be imposed at the node associated with the terminal of the energy source, such as when voltages and angles from the transmission level are used as input to the distribution network. The attribute shall be a positive value or zero. Equipment The parts of a power system that are physical devices, electronic or mechanical. inService Specifies the availability of the equipment. True means the equipment is available for topology processing, which determines if the equipment is energized or not. False means that the equipment is treated by network applications as if it is not in the model. 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. EquivalentInjection This class represents equivalent injections (generation or load). Voltage regulation is allowed only at the point of connection. Description regulationStatus Specifies the regulation status of the EquivalentInjection. True is regulating. False is not regulating. regulationTarget The target voltage for voltage regulation. The attribute shall be a positive value. p Equivalent active power injection. Load sign convention is used, i.e. positive sign means flow out from a node. Starting value for steady state solutions. q Equivalent reactive power injection. Load sign convention is used, i.e. positive sign means flow out from a node. Starting value for steady state solutions. ExternalNetworkInjection This class represents the external network and it is used for IEC 60909 calculations. Description referencePriority Priority of unit for use as powerflow voltage phase angle reference bus selection. 0 = don t care (default) 1 = highest priority. 2 is less than 1 and so on. Integer An integer number. The range is unspecified and not limited. Primitive p Active power injection. Load sign convention is used, i.e. positive sign means flow out from a node. Starting value for steady state solutions. q Reactive power injection. Load sign convention is used, i.e. positive sign means flow out from a node. Starting value for steady state solutions. 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. Description 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. Description normalPF Generating unit economic participation factor. The sum of the participation factors across generating units does not have to sum to one. It is used for representing distributed slack participation factor. The attribute shall be a positive value or zero. GroundDisconnector A manually operated or motor operated mechanical switching device used for isolating a circuit or equipment from ground. Description HydroGeneratingUnit A generating unit whose prime mover is a hydraulic turbine (e.g., Francis, Pelton, Kaplan). Description IdentifiedObject This is a root class to provide common identification for all classes needing identification and naming attributes. mRID Master resource identifier issued by a model authority. The mRID is unique within an exchange context. Global uniqueness is easily achieved by using a UUID, as specified in RFC 4122, for the mRID. The use of UUID is strongly recommended. For CIMXML data files in RDF syntax conforming to IEC 61970-552, the mRID is mapped to rdf:ID or rdf:about attributes that identify CIM object elements. String A string consisting of a sequence of characters. The character encoding is UTF-8. The string length is unspecified and unlimited. Primitive 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. Description LinearShuntCompensator A linear shunt compensator has banks or sections with equal admittance values. Description LoadBreakSwitch A mechanical switching device capable of making, carrying, and breaking currents under normal operating conditions. Description 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. Description 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. Description NuclearGeneratingUnit A nuclear generating unit. Description 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. 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. 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. Description 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. Description 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. 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. Description PhaseTapChangerTabular Describes a tap changer with a table defining the relation between the tap step and the phase angle difference across the transformer. Description PowerElectronicsConnection A connection to the AC network for energy production or consumption that uses power electronics rather than rotating machines. Description p Active power injection. Load sign convention is used, i.e. positive sign means flow out from a node. Starting value for a steady state solution. q Reactive power injection. Load sign convention is used, i.e. positive sign means flow out from a node. Starting value for a steady state solution. PowerElectronicsUnit A generating unit or battery or aggregation that connects to the AC network using power electronics rather than rotating machines. 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. 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). Description RegulatingCondEq A type of conducting equipment that can regulate a quantity (i.e. voltage or flow) at a specific point in the network. Description controlEnabled Specifies the regulation status of the equipment. True is regulating, false is not regulating. 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. Description discrete The regulation is performed in a discrete mode. This applies to equipment with discrete controls, e.g. tap changers and shunt compensators. enabled The flag tells if regulation is enabled. targetDeadband This is a deadband used with discrete control to avoid excessive update of controls like tap changers and shunt compensator banks while regulating. The units of those appropriate for the mode. The attribute shall be a positive value or zero. If RegulatingControl.discrete is set to "false", the RegulatingControl.targetDeadband is to be ignored. Note that for instance, if the targetValue is 100 kV and the targetDeadband is 2 kV the range is from 99 to 101 kV. targetValue The target value specified for case input. This value can be used for the target value without the use of schedules. The value has the units appropriate to the mode attribute. targetValueUnitMultiplier Specify the multiplier for used for the targetValue. maxAllowedTargetValue Maximum allowed target value (RegulatingControl.targetValue). minAllowedTargetValue Minimum allowed target value (RegulatingControl.targetValue). RotatingMachine A rotating machine which may be used as a generator or motor. p Active power injection. Load sign convention is used, i.e. positive sign means flow out from a node. Starting value for a steady state solution. q Reactive power injection. Load sign convention is used, i.e. positive sign means flow out from a node. Starting value for a steady state solution. 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. sections Shunt compensator sections in use. Starting value for steady state solution. The attribute shall be a positive value or zero. Non integer values are allowed to support continuous variables. The reasons for continuous value are to support study cases where no discrete shunt compensators has yet been designed, a solutions where a narrow voltage band force the sections to oscillate or accommodate for a continuous solution as input. For LinearShuntConpensator the value shall be between zero and ShuntCompensator.maximumSections. At value zero the shunt compensator conductance and admittance is zero. Linear interpolation of conductance and admittance between the previous and next integer section is applied in case of non-integer values. For NonlinearShuntCompensator-s shall only be set to one of the NonlinearShuntCompenstorPoint.sectionNumber. There is no interpolation between NonlinearShuntCompenstorPoint-s. SolarGeneratingUnit A solar thermal generating unit, connected to the grid by means of a rotating machine. This class does not represent photovoltaic (PV) generation. Description 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. Description q Reactive power injection. Load sign convention is used, i.e. positive sign means flow out from a node. Starting value for a steady state solution. StationSupply Station supply with load derived from the station output. Description 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. Description open The attribute tells if the switch is considered open when used as input to topology processing. locked If true, the switch is locked. The resulting switch state is a combination of locked and Switch.open attributes as follows: <ul> <li>locked=true and Switch.open=true. The resulting state is open and locked;</li> <li>locked=false and Switch.open=true. The resulting state is open;</li> <li>locked=false and Switch.open=false. The resulting state is closed.</li> </ul> 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. Description operatingMode Current mode of operation. SynchronousMachineOperatingMode Synchronous machine operating mode. generator Operating as generator. enum condenser Operating as condenser. enum motor Operating as motor. enum referencePriority Priority of unit for use as powerflow voltage phase angle reference bus selection. 0 = don t care (default) 1 = highest priority. 2 is less than 1 and so on. TapChanger Mechanism for changing transformer winding tap positions. controlEnabled Specifies the regulation status of the equipment. True is regulating, false is not regulating. step Tap changer position. Starting step for a steady state solution. Non integer values are allowed to support continuous tap variables. The reasons for continuous value are to support study cases where no discrete tap changer has yet been designed, a solution where a narrow voltage band forces the tap step to oscillate or to accommodate for a continuous solution as input. The attribute shall be equal to or greater than lowStep and equal to or less than highStep. 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. Description Terminal An AC electrical connection point to a piece of conducting equipment. Terminals are connected at physical connection points called connectivity nodes. Description ThermalGeneratingUnit A generating unit whose prime mover could be a steam turbine, combustion turbine, or diesel engine. Description 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. Description value 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. VsConverter DC side of the voltage source converter (VSC). Description droop Droop constant. The pu value is obtained as D [kV/MW] x Sb / Ubdc. The attribute shall be a positive value. PU Per Unit - a positive or negative value referred to a defined base. Values typically range from -10 to +10. CIMDatatype value unit none multiplier none droopCompensation Compensation constant. Used to compensate for voltage drop when controlling voltage at a distant bus. The attribute shall be a positive value. Resistance Resistance (real part of impedance). CIMDatatype value unit ohm multiplier none pPccControl Kind of control of real power and/or DC voltage. VsPpccControlKind Types applicable to the control of real power and/or DC voltage by voltage source converter. pPcc Control is real power at point of common coupling. The target value is provided by ACDCConverter.targetPpcc. enum udc Control is DC voltage with target value provided by ACDCConverter.targetUdc. enum pPccAndUdcDroop Control is active power at point of common coupling and local DC voltage, with the droop. Target values are provided by ACDCConverter.targetPpcc, ACDCConverter.targetUdc and VsConverter.droop. enum pPccAndUdcDroopWithCompensation Control is active power at point of common coupling and compensated DC voltage, with the droop. Compensation factor is the resistance, as an approximation of the DC voltage of a common (real or virtual) node in the DC network. Targets are provided by ACDCConverter.targetPpcc, ACDCConverter.targetUdc, VsConverter.droop and VsConverter.droopCompensation. enum pPccAndUdcDroopPilot Control is active power at point of common coupling and the pilot DC voltage, with the droop. The mode is used for Multi Terminal High Voltage DC (MTDC) systems where multiple HVDC Substations are connected to the HVDC transmission lines. The pilot voltage is then used to coordinate the control the DC voltage across the HVDC substations. Targets are provided by ACDCConverter.targetPpcc, ACDCConverter.targetUdc and VsConverter.droop. enum phasePcc Control is phase at point of common coupling. Target is provided by VsConverter.targetPhasePcc. enum qPccControl Kind of reactive power control. VsQpccControlKind Kind of reactive power control at point of common coupling for a voltage source converter. reactivePcc Control is reactive power at point of common coupling. Target is provided by VsConverter.targetQpcc. enum voltagePcc Control is voltage at point of common coupling. Target is provided by VsConverter.targetUpcc. enum powerFactorPcc Control is power factor at point of common coupling. Target is provided by VsConverter.targetPowerFactorPcc. enum pulseWidthModulation No explicit control. Pulse-modulation factor is directly set in magnitude (VsConverter.targetPWMfactor) and phase (VsConverter.targetPhasePcc). enum qShare Reactive power sharing factor among parallel converters on Uac control. The attribute shall be a positive value or zero. 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 targetQpcc Reactive power injection target in AC grid, at point of common coupling. Load sign convention is used, i.e. positive sign means flow out from a node. targetUpcc Voltage target in AC grid, at point of common coupling. The attribute shall be a positive value. targetPowerFactorPcc Power factor target at the AC side, at point of common coupling. The attribute shall be a positive value. targetPhasePcc Phase target at AC side, at point of common coupling. The attribute shall be a positive value. targetPWMfactor Magnitude of pulse-modulation factor. The attribute shall be a positive value. 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. Description 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