CIM Extension and Profile

The CIM extensions and profile for EMT are in the emthub/emtiop repository folder:

1. emtiop.html contains the class and attribute documentation built from CIMTool

2. emtiop.owl contains the profile for CIMTool

3. emtiop.sql contains the CIMTool-generated statements to build a SQL database; these don’t work with Pythons sqlite package

4. Emtiop.xmi contains the CIM extensions, for importing into a UML editor that has the core CIM UML

5. emtiop_sqlite.sql contains hand-edits to emtiop.sql that work with sqlite

Profile Documentation

Profile namespace: http://www.ucaiug.org/profile#

Concrete Classes

ACLineSegment

Wires

A line segment is a conductor or combination of conductors, with consistent electrical characteristics along its length, building a single electrical system that carries alternating current between two points in the power system.

The BaseVoltage at the two ends of a line segment 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.

Line segment impedances can be either directly described in electrical terms or physical line detail can be provided from which impedances can be calculated.

Directly described impedances

For symmetrical, transposed three phase line segments, it is sufficient to use attributes of the line segment, which describe impedances and admittances for the entire length of the line segment. Additionally, line segment impedances can be computed by using line segment length and associated per length impedances.

Unbalanced modeling of impedances is supported by the per length phase impedance matrix (PerLengthPhaseImpedance) in conjunction with phase-to-sequence number mapping supplied by either ACLineSegmentPhase or WirePosition. The sequence numbers are referenced by the row and column attributes of the per length phase impedance matrix. This method enables single-phase and two-phase line segments, and transpositions of phases, to be described using the same per length phase impedance matrix. The length of the line segment is used in the computation of total impedance values for the line segment.

Line detail characteristics

There are three approaches to providing line detail and all use WireAssembly to supply line positions:

• Option 1 - WireAssembly supplies only line positions. ACLineSegmentPhase points to wire type and intraphase spacing and supplies the phase-to-sequence number mapping.
• Option 2 - WireAssembly supplies line position and, for each position, also supplies wire type and intraphase spacing. ACLineSegmentPhase supplies the phase-to-sequence number mapping.
• Option 3 - WireAssembly supplies line position and, for each position, also supplies wire type and intraphase spacing and phase. WireAssembly therefore supplies the phase-to-sequence number mapping and ACLineSegmentPhase is not needed.

Native Members

b0ch	1..1	Susceptance	Zero sequence shunt (charging) susceptance, uniformly distributed, of the entire line segment.
bch	1..1	Susceptance	Positive sequence shunt (charging) susceptance, uniformly distributed, of the entire line segment. This value represents the full charging over the full length of the line segment.
r	1..1	Resistance	Positive sequence series resistance of the entire line segment.
r0	1..1	Resistance	Zero sequence series resistance of the entire line segment.
x	1..1	Reactance	Positive sequence series reactance of the entire line segment.
x0	1..1	Reactance	Zero sequence series reactance of the entire line segment.

Inherited Members

length	1..1	Length	see Conductor

BaseVoltage	0..1	BaseVoltage	see ConductingEquipment

inService	1..1	Boolean	see Equipment
EquipmentContainer	1..1	EquipmentContainer	see Equipment

mRID	1..1	String	see PowerSystemResource
name	1..1	String	see PowerSystemResource

mRID	0..1	String	see IdentifiedObject
name	0..1	String	see IdentifiedObject

ACPointOfCommonCoupling

Core

Point of interconnection of the DC converter station to the adjacent AC system (IEC 60633).

Native Members

ConnectivityNode	0..1	ConnectivityNode	Connectivity node which is a point of common coupling AC.

Inherited Members

mRID	1..1	String	see PointOfCommonCoupling
name	1..1	String	see PointOfCommonCoupling

mRID	0..1	String	see IdentifiedObject
name	0..1	String	see IdentifiedObject

ApparentPowerLimit

OperationalLimits

Apparent power limit.

Native Members

value	0..1	ApparentPower	The apparent power limit. The attribute shall be a positive value or zero.

Inherited Members

mRID	1..1	String	see OperationalLimit
name	1..1	String	see OperationalLimit
OperationalLimitSet	0..1	OperationalLimitSet	see OperationalLimit
OperationalLimitType	0..1	OperationalLimitType	see OperationalLimit

mRID	0..1	String	see IdentifiedObject
name	0..1	String	see IdentifiedObject

BaseVoltage

Core

Defines a system base voltage which is referenced. This may be different than the rated voltage.

Native Members

mRID	1..1	String	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 IETF 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	1..1	String	The name is any free human readable and possibly non unique text naming the object.
nominalVoltage	1..1	Voltage	The power system resource's base voltage, expressed on a phase-to-phase (line-to-line) basis. Shall be a positive value and not zero.

Inherited Members

mRID	0..1	String	see IdentifiedObject
name	0..1	String	see IdentifiedObject

BatteryUnit

Production

An electrochemical energy storage device.

Native Members

batteryState	1..1	BatteryStateKind	The current state of the battery (charging, full, etc.).
ratedE	1..1	RealEnergy	Full energy storage capacity of the battery. The attribute shall be a positive value.
storedE	1..1	RealEnergy	Amount of energy currently stored. The attribute shall be a positive value or zero and lower than BatteryUnit.ratedE.

Inherited Members

maxP	1..1	ActivePower	see PowerElectronicsUnit
minP	1..1	ActivePower	see PowerElectronicsUnit
PowerElectronicsConnection	1..1	PowerElectronicsConnection	see PowerElectronicsUnit

inService	1..1	Boolean	see Equipment
EquipmentContainer	1..1	EquipmentContainer	see Equipment

mRID	1..1	String	see PowerSystemResource
name	1..1	String	see PowerSystemResource

mRID	0..1	String	see IdentifiedObject
name	0..1	String	see IdentifiedObject

ConnectivityNode

Core

Connectivity nodes are points where terminals of AC conducting equipment are connected together with zero impedance.

Native Members

mRID	1..1	String	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 IETF 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	1..1	String	The name is any free human readable and possibly non unique text naming the object.
ConnectivityNodeContainer	1..1	ConnectivityNodeContainer	Container of this connectivity node.

Inherited Members

mRID	0..1	String	see IdentifiedObject
name	0..1	String	see IdentifiedObject

CurveData

Core

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.

Native Members

xvalue	1..1	Float	The data value of the X-axis variable, depending on the X-axis units.
y1value	1..1	Float	The data value of the first Y-axis variable, depending on the Y-axis units.
Curve	1..1	Curve	The curve of this curve data point.

DCBreaker

DC

A breaker within a DC system.

Inherited Members

locked	0..1	Boolean	see DCSwitch
normalOpen	0..1	Boolean	see DCSwitch
open	0..1	Boolean	see DCSwitch
retained	0..1	Boolean	see DCSwitch

ratedCurrent	0..1	CurrentFlow	see DCConductingEquipment
ratedUdc	0..1	Voltage	see DCConductingEquipment

inService	1..1	Boolean	see Equipment
EquipmentContainer	1..1	EquipmentContainer	see Equipment

mRID	1..1	String	see PowerSystemResource
name	1..1	String	see PowerSystemResource

mRID	0..1	String	see IdentifiedObject
name	0..1	String	see IdentifiedObject

DCDisconnector

DC

A disconnector within a DC system.

Inherited Members

locked	0..1	Boolean	see DCSwitch
normalOpen	0..1	Boolean	see DCSwitch
open	0..1	Boolean	see DCSwitch
retained	0..1	Boolean	see DCSwitch

ratedCurrent	0..1	CurrentFlow	see DCConductingEquipment
ratedUdc	0..1	Voltage	see DCConductingEquipment

inService	1..1	Boolean	see Equipment
EquipmentContainer	1..1	EquipmentContainer	see Equipment

mRID	1..1	String	see PowerSystemResource
name	1..1	String	see PowerSystemResource

mRID	0..1	String	see IdentifiedObject
name	0..1	String	see IdentifiedObject

DCEnergySource

Emtiop

A source of DC power that is independent of the AC system, e.g., a battery or solar panel. The internal representation may include current sources, voltage sources, diodes, etc. Use DCSourceKind to provide guidance on the internal representation.

Native Members

kind	0..1	DCSourceKind
p	0..1	ActivePower	The power output, negative for load or charging.
pMax	0..1	ActivePower	Maximum power available from the primary source, e.g., photovoltaic panels or a battery.
pMaxLoad	0..1	ActivePower	Maximum load or battery charging power.
pMin	0..1	ActivePower	Minimum power available from the supply.
pMinLoad	0..1	ActivePower	Minimum load or battery charging power.
rSeries	0..1	Resistance	Series source resistance.
rShunt	0..1	Resistance	Shunt source resistance.

Inherited Members

ratedCurrent	0..1	CurrentFlow	see DCConductingEquipment
ratedUdc	0..1	Voltage	see DCConductingEquipment

inService	1..1	Boolean	see Equipment
EquipmentContainer	1..1	EquipmentContainer	see Equipment

mRID	1..1	String	see PowerSystemResource
name	1..1	String	see PowerSystemResource

mRID	0..1	String	see IdentifiedObject
name	0..1	String	see IdentifiedObject

DCEquipmentContainer

DC

A modelling construct to provide a root class for containment of DC as well as AC equipment. The class differ from the EquipmentContainer for AC in that it may also contain DCNode(-s). Hence it can contain both AC and DC equipment.

Inherited Members

mRID	1..1	String	see PowerSystemResource
name	1..1	String	see PowerSystemResource

mRID	0..1	String	see IdentifiedObject
name	0..1	String	see IdentifiedObject

DCGround

DC

A ground within a DC system.

Native Members

inductance	0..1	Inductance	Inductance to ground.
r	0..1	Resistance	Resistance to ground.

Inherited Members

ratedCurrent	0..1	CurrentFlow	see DCConductingEquipment
ratedUdc	0..1	Voltage	see DCConductingEquipment

inService	1..1	Boolean	see Equipment
EquipmentContainer	1..1	EquipmentContainer	see Equipment

mRID	1..1	String	see PowerSystemResource
name	1..1	String	see PowerSystemResource

mRID	0..1	String	see IdentifiedObject
name	0..1	String	see IdentifiedObject

DCLineSegment

DC

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.

Native Members

capacitance	0..1	Capacitance	Capacitance of the DC line segment. Significant for cables only.
inductance	0..1	Inductance	Inductance of the DC line segment. Negligible compared with DCSeriesDevice used for smoothing.
length	0..1	Length	Segment length for calculating line section capabilities.
resistance	0..1	Resistance	Resistance of the DC line segment.
PerLengthParameter	0..1	PerLengthDCLineParameter	Set of per-length parameters for this line segment.

Inherited Members

ratedCurrent	0..1	CurrentFlow	see DCConductingEquipment
ratedUdc	0..1	Voltage	see DCConductingEquipment

inService	1..1	Boolean	see Equipment
EquipmentContainer	1..1	EquipmentContainer	see Equipment

mRID	1..1	String	see PowerSystemResource
name	1..1	String	see PowerSystemResource

mRID	0..1	String	see IdentifiedObject
name	0..1	String	see IdentifiedObject

DCNode

DC

DC nodes are points where terminals of DC conducting equipment are connected together with zero impedance.

Native Members

mRID	1..1	String	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 IETF 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	1..1	String	The name is any free human readable and possibly non unique text naming the object.
DCEquipmentContainer	0..1	DCEquipmentContainer	The DC container for the DC nodes.

Inherited Members

mRID	0..1	String	see IdentifiedObject
name	0..1	String	see IdentifiedObject

DCSeriesDevice

DC

A series device within the DC system, typically a reactor used for filtering or smoothing. Needed for transient and short circuit studies.

Native Members

inductance	0..1	Inductance	Inductance of the device.
resistance	0..1	Resistance	Resistance of the DC device.

Inherited Members

ratedCurrent	0..1	CurrentFlow	see DCConductingEquipment
ratedUdc	0..1	Voltage	see DCConductingEquipment

inService	1..1	Boolean	see Equipment
EquipmentContainer	1..1	EquipmentContainer	see Equipment

mRID	1..1	String	see PowerSystemResource
name	1..1	String	see PowerSystemResource

mRID	0..1	String	see IdentifiedObject
name	0..1	String	see IdentifiedObject

DCShunt

DC

A shunt device within the DC system, typically used for filtering. Needed for transient and short circuit studies.

Native Members

capacitance	0..1	Capacitance	Capacitance of the DC shunt.
resistance	0..1	Resistance	Resistance of the DC device.

Inherited Members

ratedCurrent	0..1	CurrentFlow	see DCConductingEquipment
ratedUdc	0..1	Voltage	see DCConductingEquipment

inService	1..1	Boolean	see Equipment
EquipmentContainer	1..1	EquipmentContainer	see Equipment

mRID	1..1	String	see PowerSystemResource
name	1..1	String	see PowerSystemResource

mRID	0..1	String	see IdentifiedObject
name	0..1	String	see IdentifiedObject

DCTerminal

DC

An electrical connection point to generic DC conducting equipment.

Native Members

polarity	0..1	DCTerminalPolarityKind	Represents the normal network polarity condition. Used in DC system configurations that have explicit polarity of the terminals, e.g., voltage source converter (VSC) technology.
DCConductingEquipment	0..1	DCConductingEquipment	An DC terminal belong to a DC conducting equipment.

Inherited Members

DCNode	1..1	DCNode	see DCBaseTerminal

sequenceNumber	1..1	Integer	see ACDCTerminal

mRID	0..1	String	see IdentifiedObject
name	0..1	String	see IdentifiedObject

DetailedModelDynamics

DetailedModelDescription

The main class that packages all related to this detailed model. This includes all parameters, functions, signals, etc.

Native Members

DetailedModelTypeDynamics	0..1	DetailedModelTypeDynamics	The type of detailed model dynamics that is applied to the detailed model dynamics.
DynamicsFunctionBlock	0..1	DynamicsFunctionBlock	The dynamics function block for this detailed model dynamics.
Equipment	0..1	Equipment	The equipment which behaviour this detailed model dynamics represents.

Inherited Members

mRID	1..1	String	see DynamicsFunctionBlock
enabled	1..1	Boolean	see DynamicsFunctionBlock
name	1..1	String	see DynamicsFunctionBlock

mRID	0..1	String	see IdentifiedObject
name	0..1	String	see IdentifiedObject

DiagramObjectPoint

DiagramLayout

A point in a given space defined by 3 coordinates and associated to a diagram object. The coordinates may be positive or negative as the origin does not have to be in the corner of a diagram.

Native Members

sequenceNumber	1..1	Integer	The sequence position of the point, used for defining the order of points for diagram objects acting as a polyline or polygon with more than one point. The attribute shall be a positive value.
xPosition	1..1	Float	The X coordinate of this point.
yPosition	1..1	Float	The Y coordinate of this point.
DiagramObject	1..1	DiagramObject	The diagram object with which the points are associated.

DisconnectingCircuitBreaker

Wires

A circuit breaking device including disconnecting function, eliminating the need for separate disconnectors.

Inherited Members

BaseVoltage	0..1	BaseVoltage	see ConductingEquipment

inService	1..1	Boolean	see Equipment
EquipmentContainer	1..1	EquipmentContainer	see Equipment

mRID	1..1	String	see PowerSystemResource
name	1..1	String	see PowerSystemResource

mRID	0..1	String	see IdentifiedObject
name	0..1	String	see IdentifiedObject

EnergyConsumer

Wires

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.

Native Members

p	1..1	ActivePower	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	1..1	ReactivePower	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.
LoadResponse	1..1	LoadResponseCharacteristic	The load response characteristic of this load. If missing, this load is assumed to be constant power.

Inherited Members

BaseVoltage	0..1	BaseVoltage	see ConductingEquipment

inService	1..1	Boolean	see Equipment
EquipmentContainer	1..1	EquipmentContainer	see Equipment

mRID	1..1	String	see PowerSystemResource
name	1..1	String	see PowerSystemResource

mRID	0..1	String	see IdentifiedObject
name	0..1	String	see IdentifiedObject

EnergySource

Wires

A generic equivalent for an energy supplier on a transmission or distribution voltage level.

Native Members

nominalVoltage	1..1	Voltage	Phase-to-phase nominal voltage.
r	1..1	Resistance	Positive sequence Thevenin resistance.
r0	1..1	Resistance	Zero sequence Thevenin resistance.
voltageAngle	1..1	AngleRadians	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.
voltageMagnitude	1..1	Voltage	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.
x	1..1	Reactance	Positive sequence Thevenin reactance.
x0	1..1	Reactance	Zero sequence Thevenin reactance.

Inherited Members

BaseVoltage	0..1	BaseVoltage	see ConductingEquipment

inService	1..1	Boolean	see Equipment
EquipmentContainer	1..1	EquipmentContainer	see Equipment

mRID	1..1	String	see PowerSystemResource
name	1..1	String	see PowerSystemResource

mRID	0..1	String	see IdentifiedObject
name	0..1	String	see IdentifiedObject

EquipmentContainer

Core

A modelling construct to provide a root class for containing equipment.

Inherited Members

mRID	1..1	String	see PowerSystemResource
name	1..1	String	see PowerSystemResource

mRID	0..1	String	see IdentifiedObject
name	0..1	String	see IdentifiedObject

HydroGeneratingUnit

Production

A generating unit whose prime mover is a hydraulic turbine (e.g. Francis, Pelton, Kaplan).

Inherited Members

maxOperatingP	1..1	ActivePower	see GeneratingUnit
minOperatingP	1..1	ActivePower	see GeneratingUnit

inService	1..1	Boolean	see Equipment
EquipmentContainer	1..1	EquipmentContainer	see Equipment

mRID	1..1	String	see PowerSystemResource
name	1..1	String	see PowerSystemResource

mRID	0..1	String	see IdentifiedObject
name	0..1	String	see IdentifiedObject

IBRPlant

Emtiop

An inverter-based resource (IBR) plant comprising a collection of components, e.g., a PowerElectronicsConnection with associated controls and GeneratingUnit, one or more PowerTransformers, one or more DisconnectingCircuitBreakers, and one or more ACLineSegments. The components may also include AC filter and DC bus modeling.

Native Members

switchingFrequency	0..1	Frequency	PWM switching frequency.

Inherited Members

ACPointOfCommonCoupling	0..1	ACPointOfCommonCoupling	see ConnectedFacility
Equipments	0..unbounded	Equipment	see ConnectedFacility

mRID	1..1	String	see PowerSystemResource
name	1..1	String	see PowerSystemResource

mRID	0..1	String	see IdentifiedObject
name	0..1	String	see IdentifiedObject

IEEECigreDLL

Emtiop

A dynamic link library (DLL) interface for inverter-based resource (IBR) control, as defined in Cigre Technical Brochure TB 958 and IEEE Standards Association P3597.

Native Members

firmwareInstalled	0..1	DateTime	Date and time of the firmware installation at the IBR plant. The DLL is expected to represent this version of the firmware.
firmwareVersion	0..1	String	Version of the hardware provider's firmware, or the model provider's code.
snapshotUri	0..1	String	Location of the optional snapshot file for initializing the DLL from a saved state. Either a universal resource identifier or network-accessible filename.
supportsEMT	0..1	Boolean	True if the DLL supports EMT simulation.
supportsRMS	0..1	Boolean	True if the DLL supports RMS, i.e., phasor domain, simulation.
timestep	0..1	Seconds	Hard-coded simulation time step for this DLL.
uri	0..1	String	Location of the DLL, e.g., a universal resource identifier or network-accessible filename.
vendorName	0..1	String	Name of the model (code) provider.

Inherited Members

DetailedModelTypeDynamics	0..1	DetailedModelTypeDynamics	see DetailedModelDynamics
DynamicsFunctionBlock	0..1	DynamicsFunctionBlock	see DetailedModelDynamics
Equipment	0..1	Equipment	see DetailedModelDynamics

mRID	1..1	String	see DynamicsFunctionBlock
enabled	1..1	Boolean	see DynamicsFunctionBlock
name	1..1	String	see DynamicsFunctionBlock

mRID	0..1	String	see IdentifiedObject
name	0..1	String	see IdentifiedObject

IEEECigreDLLInput

Emtiop

Connects the set of DLL input signals, as defined in its API, to points in the network model.

Native Members

kind	0..1	IEEECigreDLLInputKind	The type of input signal. If remoteInputSignal, supply the RemoteInputSignal association. The phase attribute is required for acTerminalVoltage, acCurrentVsc, and acCurrentGrid. If apiDefined, the DLL must be queried through its API for more information.

Inherited Members

multiplier	0..1	UnitMultiplier	see IEEECigreDLLSignal
name	0..1	String	see IEEECigreDLLSignal
parameterKind	0..1	IEEECigreDLLParameterKind	see IEEECigreDLLSignal
phase	0..1	SinglePhaseKind	see IEEECigreDLLSignal
sequenceNumber	0..1	Integer	see IEEECigreDLLSignal
unit	0..1	UnitSymbol	see IEEECigreDLLSignal
width	0..1	Integer	see IEEECigreDLLSignal
ConnectivityNode	0..1	ConnectivityNode	see IEEECigreDLLSignal
DCNode	0..1	DCNode	see IEEECigreDLLSignal

ACDCTerminal	0..1	ACDCTerminal	see SignalDescriptor
DynamicsFunctionBlock	0..1	DynamicsFunctionBlock	see SignalDescriptor

mRID	0..1	String	see DetailedModelDescriptor
DetailedModelTypeDynamics	0..1	DetailedModelTypeDynamics	see DetailedModelDescriptor

mRID	0..1	String	see IdentifiedObject
name	0..1	String	see IdentifiedObject

IEEECigreDLLOutput

Emtiop

Connects the set of DLL output signals, as defined in its API, to points in the network model.

Native Members

kind	0..1	IEEECigreDLLOutputKind	The type of output signal. The phase attribute must be supplied with modulationIndex and vscVoltage. If apiDefined, obtain more information from the DLL API.

Inherited Members

multiplier	0..1	UnitMultiplier	see IEEECigreDLLSignal
name	0..1	String	see IEEECigreDLLSignal
parameterKind	0..1	IEEECigreDLLParameterKind	see IEEECigreDLLSignal
phase	0..1	SinglePhaseKind	see IEEECigreDLLSignal
sequenceNumber	0..1	Integer	see IEEECigreDLLSignal
unit	0..1	UnitSymbol	see IEEECigreDLLSignal
width	0..1	Integer	see IEEECigreDLLSignal
ConnectivityNode	0..1	ConnectivityNode	see IEEECigreDLLSignal
DCNode	0..1	DCNode	see IEEECigreDLLSignal

ACDCTerminal	0..1	ACDCTerminal	see SignalDescriptor
DynamicsFunctionBlock	0..1	DynamicsFunctionBlock	see SignalDescriptor

mRID	0..1	String	see DetailedModelDescriptor
DetailedModelTypeDynamics	0..1	DetailedModelTypeDynamics	see DetailedModelDescriptor

mRID	0..1	String	see IdentifiedObject
name	0..1	String	see IdentifiedObject

IEEECigreDLLParameter

Emtiop

A single value in the array of DLL input values. The meaning of this parameter is discoverable through the DLL's application program interface (API) and/or documentation provided with the DLL. This CIM class maintains only the essential parameter setting and location/size in the array of DLL inputs.

Native Members

parameterKind	0..1	IEEECigreDLLParameterKind	The C type of this parameter as expected by the DLL application program interface (API). This also determines the memory size of this parameter in the array of DLL inputs.
sequenceNumber	0..1	Integer	The zero-based array index for this parameter, as expected in the DLL's application program interface (API).
value	0..1	String	The parameter value, to be parsed from string format according to the parameterKind.
IEEECigreDLL	0..1	IEEECigreDLL	The DLL associated with this parameter.

LinearShuntCompensator

Wires

A linear shunt compensator has banks or sections with equal admittance values.

Native Members

bPerSection	1..1	Susceptance	Positive sequence shunt (charging) susceptance per section.
gPerSection	1..1	Conductance	Positive sequence shunt (charging) conductance per section.

Inherited Members

grounded	1..1	Boolean	see ShuntCompensator
maximumSections	1..1	Integer	see ShuntCompensator
nomU	1..1	Voltage	see ShuntCompensator
phaseConnection	0..1	PhaseShuntConnectionKind	see ShuntCompensator
sections	1..1	Float	see ShuntCompensator

BaseVoltage	0..1	BaseVoltage	see ConductingEquipment

inService	1..1	Boolean	see Equipment
EquipmentContainer	1..1	EquipmentContainer	see Equipment

mRID	1..1	String	see PowerSystemResource
name	1..1	String	see PowerSystemResource

mRID	0..1	String	see IdentifiedObject
name	0..1	String	see IdentifiedObject

LoadResponseCharacteristic

LoadModel

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

pInjection = Pnominal* (Frequency/(Nominal frequency))**cim:LoadResponseCharacteristic.pFrequencyExponent

qInjection = Qnominal* (Frequency/(Nominal frequency))**cim:LoadResponseCharacteristic.qFrequencyExponent

Note that both voltage and frequency exponents could be used together so the full equation would be:

pInjection = Pnominal* (Voltage/(cim:BaseVoltage.nominalVoltage))**cim:LoadResponseCharacteristic.pVoltageExponent * (Frequency/(base frequency))**cim:LoadResponseCharacteristic.pFrequencyExponent

qInjection = Qnominal* (Voltage/(cim:BaseVoltage.nominalVoltage))**cim:LoadResponseCharacteristic.qVoltageExponent * (Frequency/(base frequency))**cim:LoadResponseCharacteristic.qFrequencyExponent

The voltage and frequency expressed in the equation are values obtained from solved power flow. Base voltage and base frequency are those derived from the connectivity of the static network model.

Where:

1) * means "multiply" and ** is "raised to the 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.

Native Members

exponentModel	1..1	Boolean	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	1..1	Float	Portion of active power load modelled as constant current.
pConstantImpedance	1..1	Float	Portion of active power load modelled as constant impedance.
pConstantPower	1..1	Float	Portion of active power load modelled as constant power.
pFrequencyExponent	1..1	Float	Exponent of per unit frequency effecting active power.
pVoltageExponent	1..1	Float	Exponent of per unit voltage effecting real power.
qConstantCurrent	1..1	Float	Portion of reactive power load modelled as constant current.
qConstantImpedance	1..1	Float	Portion of reactive power load modelled as constant impedance.
qConstantPower	1..1	Float	Portion of reactive power load modelled as constant power.
qFrequencyExponent	1..1	Float	Exponent of per unit frequency effecting reactive power.
qVoltageExponent	1..1	Float	Exponent of per unit voltage effecting reactive power.

Inherited Members

mRID	0..1	String	see IdentifiedObject
name	0..1	String	see IdentifiedObject

MachineSaturation

Emtiop

Use to define machine saturation with more than two points.

Native Members

SynchronousMachineDetailed	0..1	SynchronousMachineDetailed	The machine this saturation characteristic applies to.

Inherited Members

mRID	1..1	String	see Curve
curveStyle	0..1	CurveStyle	see Curve
name	1..1	String	see Curve
xMultiplier	0..1	UnitMultiplier	see Curve
xUnit	0..1	UnitSymbol	see Curve
y1Multiplier	0..1	UnitMultiplier	see Curve
y1Unit	0..1	UnitSymbol	see Curve

mRID	0..1	String	see IdentifiedObject
name	0..1	String	see IdentifiedObject

NERCDynamicModel

Emtiop

Parameterized models from software libraries or user code that rely on documentation provided elsewhere, e.g., software documentation. The model is named within the domain of nameKind, e.g., ST6B for PSSE or esst6b for PSLF. Parameters are maintained by name and sequence number in the NERCDynamicModelParameter class.

Native Members

closestStandardModel	0..1	String	Name of the closest match from Dynamics / StandardModels, if such a match exists.
modelKind	0..1	NERCModelKind	Suggested application of this dynamic model.
nameKind	0..1	NERCModelNameKind
statusKind	0..1	NERCModelStatusKind

Inherited Members

NuclearGeneratingUnit

Production

A nuclear generating unit.

Inherited Members

maxOperatingP	1..1	ActivePower	see GeneratingUnit
minOperatingP	1..1	ActivePower	see GeneratingUnit

inService	1..1	Boolean	see Equipment
EquipmentContainer	1..1	EquipmentContainer	see Equipment

mRID	1..1	String	see PowerSystemResource
name	1..1	String	see PowerSystemResource

mRID	0..1	String	see IdentifiedObject
name	0..1	String	see IdentifiedObject

OperationalLimitSet

OperationalLimits

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.

Native Members

mRID	1..1	String	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 IETF 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	1..1	String	The name is any free human readable and possibly non unique text naming the object.
Terminal	1..1	ACDCTerminal	The terminal where the operational limit set apply.

OperationalLimitType

OperationalLimits

The operational meaning of a category of limits.

Native Members

mRID	1..1	String	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 IETF 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.
acceptableDuration	0..1	Seconds	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	0..1	OperationalLimitDirectionKind	The direction of the limit.
isInfiniteDuration	0..1	Boolean	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.
name	1..1	String	The name is any free human readable and possibly non unique text naming the object.

ParameterDescriptor

DetailedModelDescription

Supports definition of one or more parameters of several different datatypes for use by the detailed model. It describes the parameters used in the equations of the detailed model.

The name of the parameter shall be the same as the name used in the equations of the detailed model.

Native Members

engineeringUnit	0..1	String	The engineering unit of the value.
sequenceNumber	0..1	Integer	Sequence number of the parameter among the set of parameters associated with the related proprietary user-defined model.
typicalValue	0..1	String	Typical value for the parameter. The datatype is as specified in attribute valueXSDdatatype.

Inherited Members

mRID	0..1	String	see DetailedModelDescriptor
DetailedModelTypeDynamics	0..1	DetailedModelTypeDynamics	see DetailedModelDescriptor

mRID	0..1	String	see IdentifiedObject
name	0..1	String	see IdentifiedObject

ParameterValue

DetailedModelDescription

Provides the value of a given parameter of a detailed model dynamics.

Native Members

value	0..1	String	The value of the parameter.
DetailedModelDynamics	0..1	DetailedModelDynamics	The detailed model to which this parameter value applies.
ParameterDescriptor	0..1	ParameterDescriptor	The parameter descriptor that has this value.

PhotoVoltaicUnit

Production

A photovoltaic device or an aggregation of such devices.

Inherited Members

maxP	1..1	ActivePower	see PowerElectronicsUnit
minP	1..1	ActivePower	see PowerElectronicsUnit
PowerElectronicsConnection	1..1	PowerElectronicsConnection	see PowerElectronicsUnit

inService	1..1	Boolean	see Equipment
EquipmentContainer	1..1	EquipmentContainer	see Equipment

mRID	1..1	String	see PowerSystemResource
name	1..1	String	see PowerSystemResource

mRID	0..1	String	see IdentifiedObject
name	0..1	String	see IdentifiedObject

PowerElectronicsConnection

Wires

A connection to the AC network for energy production or consumption that uses power electronics rather than rotating machines.

Native Members

maxIFault	1..1	PU	Maximum fault current this device will contribute, in per-unit of rated current, before the converter protection will trip or bypass.
maxQ	1..1	ReactivePower	Maximum reactive power limit. This is the maximum (nameplate) limit for the unit.
minQ	1..1	ReactivePower	Minimum reactive power limit for the unit. This is the minimum (nameplate) limit for the unit.
p	1..1	ActivePower	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	1..1	ReactivePower	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.
ratedS	1..1	ApparentPower	Nameplate apparent power rating for the unit. The attribute shall have a positive value.
ratedU	1..1	Voltage	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.

Inherited Members

BaseVoltage	0..1	BaseVoltage	see ConductingEquipment

inService	1..1	Boolean	see Equipment
EquipmentContainer	1..1	EquipmentContainer	see Equipment

mRID	1..1	String	see PowerSystemResource
name	1..1	String	see PowerSystemResource

mRID	0..1	String	see IdentifiedObject
name	0..1	String	see IdentifiedObject

PowerElectronicsConnectionDCTerminal

Emtiop

A DC connection point at the converter, which is also connected on the AC side as any other AC ConductingEquipment. This special terminal is separate from the regular DCTerminal to restrict the connection, such that no other DC conducting equipment can be connected to the AC side.

Native Members

polarity	0..1	DCTerminalPolarityKind	Use to indicated positive or negative polarity on the DC side.
PowerElectronicsConnection	0..1	PowerElectronicsConnection	The PowerElectronicsConnection for this terminal.

Inherited Members

DCNode	1..1	DCNode	see DCBaseTerminal

sequenceNumber	1..1	Integer	see ACDCTerminal

mRID	0..1	String	see IdentifiedObject
name	0..1	String	see IdentifiedObject

PowerElectronicsWindUnit

Production

A wind generating unit that connects to the AC network with power electronics rather than rotating machines or an aggregation of such units.

Inherited Members

maxP	1..1	ActivePower	see PowerElectronicsUnit
minP	1..1	ActivePower	see PowerElectronicsUnit
PowerElectronicsConnection	1..1	PowerElectronicsConnection	see PowerElectronicsUnit

inService	1..1	Boolean	see Equipment
EquipmentContainer	1..1	EquipmentContainer	see Equipment

mRID	1..1	String	see PowerSystemResource
name	1..1	String	see PowerSystemResource

mRID	0..1	String	see IdentifiedObject
name	0..1	String	see IdentifiedObject

PowerTransformer

Wires

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.

Native Members

vectorGroup	1..1	String	Vector group of the transformer for protective relaying, e.g., Dyn1. For unbalanced transformers, this may not be simply determined from the constituent winding connections and phase angle displacements. The vectorGroup string consists of the following components in the order listed: high voltage winding connection, mid voltage winding connection (for three winding transformers), phase displacement clock number from 0 to 11, low voltage winding connection phase displacement clock number from 0 to 11. The winding connections are D (delta), Y (wye), YN (wye with neutral), Z (zigzag), ZN (zigzag with neutral), A (auto transformer). Upper case means the high voltage, lower case mid or low. The high voltage winding always has clock position 0 and is not included in the vector group string. Some examples: YNy0 (two winding wye to wye with no phase displacement), YNd11 (two winding wye to delta with 330 degrees phase displacement), YNyn0d5 (three winding transformer wye with neutral high voltage, wye with neutral mid voltage and no phase displacement, delta low voltage with 150 degrees displacement). Phase displacement is defined as the angular difference between the phasors representing the voltages between the neutral point (real or imaginary) and the corresponding terminals of two windings, a positive sequence voltage system being applied to the high-voltage terminals, following each other in alphabetical sequence if they are lettered, or in numerical sequence if they are numbered: the phasors are assumed to rotate in a counter-clockwise sense.

Inherited Members

BaseVoltage	0..1	BaseVoltage	see ConductingEquipment

inService	1..1	Boolean	see Equipment
EquipmentContainer	1..1	EquipmentContainer	see Equipment

mRID	1..1	String	see PowerSystemResource
name	1..1	String	see PowerSystemResource

mRID	0..1	String	see IdentifiedObject
name	0..1	String	see IdentifiedObject

PowerTransformerEnd

Wires

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) two PowerTransformerEnd-s shall be defined for a two Terminal PowerTransformer even if the two PowerTransformerEnd-s have the same rated voltage. The high voltage PowerTransformerEnd (TransformerEnd.endNumber=1) is the one used to exchange resistances (r, r0) and reactances (x, x0) of the PowerTransformer while the low voltage PowerTransformerEnd (TransformerEnd.endNumber=2) shall have zero impedance values.

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).

Native Members

connectionKind	1..1	WindingConnection	Kind of connection.
phaseAngleClock	1..1	Integer	Terminal voltage phase angle displacement where 360 degrees are represented with clock hours. The valid values are 0 to 11. For example, for the secondary side end of a transformer with vector group code of 'Dyn11', specify the connection kind as wye with neutral and specify the phase angle of the clock as 11. The clock value of the transformer end number specified as 1, is assumed to be zero. Note the transformer end number is not assumed to be the same as the terminal sequence number.
ratedS	1..1	ApparentPower	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.
ratedU	1..1	Voltage	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.
PowerTransformer	1..1	PowerTransformer	The power transformer of this power transformer end.

Inherited Members

mRID	1..1	String	see TransformerEnd
endNumber	1..1	Integer	see TransformerEnd
grounded	1..1	Boolean	see TransformerEnd
name	1..1	String	see TransformerEnd
rground	1..1	Resistance	see TransformerEnd
xground	1..1	Reactance	see TransformerEnd
BaseVoltage	1..1	BaseVoltage	see TransformerEnd
Terminal	1..1	Terminal	see TransformerEnd

mRID	0..1	String	see IdentifiedObject
name	0..1	String	see IdentifiedObject

RatioTapChanger

Wires

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).

Native Members

stepVoltageIncrement	1..1	PerCent	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.
TransformerEnd	1..1	TransformerEnd	The transformer end for this additional ratio tap changer.

Inherited Members

highStep	0..1	Integer	see TapChanger
lowStep	0..1	Integer	see TapChanger
neutralStep	0..1	Integer	see TapChanger
neutralU	0..1	Voltage	see TapChanger
normalStep	0..1	Integer	see TapChanger
step	1..1	Float	see TapChanger

mRID	1..1	String	see PowerSystemResource
name	1..1	String	see PowerSystemResource

mRID	0..1	String	see IdentifiedObject
name	0..1	String	see IdentifiedObject

RotatingMachinePlant

Emtiop

A conventional generating plant, e.g., SynchronousMachine with associated controls and GeneratingUnit, a PowerTransformer, and a DisconnectingCircuitBreaker for thermal and hydro plants.

Inherited Members

ACPointOfCommonCoupling	0..1	ACPointOfCommonCoupling	see ConnectedFacility
Equipments	0..unbounded	Equipment	see ConnectedFacility

mRID	1..1	String	see PowerSystemResource
name	1..1	String	see PowerSystemResource

mRID	0..1	String	see IdentifiedObject
name	0..1	String	see IdentifiedObject

SeriesCompensator

Wires

A Series Compensator is a series capacitor or reactor or an AC transmission line without charging susceptance. It is a two terminal device.

Native Members

r	1..1	Resistance	Positive sequence resistance.
r0	1..1	Resistance	Zero sequence resistance.
x	1..1	Reactance	Positive sequence reactance.
x0	1..1	Reactance	Zero sequence reactance.

Inherited Members

BaseVoltage	0..1	BaseVoltage	see ConductingEquipment

inService	1..1	Boolean	see Equipment
EquipmentContainer	1..1	EquipmentContainer	see Equipment

mRID	1..1	String	see PowerSystemResource
name	1..1	String	see PowerSystemResource

mRID	0..1	String	see IdentifiedObject
name	0..1	String	see IdentifiedObject

SvPowerFlow

StateVariables

State variable for power flow. Load convention is used for flow direction. This means flow out from the TopologicalNode into the equipment is positive.

Native Members

p	0..1	ActivePower	The active power flow. Load sign convention is used, i.e. positive sign means flow out from a TopologicalNode (bus) into the conducting equipment.
q	0..1	ReactivePower	The reactive power flow. Load sign convention is used, i.e. positive sign means flow out from a TopologicalNode (bus) into the conducting equipment.
Terminal	0..1	Terminal	The terminal associated with the power flow state variable.

Inherited Members

SvShuntCompensatorSections

StateVariables

State variable for the number of sections in service for a shunt compensator.

Native Members

phase	0..1	SinglePhaseKind	The terminal phase at which the connection is applied. If missing, the injection is assumed to be balanced among non-neutral phases.
sections	0..1	Float	The number of sections in service as a continuous variable. The attribute shall be a positive value or zero. To get integer value scale with ShuntCompensator.bPerSection.
ShuntCompensator	0..1	ShuntCompensator	The shunt compensator for which the state applies.

Inherited Members

SvStatus

StateVariables

State variable for status.

Native Members

inService	0..1	Boolean	The in service status as a result of topology processing. It indicates if the equipment is considered as energized by the power flow. It reflects if the equipment is connected within a solvable island. It does not necessarily reflect whether or not the island was solved by the power flow.
phase	0..1	SinglePhaseKind	The individual phase status. If the attribute is unspecified, then three phase model is assumed.
ConductingEquipment	0..1	ConductingEquipment	The conducting equipment associated with the status state variable.

Inherited Members

SvSwitch

StateVariables

State variable for switch.

Native Members

open	0..1	Boolean	The attribute tells if the computed state of the switch is considered open.
phase	0..1	SinglePhaseKind	The terminal phase at which the connection is applied. If missing, the injection is assumed to be balanced among non-neutral phases.
Switch	0..1	Switch	The switch associated with the switch state.

Inherited Members

SvTapStep

StateVariables

State variable for transformer tap step.

Native Members

position	0..1	Float	The floating point tap position. This is not the tap ratio, but rather the tap step position as defined by the related tap changer model and normally is constrained to be within the range of minimum and maximum tap positions.
TapChanger	0..1	TapChanger	The tap changer associated with the tap step state.

Inherited Members

SvVoltage

StateVariables

State variable for voltage.

Native Members

angle	0..1	AngleDegrees	The voltage angle of the topological node complex voltage with respect to system reference.
v	0..1	Voltage	The voltage magnitude at the topological node. The attribute shall be a positive value.
ConnectivityNode	0..1	ConnectivityNode	The ConnectivityNode associated with this State Voltage.

Inherited Members

SynchronousMachine

Wires

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.

Native Members

earthing	1..1	Boolean	Indicates whether or not the generator is earthed. Used for short circuit data exchange according to IEC 60909.
earthingStarPointR	1..1	Resistance	Generator star point earthing resistance (Re). Used for short circuit data exchange according to IEC 60909.
earthingStarPointX	1..1	Reactance	Generator star point earthing reactance (Xe). Used for short circuit data exchange according to IEC 60909.
maxQ	1..1	ReactivePower	Maximum reactive power limit. This is the maximum (nameplate) limit for the unit.
minQ	1..1	ReactivePower	Minimum reactive power limit for the unit.
operatingMode	1..1	SynchronousMachineOperatingMode	Current mode of operation.
type	1..1	SynchronousMachineKind	Modes that this synchronous machine can operate in.

Inherited Members

p	1..1	ActivePower	see RotatingMachine
q	1..1	ReactivePower	see RotatingMachine
ratedS	1..1	ApparentPower	see RotatingMachine
ratedU	1..1	Voltage	see RotatingMachine
GeneratingUnit	1..1	GeneratingUnit	see RotatingMachine

BaseVoltage	0..1	BaseVoltage	see ConductingEquipment

inService	1..1	Boolean	see Equipment
EquipmentContainer	1..1	EquipmentContainer	see Equipment

mRID	1..1	String	see PowerSystemResource
name	1..1	String	see PowerSystemResource

mRID	0..1	String	see IdentifiedObject
name	0..1	String	see IdentifiedObject

SynchronousMachineSimplified

SynchronousMachineDynamics

The simplified model represents a synchronous generator as a constant internal voltage behind an impedance (Rs + jXp) as shown in the Simplified diagram.

Since internal voltage is held constant, there is no Efd input and any excitation system model will be ignored. There is also no Ifd output.

This model should not be used for representing a real generator except, perhaps, small generators whose response is insignificant.

The parameters used for the simplified model include:

- RotatingMachineDynamics.damping (D);

- RotatingMachineDynamics.inertia (H);

- RotatingMachineDynamics.statorLeakageReactance (used to exchange jXp for SynchronousMachineSimplified);

- RotatingMachineDynamics.statorResistance (Rs).

Inherited Members

SynchronousMachine	0..1	SynchronousMachine	see SynchronousMachineDynamics

damping	1..1	Float	see RotatingMachineDynamics
inertia	1..1	Seconds	see RotatingMachineDynamics
statorLeakageReactance	1..1	PU	see RotatingMachineDynamics
statorResistance	1..1	PU	see RotatingMachineDynamics

mRID	1..1	String	see DynamicsFunctionBlock
enabled	1..1	Boolean	see DynamicsFunctionBlock
name	1..1	String	see DynamicsFunctionBlock

mRID	0..1	String	see IdentifiedObject
name	0..1	String	see IdentifiedObject

SynchronousMachineTimeConstantReactance

SynchronousMachineDynamics

Synchronous machine detailed modelling types are defined by the combination of the attributes SynchronousMachineTimeConstantReactance.modelType and SynchronousMachineTimeConstantReactance.rotorType.

Parameter details:

1. The “p” in the time-related attribute names is a substitution for a “prime” in the usual parameter notation, e.g. tpdo refers to T'do.

Native Members

ks	1..1	Float	Saturation loading correction factor (Ks) (>= 0). Used only by type J model. Typical value = 0.
modelType	1..1	SynchronousMachineModelKind	Type of synchronous machine model used in dynamic simulation applications.
rotorType	1..1	RotorKind	Type of rotor on physical machine.
tc	1..1	Seconds	Damping time constant for “Canay” reactance (>= 0). Typical value = 0.
tpdo	1..1	Seconds	Direct-axis transient rotor time constant (T'do) (> SynchronousMachineTimeConstantReactance.tppdo). Typical value = 5.
tppdo	1..1	Seconds	Direct-axis subtransient rotor time constant (T''do) (> 0). Typical value = 0,03.
tppqo	1..1	Seconds	Quadrature-axis subtransient rotor time constant (T''qo) (> 0). Typical value = 0,03.
tpqo	1..1	Seconds	Quadrature-axis transient rotor time constant (T'qo) (> SynchronousMachineTimeConstantReactance.tppqo). Typical value = 0,5.
xDirectSubtrans	1..1	PU	Direct-axis subtransient reactance (unsaturated) (X''d) (> RotatingMachineDynamics.statorLeakageReactance). Typical value = 0,2.
xDirectSync	1..1	PU	Direct-axis synchronous reactance (Xd) (>= SynchronousMachineTimeConstantReactance.xDirectTrans). The quotient of a sustained value of that AC component of armature voltage that is produced by the total direct-axis flux due to direct-axis armature current and the value of the AC component of this current, the machine running at rated speed. Typical value = 1,8.
xDirectTrans	1..1	PU	Direct-axis transient reactance (unsaturated) (X'd) (>= SynchronousMachineTimeConstantReactance.xDirectSubtrans). Typical value = 0,5.
xQuadSubtrans	1..1	PU	Quadrature-axis subtransient reactance (X''q) (> RotatingMachineDynamics.statorLeakageReactance). Typical value = 0,2.
xQuadSync	1..1	PU	Quadrature-axis synchronous reactance (Xq) (>= SynchronousMachineTimeConstantReactance.xQuadTrans). The ratio of the component of reactive armature voltage, due to the quadrature-axis component of armature current, to this component of current, under steady state conditions and at rated frequency. Typical value = 1,6.
xQuadTrans	1..1	PU	Quadrature-axis transient reactance (X'q) (>= SynchronousMachineTimeConstantReactance.xQuadSubtrans). Typical value = 0,3.

Inherited Members

efdBaseRatio	1..1	Float	see SynchronousMachineDetailed
ifdBaseType	1..1	IfdBaseKind	see SynchronousMachineDetailed
saturationFactor	1..1	Float	see SynchronousMachineDetailed
saturationFactor120	1..1	Float	see SynchronousMachineDetailed
saturationFactor120QAxis	1..1	Float	see SynchronousMachineDetailed
saturationFactorQAxis	1..1	Float	see SynchronousMachineDetailed

SynchronousMachine	0..1	SynchronousMachine	see SynchronousMachineDynamics

damping	1..1	Float	see RotatingMachineDynamics
inertia	1..1	Seconds	see RotatingMachineDynamics
statorLeakageReactance	1..1	PU	see RotatingMachineDynamics
statorResistance	1..1	PU	see RotatingMachineDynamics

mRID	1..1	String	see DynamicsFunctionBlock
enabled	1..1	Boolean	see DynamicsFunctionBlock
name	1..1	String	see DynamicsFunctionBlock

mRID	0..1	String	see IdentifiedObject
name	0..1	String	see IdentifiedObject

Terminal

Core

An AC electrical connection point to a piece of conducting equipment. Terminals are connected at physical connection points called connectivity nodes.

Native Members

ConductingEquipment	1..1	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.
ConnectivityNode	1..1	ConnectivityNode	The connectivity node to which this terminal connects with zero impedance.

Inherited Members

sequenceNumber	1..1	Integer	see ACDCTerminal

mRID	0..1	String	see IdentifiedObject
name	0..1	String	see IdentifiedObject

TextDiagramObject

DiagramLayout

A diagram object for placing free-text or text derived from an associated domain object.

Native Members

text	1..1	String	The text that is displayed by this text diagram object.

Inherited Members

mRID	1..1	String	see DiagramObject
drawingOrder	1..1	Integer	see DiagramObject
isPolygon	1..1	Boolean	see DiagramObject
name	1..1	String	see DiagramObject
IdentifiedObject	1..1	IdentifiedObject	see DiagramObject

mRID	0..1	String	see IdentifiedObject
name	0..1	String	see IdentifiedObject

ThermalGeneratingUnit

Production

A generating unit whose prime mover could be a steam turbine, combustion turbine, or diesel engine.

Inherited Members

maxOperatingP	1..1	ActivePower	see GeneratingUnit
minOperatingP	1..1	ActivePower	see GeneratingUnit

inService	1..1	Boolean	see Equipment
EquipmentContainer	1..1	EquipmentContainer	see Equipment

mRID	1..1	String	see PowerSystemResource
name	1..1	String	see PowerSystemResource

mRID	0..1	String	see IdentifiedObject
name	0..1	String	see IdentifiedObject

TransformerCoreAdmittance

Wires

The transformer core admittance. Used to specify the core admittance of a transformer in a manner that can be shared among power transformers.

Native Members

mRID	1..1	String	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 IETF 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.
b	1..1	Susceptance	Magnetizing branch susceptance (B mag). The value can be positive or negative.
b0	1..1	Susceptance	Zero sequence magnetizing branch susceptance.
g	1..1	Conductance	Magnetizing branch conductance (G mag).
g0	1..1	Conductance	Zero sequence magnetizing branch conductance.
name	1..1	String	The name is any free human readable and possibly non unique text naming the object.
TransformerEnd	1..1	TransformerEnd	All transformer ends having this core admittance.

Inherited Members

mRID	0..1	String	see IdentifiedObject
name	0..1	String	see IdentifiedObject

TransformerMeshImpedance

Wires

Transformer mesh impedance (Delta-model) between transformer ends.

The typical case is that this class describes the impedance between two transformer ends pair-wise, i.e. the cardinalities at both transformer end associations are 1. However, in cases where two or more transformer ends are modelled the cardinalities are larger than 1.

Native Members

mRID	1..1	String	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 IETF 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	1..1	String	The name is any free human readable and possibly non unique text naming the object.
r	1..1	Resistance	Resistance between the 'from' and the 'to' end, seen from the 'from' end.
r0	1..1	Resistance	Zero-sequence resistance between the 'from' and the 'to' end, seen from the 'from' end.
x	1..1	Reactance	Reactance between the 'from' and the 'to' end, seen from the 'from' end.
x0	1..1	Reactance	Zero-sequence reactance between the 'from' and the 'to' end, seen from the 'from' end.
FromTransformerEnd	1..1	TransformerEnd	From end this mesh impedance is connected to. It determines the voltage reference.
ToTransformerEnd	1..*	TransformerEnd	All transformer ends this mesh impedance is connected to.

Inherited Members

mRID	0..1	String	see IdentifiedObject
name	0..1	String	see IdentifiedObject

TransformerSaturation

Emtiop

Represents a piecewise linear transformer saturation characteristic. It's connected to the same TransformerEnd as the TransformerCoreAdmittance, which is typically the lowest voltage winding other than a tertiary. The attached Curve is a piecewise linear magnetization characteristic, plotted as core flux linkage vs. magnetizing current. This replaces the linear magnetizing characteristic defined by TransformerCoreAdmittance.b and TransformerCoreAdmittance.b0. The TransformerSaturation characteristic does not include hysteresis, i.e., the origin point [0,0] is implied. The TransformerCoreAdmittance.g and TransformerCoreAdmittance.g0 should still be used to model core losses.

This data is of most interest to electromagnetic transient analysis, which typically uses SI units without multipliers.

xMultiplier inherited attribute should be UnitMultiplier.none

xUnit inherited attribute should be UnitSymbol.A

y1Multiplier inherited attribute should be UnitMultiplier.none

y1Unit inherited attribute should be UnitSymbol.Vs

xvalue in associated CurveData should be magnetizing current in peak A (not RMS), referenced to the TransformerEnd associated through TransformerCoreAdmittance. Do not enter the origin point [0,0].

y1value in associated CurveData should be core flux linkage in peak Vs (not RMS), referenced to the TransformerEnd associated through TransformerCoreAdmittance. Do not enter the origin point [0,0].

Native Members

TransformerCoreAdmittance	1..1	TransformerCoreAdmittance

Inherited Members

mRID	1..1	String	see Curve
curveStyle	0..1	CurveStyle	see Curve
name	1..1	String	see Curve
xMultiplier	0..1	UnitMultiplier	see Curve
xUnit	0..1	UnitSymbol	see Curve
y1Multiplier	0..1	UnitMultiplier	see Curve
y1Unit	0..1	UnitSymbol	see Curve

mRID	0..1	String	see IdentifiedObject
name	0..1	String	see IdentifiedObject

Abstract Classes

ACDCTerminal

Core

An electrical connection point (AC or DC) to a piece of conducting equipment. Terminals are connected at physical connection points called connectivity nodes.

Native Members

sequenceNumber	1..1	Integer	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.

Inherited Members

mRID	0..1	String	see IdentifiedObject
name	0..1	String	see IdentifiedObject

AsynchronousMachine

Wires

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.

Inherited Members

p	1..1	ActivePower	see RotatingMachine
q	1..1	ReactivePower	see RotatingMachine
ratedS	1..1	ApparentPower	see RotatingMachine
ratedU	1..1	Voltage	see RotatingMachine
GeneratingUnit	1..1	GeneratingUnit	see RotatingMachine

BaseVoltage	0..1	BaseVoltage	see ConductingEquipment

inService	1..1	Boolean	see Equipment
EquipmentContainer	1..1	EquipmentContainer	see Equipment

mRID	1..1	String	see PowerSystemResource
name	1..1	String	see PowerSystemResource

mRID	0..1	String	see IdentifiedObject
name	0..1	String	see IdentifiedObject

Breaker

Wires

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.

Inherited Members

BaseVoltage	0..1	BaseVoltage	see ConductingEquipment

inService	1..1	Boolean	see Equipment
EquipmentContainer	1..1	EquipmentContainer	see Equipment

mRID	1..1	String	see PowerSystemResource
name	1..1	String	see PowerSystemResource

mRID	0..1	String	see IdentifiedObject
name	0..1	String	see IdentifiedObject

ConductingEquipment

Core

The parts of the AC power system that are designed to carry current or that are conductively connected through terminals.

Native Members

BaseVoltage	0..1	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.

Inherited Members

inService	1..1	Boolean	see Equipment
EquipmentContainer	1..1	EquipmentContainer	see Equipment

mRID	1..1	String	see PowerSystemResource
name	1..1	String	see PowerSystemResource

mRID	0..1	String	see IdentifiedObject
name	0..1	String	see IdentifiedObject

Conductor

Wires

Combination of conducting material with consistent electrical characteristics, building a single electrical system, used to carry current between points in the power system.

Native Members

length	1..1	Length	Segment length for calculating line segment capabilities.

Inherited Members

BaseVoltage	0..1	BaseVoltage	see ConductingEquipment

inService	1..1	Boolean	see Equipment
EquipmentContainer	1..1	EquipmentContainer	see Equipment

mRID	1..1	String	see PowerSystemResource
name	1..1	String	see PowerSystemResource

mRID	0..1	String	see IdentifiedObject
name	0..1	String	see IdentifiedObject

ConnectedFacility

Emtiop

A collection of components that comprise a facility connected to the grid, such as a generating plant or large load.

Native Members

ACPointOfCommonCoupling	0..1	ACPointOfCommonCoupling	The connection point for this facility. It should be associated with a ConnectivityNode within the facility network model, where it may be connected to an external network model.
Equipments	0..*	Equipment	The Equipments associated with this ConnectedFacility.

Inherited Members

mRID	1..1	String	see PowerSystemResource
name	1..1	String	see PowerSystemResource

mRID	0..1	String	see IdentifiedObject
name	0..1	String	see IdentifiedObject

ConnectivityNodeContainer

Core

A base class for all objects that may contain connectivity nodes or topological nodes.

Inherited Members

mRID	1..1	String	see PowerSystemResource
name	1..1	String	see PowerSystemResource

mRID	0..1	String	see IdentifiedObject
name	0..1	String	see IdentifiedObject

Curve

Core

A multi-purpose curve or functional relationship between an independent variable (X-axis) and dependent (Y-axis) variables.

Native Members

mRID	1..1	String	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 IETF 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.
curveStyle	0..1	CurveStyle	The style or shape of the curve.
name	1..1	String	The name is any free human readable and possibly non unique text naming the object.
xMultiplier	0..1	UnitMultiplier	Multiplier for X-axis.
xUnit	0..1	UnitSymbol	The X-axis units of measure.
y1Multiplier	0..1	UnitMultiplier	Multiplier for Y1-axis.
y1Unit	0..1	UnitSymbol	The Y1-axis units of measure.

Inherited Members

mRID	0..1	String	see IdentifiedObject
name	0..1	String	see IdentifiedObject

DCBaseTerminal

DC

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.

Native Members

DCNode	1..1	DCNode	The DC connectivity node to which this DC base terminal connects with zero impedance.

Inherited Members

sequenceNumber	1..1	Integer	see ACDCTerminal

mRID	0..1	String	see IdentifiedObject
name	0..1	String	see IdentifiedObject

DCConductingEquipment

DC

The parts of the DC power system that are designed to carry current or that are conductively connected through DC terminals.

Native Members

ratedCurrent	0..1	CurrentFlow	The maximum continuous current carrying capacity in amps governed by the device material and construction. The attribute shall be a positive value.
ratedUdc	0..1	Voltage	Rated DC device voltage. The attribute shall be a positive value. It is configuration data used in power flow.

Inherited Members

inService	1..1	Boolean	see Equipment
EquipmentContainer	1..1	EquipmentContainer	see Equipment

mRID	1..1	String	see PowerSystemResource
name	1..1	String	see PowerSystemResource

mRID	0..1	String	see IdentifiedObject
name	0..1	String	see IdentifiedObject

DCSwitch

DC

A switch within the DC system.

Native Members

locked	0..1	Boolean	If true, the switch is locked. The resulting switch state is a combination of locked and DCSwitch.open attributes as follows: locked=true and DCSwitch.open=true. The resulting state is open and locked; locked=false and DCSwitch.open=true. The resulting state is open; locked=false and DCSwitch.open=false. The resulting state is closed.
normalOpen	0..1	Boolean	The attribute is used in cases when no Measurement for the status value is present. If the DCSwitch has a status measurement the Discrete.normalValue is expected to match with the DCSwitch.normalOpen.
open	0..1	Boolean	The attribute tells if the switch is considered open when used as input to topology processing.
retained	0..1	Boolean	Branch is retained in the topological solution. The flow through retained switches will normally be calculated in power flow.

Inherited Members

ratedCurrent	0..1	CurrentFlow	see DCConductingEquipment
ratedUdc	0..1	Voltage	see DCConductingEquipment

inService	1..1	Boolean	see Equipment
EquipmentContainer	1..1	EquipmentContainer	see Equipment

mRID	1..1	String	see PowerSystemResource
name	1..1	String	see PowerSystemResource

mRID	0..1	String	see IdentifiedObject
name	0..1	String	see IdentifiedObject

DetailedModelDescriptor

DetailedModelDescription

Describes different components of a detailed model.

Native Members

mRID	0..1	String	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 IETF 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.
DetailedModelTypeDynamics	0..1	DetailedModelTypeDynamics	The detailed model type dynamics that has detailed model descriptor.

Inherited Members

mRID	0..1	String	see IdentifiedObject
name	0..1	String	see IdentifiedObject

DetailedModelTypeDynamics

DetailedModelDescription

The main class that packages all related to this type of a detailed model. This includes all parameters, functions, signals, etc.

DiagramObject

DiagramLayout

An object that defines one or more points in a given space. This object can be associated with anything that specializes IdentifiedObject. For single line diagrams such objects typically include such items as analog values, breakers, disconnectors, power transformers, and transmission lines.

Native Members

mRID	1..1	String	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 IETF 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.
drawingOrder	1..1	Integer	The drawing order of this element. The higher the number, the later the element is drawn in sequence. This is used to ensure that elements that overlap are rendered in the correct order.
isPolygon	1..1	Boolean	Defines whether or not the diagram objects points define the boundaries of a polygon or the routing of a polyline. If this value is true then a receiving application should consider the first and last points to be connected.
name	1..1	String	The name is any free human readable and possibly non unique text naming the object.
IdentifiedObject	1..1	IdentifiedObject	The domain object to which this diagram object is associated.

Inherited Members

mRID	0..1	String	see IdentifiedObject
name	0..1	String	see IdentifiedObject

DynamicsFunctionBlock

StandardModels

Abstract parent class for all Dynamics function blocks.

Native Members

mRID	1..1	String	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 IETF 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.
enabled	1..1	Boolean	Function block used indicator. true = use of function block is enabled false = use of function block is disabled.
name	1..1	String	The name is any free human readable and possibly non unique text naming the object.

Inherited Members

mRID	0..1	String	see IdentifiedObject
name	0..1	String	see IdentifiedObject

EnergyConnection

Wires

A connection of energy generation or consumption on the power system model.

Inherited Members

BaseVoltage	0..1	BaseVoltage	see ConductingEquipment

inService	1..1	Boolean	see Equipment
EquipmentContainer	1..1	EquipmentContainer	see Equipment

mRID	1..1	String	see PowerSystemResource
name	1..1	String	see PowerSystemResource

mRID	0..1	String	see IdentifiedObject
name	0..1	String	see IdentifiedObject

Equipment

Core

The parts of a power system that are physical devices, electronic or mechanical.

Native Members

inService	1..1	Boolean	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.
EquipmentContainer	1..1	EquipmentContainer	Container of this equipment.

Inherited Members

mRID	1..1	String	see PowerSystemResource
name	1..1	String	see PowerSystemResource

mRID	0..1	String	see IdentifiedObject
name	0..1	String	see IdentifiedObject

GeneratingUnit

Production

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.

Native Members

maxOperatingP	1..1	ActivePower	This is the maximum operating active power limit the dispatcher can enter for this unit.
minOperatingP	1..1	ActivePower	This is the minimum operating active power limit the dispatcher can enter for this unit.

Inherited Members

inService	1..1	Boolean	see Equipment
EquipmentContainer	1..1	EquipmentContainer	see Equipment

mRID	1..1	String	see PowerSystemResource
name	1..1	String	see PowerSystemResource

mRID	0..1	String	see IdentifiedObject
name	0..1	String	see IdentifiedObject

IEEECigreDLLSignal

Emtiop

The parent class for DLL input and output signals. Use the ACDCTerminal association for network flows, the DCNode association for DC bus quantities, the ConnectivityNode association for AC bus quantities, or no association for references levels or other signals not connected to the electric power networks.

Native Members

multiplier	0..1	UnitMultiplier	Multiplier for the units of this signal.
name	0..1	String	The signal name from the DLL API. It may be helpful to interpret the signal's meaning.
parameterKind	0..1	IEEECigreDLLParameterKind	Establishes the signal value size, in bytes, expected in the DLL API.
phase	0..1	SinglePhaseKind	The signal's phase, as applicable, for multiphase signal connections.
sequenceNumber	0..1	Integer	The signal's expected sequence number in the DLL API array.
unit	0..1	UnitSymbol	Signal units, if applicable.
width	0..1	Integer	Signal array dimension, defaults to 1.
ConnectivityNode	0..1	ConnectivityNode	Use for a bus voltage or other bus quantity signal. Mutually exclusive with association to DCNode or ACDCTerminal.
DCNode	0..1	DCNode	Use for a DC voltage or other quantity related to DC buses. Mutually exclusive with assocation to ConnectivityNode or ACDCTerminal.

Inherited Members

ACDCTerminal	0..1	ACDCTerminal	see SignalDescriptor
DynamicsFunctionBlock	0..1	DynamicsFunctionBlock	see SignalDescriptor

mRID	0..1	String	see DetailedModelDescriptor
DetailedModelTypeDynamics	0..1	DetailedModelTypeDynamics	see DetailedModelDescriptor

mRID	0..1	String	see IdentifiedObject
name	0..1	String	see IdentifiedObject

IdentifiedObject

Core

This is a class that provides common identification for all classes needing identification and naming attributes.

Native Members

mRID	0..1	String	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 IETF 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	0..1	String	The name is any free human readable and possibly non unique text naming the object.

MutualCoupling

Wires

This class represents the zero sequence line mutual coupling.

Native Members

mRID	1..1	String	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 IETF 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.
b0ch	0..1	Susceptance	Zero sequence mutual coupling shunt (charging) susceptance, uniformly distributed, of the entire line section.
distance11	0..1	Length	Distance to the start of the coupled region from the first line's terminal having sequence number equal to 1.
distance12	0..1	Length	Distance to the end of the coupled region from the first line's terminal with sequence number equal to 1.
distance21	0..1	Length	Distance to the start of coupled region from the second line's terminal with sequence number equal to 1.
distance22	0..1	Length	Distance to the end of coupled region from the second line's terminal with sequence number equal to 1.
g0ch	0..1	Conductance	Zero sequence mutual coupling shunt (charging) conductance, uniformly distributed, of the entire line section.
name	1..1	String	The name is any free human readable and possibly non unique text naming the object.
r0	0..1	Resistance	Zero sequence branch-to-branch mutual impedance coupling, resistance.
x0	0..1	Reactance	Zero sequence branch-to-branch mutual impedance coupling, reactance.

Inherited Members

mRID	0..1	String	see IdentifiedObject
name	0..1	String	see IdentifiedObject

OperationalLimit

OperationalLimits

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.

Native Members

mRID	1..1	String	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 IETF 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	1..1	String	The name is any free human readable and possibly non unique text naming the object.
OperationalLimitSet	0..1	OperationalLimitSet	The limit set to which the limit values belong.
OperationalLimitType	0..1	OperationalLimitType	The limit type associated with this limit.

Inherited Members

mRID	0..1	String	see IdentifiedObject
name	0..1	String	see IdentifiedObject

PSRType

Core

Classifying instances of the same class, e.g. overhead and underground ACLineSegments. This classification mechanism is intended to provide flexibility outside the scope of this document, i.e. provide customisation that is non standard.

Inherited Members

mRID	0..1	String	see IdentifiedObject
name	0..1	String	see IdentifiedObject

PointOfCommonCoupling

Core

Point of Common Coupling (PCC) refers to the location where multiple electrical sources or loads are electrically connected and provide a reference point where the voltages and currents from different parts of the system are considered to be common. The PCC is used to support system analysis, control, and monitoring, as it provides a reference for understanding the interactions and power flow between various components within the system. It is also relevant to define the requirement and responsibility between different actors in operating a power system.

Native Members

mRID	1..1	String	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 IETF 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	1..1	String	The name is any free human readable and possibly non unique text naming the object.

Inherited Members

mRID	0..1	String	see IdentifiedObject
name	0..1	String	see IdentifiedObject

PowerElectronicsUnit

Production

A generating unit or battery or aggregation that connects to the AC network using power electronics rather than rotating machines.

Native Members

maxP	1..1	ActivePower	Maximum active power limit. This is the maximum (nameplate) limit for the unit.
minP	1..1	ActivePower	Minimum active power limit. This is the minimum (nameplate) limit for the unit.
PowerElectronicsConnection	1..1	PowerElectronicsConnection	A power electronics unit has a connection to the AC network.

Inherited Members

inService	1..1	Boolean	see Equipment
EquipmentContainer	1..1	EquipmentContainer	see Equipment

mRID	1..1	String	see PowerSystemResource
name	1..1	String	see PowerSystemResource

mRID	0..1	String	see IdentifiedObject
name	0..1	String	see IdentifiedObject

PowerSystemResource

Core

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.

Native Members

mRID	1..1	String	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 IETF 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	1..1	String	The name is any free human readable and possibly non unique text naming the object.

Inherited Members

mRID	0..1	String	see IdentifiedObject
name	0..1	String	see IdentifiedObject

ProtectedSwitch

Wires

A ProtectedSwitch is a switching device that can be operated by ProtectionEquipment.

Inherited Members

BaseVoltage	0..1	BaseVoltage	see ConductingEquipment

inService	1..1	Boolean	see Equipment
EquipmentContainer	1..1	EquipmentContainer	see Equipment

mRID	1..1	String	see PowerSystemResource
name	1..1	String	see PowerSystemResource

mRID	0..1	String	see IdentifiedObject
name	0..1	String	see IdentifiedObject

RegulatingCondEq

Wires

A type of conducting equipment that can regulate a quantity (i.e. voltage or flow) at a specific point in the network.

Inherited Members

BaseVoltage	0..1	BaseVoltage	see ConductingEquipment

inService	1..1	Boolean	see Equipment
EquipmentContainer	1..1	EquipmentContainer	see Equipment

mRID	1..1	String	see PowerSystemResource
name	1..1	String	see PowerSystemResource

mRID	0..1	String	see IdentifiedObject
name	0..1	String	see IdentifiedObject

RotatingMachine

Wires

A rotating machine which may be used as a generator or motor.

Native Members

p	1..1	ActivePower	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	1..1	ReactivePower	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.
ratedS	1..1	ApparentPower	Nameplate apparent power rating for the unit. The attribute shall have a positive value.
ratedU	1..1	Voltage	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.
GeneratingUnit	1..1	GeneratingUnit	A synchronous machine may operate as a generator and as such becomes a member of a generating unit.

Inherited Members

BaseVoltage	0..1	BaseVoltage	see ConductingEquipment

inService	1..1	Boolean	see Equipment
EquipmentContainer	1..1	EquipmentContainer	see Equipment

mRID	1..1	String	see PowerSystemResource
name	1..1	String	see PowerSystemResource

mRID	0..1	String	see IdentifiedObject
name	0..1	String	see IdentifiedObject

RotatingMachineDynamics

StandardModels

Abstract parent class for all synchronous and asynchronous machine standard models.

Native Members

damping	1..1	Float	Damping torque coefficient (D) (>= 0) in pu torque/pu speed deviation (differential type). A proportionality constant that, when multiplied by the angular velocity of the rotor poles with respect to the magnetic field (frequency), results in the damping torque. This value is often zero when the sources of damping torques (generator damper windings, load damping effects, etc.) are modelled in detail. Typical value = 0.
inertia	1..1	Seconds	Inertia constant of generator or motor and mechanical load (H) (> 0). This is the specification for the stored energy in the rotating mass when operating at rated speed. For a generator, this includes the generator plus all other elements (turbine, exciter) on the same shaft and has units of MW x s. For a motor, it includes the motor plus its mechanical load. Conventional units are PU on the generator MVA base, usually expressed as MW x s / MVA or just s. This value is used in the accelerating power reference frame for operator training simulator solutions. Typical value = 3.
statorLeakageReactance	1..1	PU	Stator leakage reactance (Xl) (>= 0). Typical value = 0,15.
statorResistance	1..1	PU	Stator (armature) resistance (Rs) (>= 0). Typical value = 0,005.

Inherited Members

mRID	1..1	String	see DynamicsFunctionBlock
enabled	1..1	Boolean	see DynamicsFunctionBlock
name	1..1	String	see DynamicsFunctionBlock

mRID	0..1	String	see IdentifiedObject
name	0..1	String	see IdentifiedObject

ShuntCompensator

Wires

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.

Native Members

grounded	1..1	Boolean	Required for Yn and I connections (as represented by ShuntCompensator.phaseConnection). True if the neutral is solidly grounded.
maximumSections	1..1	Integer	The maximum number of sections that may be switched in.
nomU	1..1	Voltage	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.
phaseConnection	0..1	PhaseShuntConnectionKind	The type of phase connection, such as wye or delta.
sections	1..1	Float	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).

Inherited Members

BaseVoltage	0..1	BaseVoltage	see ConductingEquipment

inService	1..1	Boolean	see Equipment
EquipmentContainer	1..1	EquipmentContainer	see Equipment

mRID	1..1	String	see PowerSystemResource
name	1..1	String	see PowerSystemResource

mRID	0..1	String	see IdentifiedObject
name	0..1	String	see IdentifiedObject

SignalDescriptor

DetailedModelDescription

Describes the signals both internal signals that connect different functions or external signals.

Native Members

ACDCTerminal	0..1	ACDCTerminal	The terminal for this signal descriptor.
DynamicsFunctionBlock	0..1	DynamicsFunctionBlock	The dynamics function block to which this signal belongs to.

Inherited Members

mRID	0..1	String	see DetailedModelDescriptor
DetailedModelTypeDynamics	0..1	DetailedModelTypeDynamics	see DetailedModelDescriptor

mRID	0..1	String	see IdentifiedObject
name	0..1	String	see IdentifiedObject

StateVariable

StateVariables

An abstract class for state variables.

Switch

Wires

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.

Inherited Members

BaseVoltage	0..1	BaseVoltage	see ConductingEquipment

inService	1..1	Boolean	see Equipment
EquipmentContainer	1..1	EquipmentContainer	see Equipment

mRID	1..1	String	see PowerSystemResource
name	1..1	String	see PowerSystemResource

mRID	0..1	String	see IdentifiedObject
name	0..1	String	see IdentifiedObject

SynchronousMachineDetailed

SynchronousMachineDynamics

All synchronous machine detailed types use a subset of the same data parameters and input/output variables.

The several variations differ in the following ways:

- the number of equivalent windings that are included;

- the way in which saturation is incorporated into the model;

- whether or not “subtransient saliency” (X''q not = X''d) is represented.

It is not necessary for each simulation tool to have separate models for each of the model types. The same model can often be used for several types by alternative logic within the model. Also, differences in saturation representation might not result in significant model performance differences so model substitutions are often acceptable.

Native Members

efdBaseRatio	1..1	Float	Ratio (exciter voltage/generator voltage) of Efd bases of exciter and generator models (> 0). Typical value = 1.
ifdBaseType	1..1	IfdBaseKind	Excitation base system mode. It should be equal to the value of WLMDV given by the user. WLMDV is the PU ratio between the field voltage and the excitation current: Efd = WLMDV x Ifd. Typical value = ifag.
saturationFactor	1..1	Float	Saturation factor at rated terminal voltage (S1) (>= 0). Defined by defined by S(E1) in the SynchronousMachineSaturationParameters diagram. Typical value = 0,02.
saturationFactor120	1..1	Float	Saturation factor at 120 % of rated terminal voltage (S12) (>= RotatingMachineDynamics.saturationFactor). Defined by S(E2) in the SynchronousMachineSaturationParameters diagram. Typical value = 0,12.
saturationFactor120QAxis	1..1	Float	Quadrature-axis saturation factor at 120% of rated terminal voltage (S12q) (>= SynchonousMachineDetailed.saturationFactorQAxis). Typical value = 0,12.
saturationFactorQAxis	1..1	Float	Quadrature-axis saturation factor at rated terminal voltage (S1q) (>= 0). Typical value = 0,02.

Inherited Members

SynchronousMachine	0..1	SynchronousMachine	see SynchronousMachineDynamics

damping	1..1	Float	see RotatingMachineDynamics
inertia	1..1	Seconds	see RotatingMachineDynamics
statorLeakageReactance	1..1	PU	see RotatingMachineDynamics
statorResistance	1..1	PU	see RotatingMachineDynamics

mRID	1..1	String	see DynamicsFunctionBlock
enabled	1..1	Boolean	see DynamicsFunctionBlock
name	1..1	String	see DynamicsFunctionBlock

mRID	0..1	String	see IdentifiedObject
name	0..1	String	see IdentifiedObject

SynchronousMachineDynamics

SynchronousMachineDynamics

Synchronous machine whose behaviour is described by reference to a standard model expressed in one of the following forms:

- simplified (or classical), where a group of generators or motors is not modelled in detail;

- detailed, in equivalent circuit form;

- detailed, in time constant reactance form; or

- by definition of a user-defined model.

It is a common practice to represent small generators by a negative load rather than by a dynamic generator model when performing dynamics simulations. In this case, a SynchronousMachine in the static model is not represented by anything in the dynamics model, instead it is treated as an ordinary load.

Parameter details:

1. Synchronous machine parameters such as Xl, Xd, Xp etc. are actually used as inductances in the models, but are commonly referred to as reactances since, at nominal frequency, the PU values are the same. However, some references use the symbol L instead of X.

Native Members

SynchronousMachine	0..1	SynchronousMachine	Synchronous machine to which synchronous machine dynamics model applies.

Inherited Members

damping	1..1	Float	see RotatingMachineDynamics
inertia	1..1	Seconds	see RotatingMachineDynamics
statorLeakageReactance	1..1	PU	see RotatingMachineDynamics
statorResistance	1..1	PU	see RotatingMachineDynamics

mRID	1..1	String	see DynamicsFunctionBlock
enabled	1..1	Boolean	see DynamicsFunctionBlock
name	1..1	String	see DynamicsFunctionBlock

mRID	0..1	String	see IdentifiedObject
name	0..1	String	see IdentifiedObject

TapChanger

Wires

Mechanism for changing transformer winding tap positions.

Native Members

highStep	0..1	Integer	Highest possible tap step position, advance from neutral. The attribute shall be greater than lowStep.
lowStep	0..1	Integer	Lowest possible tap step position, retard from neutral.
neutralStep	0..1	Integer	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	0..1	Voltage	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	0..1	Integer	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.
step	1..1	Float	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.

Inherited Members

mRID	1..1	String	see PowerSystemResource
name	1..1	String	see PowerSystemResource

mRID	0..1	String	see IdentifiedObject
name	0..1	String	see IdentifiedObject

TransformerEnd

Wires

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.

Native Members

mRID	1..1	String	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 IETF 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.
endNumber	1..1	Integer	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.
grounded	1..1	Boolean	Used only for Yn and Zn connections indicated by PowerTransformerEnd.connectionKind. If true, the neutral is grounded and attributes TransformerEnd.rground and TransformerEnd.xground are required. If false, the attributes TransformerEnd.rground and TransformerEnd.xground are not considered.
name	1..1	String	The name is any free human readable and possibly non unique text naming the object.
rground	1..1	Resistance	Resistance part of neutral impedance. Zero indicates solidly grounded or grounded through a reactor.
xground	1..1	Reactance	Reactance part of neutral impedance. Zero indicates solidly grounded or grounded through a reactor.
BaseVoltage	1..1	BaseVoltage	Base voltage of the transformer end. This is essential for PU calculation.
Terminal	1..1	Terminal	Terminal of the power transformer to which this transformer end belongs.

Inherited Members

mRID	0..1	String	see IdentifiedObject
name	0..1	String	see IdentifiedObject

Enumerations

BatteryStateKind

Production

The state of the battery unit.

charging	Stored energy is increasing.
discharging	Stored energy is decreasing.
empty	Unable to discharge, and not charging.
full	Unable to charge, and not discharging.
waiting	Neither charging nor discharging, but able to do so.

CurveStyle

Core

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.
straightLineYValues	The Y-axis values are assumed to be a straight line between values. Also known as linear interpolation.

DCSourceKind

Emtiop

battery	Represent the DCEnergySource with a nonlinear battery model, which should respond to state-of-charge (SoC) controls.
load	For electronic loads. Passive loads can be represented in DCShunt.
photoVoltaic	Represent the DCEnergySource with a nonlinear PV panel model, which should respond to maximum power point tracking (MPPT) control

DCTerminalPolarityKind

DC

Polarity for DC terminal. Used in DC system configurations that have explicit polarity of the terminals, e.g., voltage source converter (VSC) technology.

negative	Negative terminal.
positive	Positive terminal.

IEEECigreDLLInputKind

Emtiop

acCurrent	AC current from inverter into the AC filter. Requires the phase attribute. Typically in Amperes, but the DLL API should be used to verify units.
acCurrentGrid	AC current from AC filter into the grid. Requires the phase attribute. Typically in Amperes, but the DLL API should be used to verify units.
acVoltage	AC voltage at the filter-to-grid connection point. Requires the phase attribute. Typically in Volts, but the DLL API should be used to verify units.
activePowerReference	Active power control reference. Typically in per-unit but the DLL API should be used to verify units.
apiDefined	Another kind of input or control signal not enumerated in CIM. Use the DLL API for more information.
dcCurrent	DC current into the inverter stage, if DC bus modeling applies. Typically in Amperes, but the DLL API should be used to verify units.
dcMPPTVoltage	DC voltage command from the maximum power point tracking system, if DC bus modeling applies. Typically in Volts, but the DLL API should be used to verify units.
dcVoltage	DC voltage at the inverter stage, if DC bus modeling applies. Typically in Volts, but the DLL API should be used to verify units.
reactivePowerReference	Reactive power control reference. Typically in per-unit but the DLL API should be used to verify units.
voltageReference	Voltage control reference. Typically in per-unit and positive sequence, but the DLL API should be used to verify units.

IEEECigreDLLOutputKind

Emtiop

activePower	Active power from internal calculation; a convenience output.
apiDefined	Typically a convenience output for plotting and analysis. Use DLL API for more information.
modulationIndex	Modulation index for PWM switching in a detailed VSC model. May be scaled by Vdc/2 in an average model. Requires the phase attribute. If these outputs are not provided, then vscVoltage outputs shall be provided.
pllFrequency	Frequency estimated from the DLL's phase locked loop or similar algorithm.
reactivePower	Reactive power from internal calculation; a convenience output.
rideThroughMode	A flag indicating fault-ride-through mode is active, based on logic internal to the DLL.
vscVoltage	VSC source voltage for an average model. Requires the phase attribute. If these outputs are not provided then modulationIndex outputs shall be provided.

IEEECigreDLLParameterKind

Emtiop

Char_Ptr
Char_Val
Int16_Val
Int32_Val
Int8_Val
Real32_Val
Real64_Val
Uint16_Val
Uint32_Val
Uint8_Val

IfdBaseKind

SynchronousMachineDynamics

Excitation base system mode.

ifag	Air gap line mode.
iffl	Full load system mode.
ifnl	No load system with saturation mode.

InputSignalKind

PowerSystemStabilizerDynamics

Types of input signals. In dynamics modelling, commonly represented by the j parameter.

branchCurrent	Input signal is amplitude of remote branch current.
busFrequency	Input signal is bus voltage frequency. This could be a terminal frequency or remote frequency.
busFrequencyDeviation	Input signal is deviation of bus voltage frequency. This could be a terminal frequency deviation or remote frequency deviation.
busVoltage	Input signal is bus voltage. This could be a terminal voltage or remote voltage.
busVoltageDerivative	Input signal is derivative of bus voltage. This could be a terminal voltage derivative or remote voltage derivative.
fieldCurrent	Input signal is generator field current.
generatorAcceleratingPower	Input signal is generator accelerating power.
generatorElectricalPower	Input signal is generator electrical power on rated S.
generatorMechanicalPower	Input signal is generator mechanical power.
rotorAngularFrequencyDeviation	Input signal is rotor or shaft angular frequency (speed) deviation.
rotorSpeed	Input signal is rotor or shaft speed (angular frequency).

LimitKind

OperationalLimits

Limit kinds.

alarmVoltage	Voltage alarm.
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.
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.
operationalVoltageLimit	Operational voltage limit.
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.
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.
stability	Stability.
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: as a fixed percentage of the PATL for a given time (for example, 115% of the PATL that can be accepted during 15 minutes), 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). 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.
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.
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.
warningVoltage	Voltage warning.

NERCModelKind

Emtiop

Application of this model.

currentCompensation
excitationSystem
load
loadController
machine
powerSystemStabilizer
protection
renewableEnergyResource
signalPlayback
staticVarAndFACTS
turbineGovernor

NERCModelNameKind

Emtiop

Describes the naming category for dynamic models recognized by NERC.

Other
PSLF
PSSE
WECC

NERCModelStatusKind

Emtiop

allowed	NERC allows this model for interconnection-wide studies. NERC used to keep a list of allowed models; currently, it lists only prohibited models.
deprecated	NERC allows this model in interconnection-wide studies, but other models are more suitable.
prohibited	NERC prohibits use of this model in interconnection-side studies. Some legacy network examples may still use this model.

OperationalLimitDirectionKind

OperationalLimits

The direction attribute describes the side of a limit that is a violation.

absoluteValue	An absoluteValue limit means that a monitored absolute value above the limit value 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.
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.

RotorKind

SynchronousMachineDynamics

Type of rotor on physical machine.

roundRotor	Round rotor type of synchronous machine.
salientPole	Salient pole type of synchronous machine.

SinglePhaseKind

Wires

Enumeration of phase identifiers used to designate the specific phase of conducting equipment modelled as individual unbalanced phases.

Allows designation of specific phases for transmission and distribution equipment, circuits and loads.

A	Phase A.
B	Phase B.
C	Phase C.
N	Neutral.
s1	Secondary phase 1.
s2	Secondary phase 2.

SynchronousMachineKind

Wires

Synchronous machine type.

condenser	Indicates the synchronous machine can operate as a condenser.
generator	Indicates the synchronous machine can operate as a generator.
generatorOrCondenser	Indicates the synchronous machine can operate as a generator or as a condenser.
generatorOrCondenserOrMotor	Indicates the synchronous machine can operate as a generator or as a condenser or as a motor.
generatorOrMotor	Indicates the synchronous machine can operate as a generator or as a motor.
motor	Indicates the synchronous machine can operate as a motor.
motorOrCondenser	Indicates the synchronous machine can operate as a motor or as a condenser.

SynchronousMachineModelKind

SynchronousMachineDynamics

Type of synchronous machine model used in dynamic simulation applications.

subtransient	Subtransient synchronous machine model. In order to model type SubtransientSilentPole standard model type the SynchronousMachineTimeConstantReactance.modelType shall be set to subtransient, .rotorType shall be set to salientPole and the attributes SynchronousMachineDetailed.saturationFactorQAxis and SynchronousMachineDetailed.saturationFactor120QAxisthe are either not exchanged or set to 0. In order to model type SubtransientRoundRotor standard model type the SynchronousMachineTimeConstantReactance.modelType shall be set to subtransient, .rotorType shall be set to is roundRotor and the following attributes are required: – SynchronousMachineTimeConstantReactance.xQuadTrans – SynchronousMachineTimeConstantReactance.tpqo – SynchronousMachineDetailed.saturationFactorQAxis – SynchronousMachineDetailed.saturationFactor120QAxis – RotatingMachineDynamics.saturationFactor – RotatingMachineDynamics.saturationFactor120.
subtransientSimplified	Simplified version of subtransient synchronous machine model where magnetic coupling between the direct- and quadrature- axes is ignored. Therefore if the SynchronousMachineTimeConstantReactance.modelType is set to subtransientSimplified and SynchronousMachineTimeConstantReactance.rotorType is set to roundRotor the attributes SynchronousMachineDetailed.saturationFactorQAxis, SynchronousMachineDetailed.saturationFactor120QAxis and RotatingMachineDynamics.statorResistance are either not exchanged or set to 0.
subtransientSimplifiedDirectAxis	Simplified version of a subtransient synchronous machine model with no damper circuit on the direct-axis.
subtransientTypeF	WECC type F variant of subtransient synchronous machine model.
subtransientTypeJ	WECC type J variant of subtransient synchronous machine model.

SynchronousMachineOperatingMode

Wires

Synchronous machine operating mode.

condenser	Operating as condenser.
generator	Operating as generator.
motor	Operating as motor.

UnitMultiplier

Domain

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".

E	Exa 10**18.
G	Giga 10**9.
M	Mega 10**6.
P	Peta 10**15.
T	Tera 10**12.
Y	Yotta 10**24.
Z	Zetta 10**21.
a	Atto 10**-18.
c	Centi 10**-2.
d	Deci 10**-1.
da	Deca 10**1.
f	Femto 10**-15.
h	Hecto 10**2.
k	Kilo 10**3.
m	Milli 10**-3.
micro	Micro 10**-6.
n	Nano 10**-9.
none	No multiplier or equivalently multiply by 1.
p	Pico 10**-12.
y	Yocto 10**-24.
z	Zepto 10**-21.

UnitSymbol

Domain

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 "kgPerm^3". 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 "m^3". The letters "deg" are used instead of the degree symbol. 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.

A	Current in amperes.
A2	Amperes squared (A^2).
A2h	Ampere-squared hour, ampere-squared hour.
A2s	Ampere squared time in square amperes (A^2*s).
APerA	Current, ratio of amperages.
APerm	Amperes per metre (A/m), magnetic field strength.
Ah	Ampere-hours, ampere-hours.
As	Ampere seconds (A*s).
Bq	Radioactivity in becquerels (1/s).
Btu	Energy, British Thermal Units.
C	Electric charge in coulombs (A*s).
CPerkg	Exposure (x rays), coulombs per kilogram.
CPerm2	Surface charge density, coulombs per square metre.
CPerm3	Electric charge density, coulombs per cubic metre.
F	Electric capacitance in farads (C/V).
FPerm	Permittivity, farads per metre.
G	Magnetic flux density, gausses (1 G = 10e-4*T).
Gy	Absorbed dose in grays (J/kg).
GyPers	Absorbed dose rate, grays per second.
H	Electric inductance in henrys (Wb/A).
HPerm	Permeability, henrys per metre.
Hz	Frequency in hertz (1/s).
HzPerHz	Frequency, rate of frequency change.
HzPers	Rate of change of frequency in hertz per second.
J	Energy in joules (N*m = C*V = W*s).
JPerK	Heat capacity in joules/kelvin.
JPerkg	Specific energy, J/kg.
JPerkgK	Specific heat capacity, specific entropy, joules per kilogram Kelvin.
JPerm2	Insulation energy density, joules per square metre or watt second per square metre.
JPerm3	Energy density, joules per cubic metre.
JPermol	Molar energy, joules per mole.
JPermolK	Molar entropy, molar heat capacity, joules per mole kelvin.
JPers	Energy rate in joules per second (J/s).
K	Temperature in kelvins.
KPers	Temperature change rate in kelvins per second.
M	Length, nautical miles (1 M = 1852 m).
Mx	Magnetic flux, maxwells (1 Mx = 10-8 Wb).
N	Force in newtons (kg*m/s^2).
NPerm	Surface tension, newton per metre.
Nm	Moment of force, newton metres.
Oe	Magnetic field in oersteds, (1 Oe = (10^3/(4*pi)) A/m = 79.57747 A/m).
Pa	Pressure in pascals (N/m^2). Note: the absolute or relative measurement of pressure is implied with this entry. See below for more explicit forms.
PaPers	Pressure change rate in pascals per second.
Pas	Dynamic viscosity, pascal seconds.
Q	Quantity power, Q.
Qh	Quantity energy, Qh.
S	Conductance in siemens.
SPerm	Conductance per length (F/m).
Sv	Dose equivalent in sieverts (J/kg).
T	Magnetic flux density in teslas (Wb/m^2).
V	Electric potential in volts (W/A).
V2	Volt squared (W^2/A^2).
V2h	Volt-squared hour, volt-squared-hours.
VA	Apparent power in volt amperes. See also real power and reactive power.
VAh	Apparent energy in volt ampere hours.
VAr	Reactive power in volt amperes reactive. The "reactive" or "imaginary" component of electrical power (V*I*sin(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.
VArh	Reactive energy in volt ampere reactive hours.
VPerHz	Magnetic flux in volt per hertz.
VPerV	Voltage, ratio of voltages.
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.
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.
VPerm	Electric field strength, volts per metre.
Vh	Volt-hour, Volt hours.
Vs	Volt seconds (Ws/A).
W	Real power in watts (J/s). Electrical power may have real and reactive components. The real portion of electrical power (I^2*R or V*I*cos(phi)), is expressed in Watts. See also apparent power and reactive power.
WPerA	Active power per current flow, watts per Ampere.
WPerW	Signal Strength, ratio of power.
WPerm2	Heat flux density, irradiance, watts per square metre.
WPerm2sr	Radiance, watts per square metre steradian.
WPermK	Thermal conductivity in watt/metres kelvin.
WPers	Ramp rate in watts per second.
WPersr	Radiant intensity, watts per steradian.
Wb	Magnetic flux in webers (V*s).
Wh	Real energy in watt hours.
anglemin	Plane angle, minutes.
anglesec	Plane angle, seconds.
bar	Pressure in bars, (1 bar = 100 kPa).
cd	Luminous intensity in candelas.
charPers	Data rate (baud) in characters per second.
character	Number of characters.
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.
count	Amount of substance, counter value.
d	Time in days, day = 24 h = 86400 s.
dB	Sound pressure level in decibels. Note: multiplier "d" is included in this unit symbol for compatibility with IEC 61850-7-3.
dBm	Power level (logarithmic ratio of signal strength , Bel-mW), normalized to 1 mW. Note: multiplier "d" is included in this unit symbol for compatibility with IEC 61850-7-3.
deg	Plane angle in degrees.
degC	Relative temperature in degrees Celsius (degC).
ft3	Volume, cubic feet.
gPerg	Concentration, The ratio of the mass of a solute divided by the mass of the solution.
gal	Volume in gallons, US gallon (1 gal = 231 in^3 = 128 fl ounce).
h	Time in hours, hour = 60 min = 3600 s.
ha	Area, hectares.
kat	Catalytic activity, katal = mol/s.
katPerm3	Catalytic activity concentration, katals per cubic metre.
kg	Mass in kilograms. Note: multiplier "k" is included in this unit symbol for compatibility with IEC 61850-7-3.
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.
kgPerm	Mass per length in kilogram/metres (kg/m). Note: multiplier "k" is included in this unit symbol for compatibility with mass datatype.
kgPerm3	Density in kilogram/cubic metres (kg/m^3). Note: multiplier "k" is included in this unit symbol for compatibility with IEC 61850-7-3.
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.
kgm2	Moment of mass in kilogram square metres (kg*m^2) (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.
kn	Speed, knots (1 kn = 1852/3600) m/s.
l	Volume in litres, litre = dm^3 = m^3/1000.
lPerh	Volumetric flow rate, litres per hour.
lPerl	Concentration, The ratio of the volume of a solute divided by the volume of the solution.
lPers	Volumetric flow rate in litres per second.
lm	Luminous flux in lumens (cd*sr).
lx	Illuminance in lux (lm/m^2).
m	Length in metres.
m2	Area in square metres (m^2).
m2Pers	Viscosity in square metres/second (m^2/s).
m3	Volume in cubic metres (m^3).
m3Compensated	Volume, cubic metres, with the value compensated for weather effects.
m3Perh	Volumetric flow rate, cubic metres per hour.
m3Perkg	Specific volume, cubic metres per kilogram, v.
m3Pers	Volumetric flow rate in cubic metres per second (m^3/s).
m3Uncompensated	Volume, cubic metres, with the value uncompensated for weather effects.
mPerm3	Fuel efficiency in metres per cubic metres (m/m^3).
mPers	Velocity in metres per second (m/s).
mPers2	Acceleration in metres per second squared (m/s^2).
min	Time in minutes, minute = 60 s.
mmHg	Pressure, millimetres of mercury (1 mmHg is approximately 133.3 Pa).
mol	Amount of substance in moles.
molPerkg	Concentration, Molality, the amount of solute in moles and the amount of solvent in kilograms.
molPerm3	Concentration, The amount of substance concentration, (c), the amount of solvent in moles divided by the volume of solution in m^3.
molPermol	Concentration, Molar fraction, the ratio of the molar amount of a solute divided by the molar amount of the solution.
none	Dimension less quantity, e.g. count, per unit, etc.
ohm	Electric resistance in ohms (V/A).
ohmPerm	Electric resistance per length in ohms per metre ((V/A)/m).
ohmm	Resistivity, ohm metres, (rho).
onePerHz	Reciprocal of frequency (1/Hz).
onePerm	Wavenumber, reciprocal metres, (1/m).
ppm	Concentration in parts per million.
rad	Plane angle in radians (m/m).
radPers	Angular velocity in radians per second (rad/s).
radPers2	Angular acceleration, radians per second squared.
rev	Amount of rotation, revolutions.
rotPers	Rotations per second (1/s). See also Hz (1/s).
s	Time in seconds.
sPers	Time, Ratio of time.
sr	Solid angle in steradians (m^2/m^2).
therm	Energy, therms.
tonne	Mass in tons, "tonne" or "metric ton" (1000 kg = 1 Mg).

WindingConnection

Wires

Winding connection type.

A	Autotransformer common winding.
D	Delta.
I	Independent winding, for single-phase connections.
Y	Wye.
Yn	Wye, with neutral brought out for grounding.
Z	ZigZag.
Zn	ZigZag, with neutral brought out for grounding.

Compound Types

Datatypes

ActivePower

Domain

Product of RMS value of the voltage and the RMS value of the in-phase component of the current.

XSD type: float

AngleDegrees

Domain

Measurement of angle in degrees.

XSD type: float

AngleRadians

Domain

Phase angle in radians.

XSD type: float

ApparentPower

Domain

Product of the RMS value of the voltage and the RMS value of the current.

XSD type: float

Capacitance

Domain

Capacitive part of reactance (imaginary part of impedance), at rated frequency.

XSD type: float

Conductance

Domain

Factor by which voltage must be multiplied to give corresponding power lost from a circuit. Real part of admittance.

XSD type: float

CurrentFlow

Domain

Electrical current with sign convention: positive flow is out of the conducting equipment into the connectivity node. Can be both AC and DC.

XSD type: float

Frequency

Domain

Cycles per second.

XSD type: float

Inductance

Domain

Inductive part of reactance (imaginary part of impedance), at rated frequency.

XSD type: float

Length

Domain

Unit of length. It shall be a positive value or zero.

XSD type: float

PU

Domain

Per Unit - a positive or negative value referred to a defined base. Values typically range from -10 to +10.

XSD type: float

PerCent

Domain

Percentage on a defined base. For example, specify as 100 to indicate at the defined base.

XSD type: float

Reactance

Domain

Reactance (imaginary part of impedance), at rated frequency.

XSD type: float

ReactivePower

Domain

Product of RMS value of the voltage and the RMS value of the quadrature component of the current.

XSD type: float

RealEnergy

Domain

Real electrical energy.

XSD type: float

Resistance

Domain

Resistance (real part of impedance).

XSD type: float

Seconds

Domain

Time, in seconds.

XSD type: float

Susceptance

Domain

Imaginary part of admittance.

XSD type: float

Voltage

Domain

Electrical voltage, can be both AC and DC.

XSD type: float

Primitive Types

Boolean

Domain

A type with the value space "true" and "false".

XSD type: boolean

DateTime

Domain

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.

XSD type: dateTime

Float

Domain

A floating point number. The range is unspecified and not limited.

XSD type: float

Integer

Domain

An integer number. The range is unspecified and not limited.

XSD type: integer

String

Domain

A string consisting of a sequence of characters. The character encoding is UTF-8. The string length is unspecified and unlimited.

XSD type: string