Profile namespace: http://ucte.org/2009/profile1_v14#
Wires
A wire or combination of wires, with consistent electrical characteristics, building a single electrical system, used to carry alternating current between points in the power system.
Series compensators can be modeled as ACLineSegement. The attribute Conductor.length is required only when used in conjunction with a Mutual Coupling.
|
b0ch |
0..1 |
see Conductor |
|
|---|---|---|---|
|
bch |
1..1 |
see Conductor |
|
|
g0ch |
0..1 |
see Conductor |
|
|
gch |
0..1 |
see Conductor |
|
|
length |
0..1 |
see Conductor |
|
|
r |
1..1 |
see Conductor |
|
|
r0 |
0..1 |
see Conductor |
|
|
x |
1..1 |
see Conductor |
|
|
x0 |
0..1 |
see Conductor |
|
BaseVoltage |
0..1 |
|---|
|
equivalent |
0..1 |
boolean |
see Equipment |
|---|---|---|---|
|
MemberOf_EquipmentContainer |
0..1 |
see Equipment |
|
aliasName |
0..1 |
string |
see IdentifiedObject |
|---|---|---|---|
|
description |
0..1 |
string |
see IdentifiedObject |
|
name |
0..1 |
string |
see IdentifiedObject |
Core
Collection of BaseVoltages which is used to verify that the BusbarSection.BaseVoltage and other voltage attributes in the CIM are given a value existing in the collection.
|
isDC |
1..1 |
boolean |
If true, this is a direct current base voltage and items assigned to this base voltage are also associated with a direct current capabilities. False indicates alternating current. |
|---|---|---|---|
|
nominalVoltage |
1..1 |
The PowerSystemResource's base voltage. |
|
aliasName |
0..1 |
string |
see IdentifiedObject |
|---|---|---|---|
|
description |
0..1 |
string |
see IdentifiedObject |
|
name |
0..1 |
string |
see IdentifiedObject |
ControlArea
A <b>control area </b>is a grouping of <b>generating units</b> and/or loads and a cutset of tie lines (as <b>terminals</b>) which may be used for a variety of purposes including automatic generation control, powerflow solution area interchange control specification, and input to load forecasting. Note that any number of overlapping control area specifications can be superimposed on the physical model.
|
netInterchange |
1..1 |
The specified positive net interchange into the control area. |
|
|---|---|---|---|
|
pTolerance |
1..1 |
Active power net interchange tolerance |
|
aliasName |
0..1 |
string |
see IdentifiedObject |
|---|---|---|---|
|
description |
0..1 |
string |
see IdentifiedObject |
|
name |
0..1 |
string |
see IdentifiedObject |
ControlArea
A control area generating unit. This class is needed so that alternate control area definitions may include the same generating unit. Note only one instance within a control area should reference a specific generating unit.
|
ControlArea |
1..1 |
The parent control area for the generating unit specifications. |
|
|---|---|---|---|
|
GeneratingUnit |
1..1 |
The generating unit specified for this control area. Note that a control area should include a GeneratingUnit only once. |
OperationalLimits
Operational limit on current.
|
value |
1..1 |
Limit on current flow. |
|---|
|
OperationalLimitSet |
1..1 |
see OperationalLimit |
|
|---|---|---|---|
|
OperationalLimitType |
1..1 |
see OperationalLimit |
|
aliasName |
0..1 |
string |
see IdentifiedObject |
|---|---|---|---|
|
description |
0..1 |
string |
see IdentifiedObject |
|
name |
0..1 |
string |
see IdentifiedObject |
Core
Data point values for defining a curve or schedule
|
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 |
|
y2value |
1..1 |
float |
The data value of the second Y-axis variable (if present), depending on the Y-axis units |
|
CurveSchedule |
1..1 |
The Curve defined by this CurveData. |
Wires
Generic user of energy - a point of consumption on the power system model
|
LoadResponse |
1..1 |
The load response characteristic of this load. |
|---|
|
BaseVoltage |
0..1 |
|---|
|
equivalent |
0..1 |
boolean |
see Equipment |
|---|---|---|---|
|
MemberOf_EquipmentContainer |
0..1 |
see Equipment |
|
aliasName |
0..1 |
string |
see IdentifiedObject |
|---|---|---|---|
|
description |
0..1 |
string |
see IdentifiedObject |
|
name |
0..1 |
string |
see IdentifiedObject |
Production
The fossil fuel consumed by the non-nuclear thermal generating units, e.g., coal, oil, gas
The UCTE profile allows only one type of fuel per ThermalGeneratingUnit.
|
fossilFuelType |
1..1 |
The type of fossil fuel, such as coal, oil, or gas. |
|---|
|
aliasName |
0..1 |
string |
see IdentifiedObject |
|---|---|---|---|
|
description |
0..1 |
string |
see IdentifiedObject |
|
name |
0..1 |
string |
see IdentifiedObject |
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.
One GeneratingUnit or its subtype is to be modeled for each SynchronousMachine.
In case the type of generating unit (such as hydro, coal, nuclear, ...) is not well known the GeneratingUnit class may be used as a concrete class in the exchange. If the type is well known, then an appropriate subtype of GeneratingUnit such as HydroGeneratingUnit should be used in the exchange file.
|
governorSCD |
0..1 |
Governor Speed Changer Droop. This is the change in generator power output divided by the change in frequency normalized by the nominal power of the generator and the nominal frequency and expressed in percent and negated. A positive value of speed change droop provides additional generator output upon a drop in frequency. This is for Short Circuit Only. |
|
|---|---|---|---|
|
maximumAllowableSpinningReserve |
0..1 |
Maximum allowable spinning reserve. Spinning reserve will never be considered greater than this value regardless of the current operating point. |
|
|
maxOperatingP |
1..1 |
This is the maximum operating active power limit the dispatcher can enter for this unit |
|
|
minOperatingP |
1..1 |
This is the minimum operating active power limit the dispatcher can enter for this unit. |
|
|
nominalP |
1..1 |
The nominal power of the generating unit. Used to give precise meaning to percentage based attributes such as the govenor speed change droop (govenorSCD attribute). |
|
|
normalPF |
0..1 |
float |
Generating unit economic participation factor For UCTE only one Generating per control area should be non-zero. The attribute is optional on a GeneratingUnit and the value can be assumed to be zero if missing. This minimizes the data that must be exchanged. By convention the non-zero value is specified as one. |
|
startupCost |
0..1 |
The initial startup cost incurred for each start of the GeneratingUnit. This is for Short Circuit only. |
|
|
variableCost |
0..1 |
The variable cost component of production per unit of ActivePower. This is for Short Circuit only. |
|
equivalent |
0..1 |
boolean |
see Equipment |
|---|---|---|---|
|
MemberOf_EquipmentContainer |
0..1 |
see Equipment |
|
aliasName |
0..1 |
string |
see IdentifiedObject |
|---|---|---|---|
|
description |
0..1 |
string |
see IdentifiedObject |
|
name |
0..1 |
string |
see IdentifiedObject |
Core
A geographical region of a power system network model.
|
aliasName |
0..1 |
string |
see IdentifiedObject |
|---|---|---|---|
|
description |
0..1 |
string |
see IdentifiedObject |
|
name |
0..1 |
string |
see IdentifiedObject |
Production
A generating unit whose prime mover is a hydraulic turbine (e.g., Francis, Pelton, Kaplan)
Production
A synchronous motor-driven pump, typically associated with a pumped storage plant
A HydroPump is included in the profile to indicate the associated SynchronousMachine can run in pump mode.
|
DrivenBy_SynchronousMachine |
1..1 |
The synchronous machine drives the turbine which moves the water from a low elevation to a higher elevation. The direction of machine rotation for pumping may or may not be the same as for generating. |
|---|
|
aliasName |
0..1 |
string |
see IdentifiedObject |
|---|---|---|---|
|
description |
0..1 |
string |
see IdentifiedObject |
|
name |
0..1 |
string |
see IdentifiedObject |
This is the IEC 61970 CIM version number assigned to this UML model file.
This is the UCTE profile. We have been using file naming conventions, the profile namespace, and comments here in the profile under IEC61970CIMVersion class.
Profile1_v9 - dated 2009-01-27 - removed SeriesCompensator and ApparentPowerLimit, added TopologicalNode.equivalent
Profile1_v10 - dated 2009-01-29 - documentation added on Terminal.sequenceNumber. Added notes to GeneratingUnit.normalPF attribute in profile.
Profile1_v11 - dated 2009-02-04 - Made optional SynchronousMachine.InitialReactiveCapabilityCurve, minQ, maxQ. Rename of SvTapStep.tapRatio to SvTapStep.continuousPosition. Multiplicity for SvShuntCompensatorSections.continuousSections made manditory. Removed SvShuntCompensatorSections.sections and SvTapStep.position from profile.
Profile 1_v12 - dated 2009-03-17 - Made all Short Circuit classes and Attributes Optional, made all voltage dependency / coeficient model attributes Optional, added notes from the UCTE Mapping Spreadsheet and added a few clarification notes.
Profile 1_v13 - dated 2009-03-19 - Made the GeneratingUnit.maximumAllowableSpinningReserve Optional and made all of the PhaseTapChanger attributes Optional.
Profile 1_v14 - dated 2009-05-10 - Added some comments to classes based on input from IOP test and added BusBarSection and Line Classes.
|
date |
1..1 |
dateTime |
The date of release of the model version. Of the form 2008-12-22 for example if the date was the twentysecond day of December in 2008. |
|---|---|---|---|
|
version |
1..1 |
string |
Version number of the model. Of the form IEC61970CIM14v01 for example. For UCTE on 2009-01-15 added the terminal.SequenceNumber added some clarification of MutualCoupling For UCTE on 2009-0116 added IdentifiedObject inhereitance to OperationalLimitType class For UCTE on 2009-01-17 added the TopologicalNode-BaseVoltage association. For UCTE on 2009-01-27 added the TopologicalNode.equivalent attribute. For UCTE on 2009-02-04 renamed SvTapStep.tapRatio to SvTapStep.continuousPosition. Multipliicty made optional or SvTapStep.position and SvTapStep.continuousPosition. Please see the profile comments on the IEC61970CIMVersion class for the profile version comments. |
LoadModel
Models the characteristic response of the load demand due to to changes in system conditions such as voltage and frequency. This is not related to demand response.
|
exponentModel |
1..1 |
boolean |
Indicates the exponential voltage dependency model (pVoltateExponent and qVoltageExponent) is to be used. If false, the coeficient model (consisting of pConstantImpedance, pConstantCurrent, pConstantPower, qConstantImpedance, qConstantCurrent, and qConstantPower) is to be used. |
|---|---|---|---|
|
pConstantCurrent |
0..1 |
float |
Portion of active power load modeled as constant current. Used only if the useExponentModel is false. This value is noralized against the sum of pZ, pI, and pP. |
|
pConstantImpedance |
0..1 |
float |
Portion of active power load modeled as constant impedance. Used only if the useExponentModel is false. This value is noralized against the sum of pZ, pI, and pP. |
|
pConstantPower |
0..1 |
float |
Portion of active power load modeled as constant power. Used only if the useExponentModel is false. This value is noralized against the sum of pZ, pI, and pP. |
|
pVoltageExponent |
0..1 |
float |
Exponent of per unit voltage effecting real power. This model used only when "useExponentModel" is true. |
|
qConstantCurrent |
0..1 |
float |
Portion of reactive power load modeled as constant current. Used only if the useExponentModel is false. This value is noralized against the sum of qZ, qI, and qP. |
|
qConstantImpedance |
0..1 |
float |
Portion of reactive power load modeled as constant impedance. Used only if the useExponentModel is false. This value is noralized against the sum of qZ, qI, and qP. |
|
qConstantPower |
0..1 |
float |
Portion of reactive power load modeled as constant power. Used only if the useExponentModel is false. This value is noralized against the sum of qZ, qI, and qP. |
|
qVoltageExponent |
0..1 |
float |
Exponent of per unit voltage effecting reactive power. This model used only when "useExponentModel" is true. |
|
aliasName |
0..1 |
string |
see IdentifiedObject |
|---|---|---|---|
|
description |
0..1 |
string |
see IdentifiedObject |
|
name |
0..1 |
string |
see IdentifiedObject |
Wires
This class represents the zero sequence line mutual coupling.
This class is Optional and only used for Short Circuit.
|
b0ch |
1..1 |
Zero sequence mutual coupling shunt (charging) susceptance, uniformly distributed, of the entire line section. |
|
|---|---|---|---|
|
distance11 |
1..1 |
Distance from the first line's specified terminal to start of coupled region Cannot be equal to distance12 and connot be greater than Conductor.length of the referenced line. The value of Conductor.length attribute must be a positive number. |
|
|
distance12 |
1..1 |
Distance from the first line's from specified terminal to end of coupled region Must be greater than the value of distance11 and connot be greater than Conductor.length of the referenced line. The value of Conductor.length attribute must be a positive number. |
|
|
distance21 |
1..1 |
Distance from the second line's specified terminal to start of coupled region Cannot be equal to distance22 and connot be greater than Conductor.length of the referenced line. The value of Conductor.length attribute must be a positive number. |
|
|
distance22 |
1..1 |
Distance from the second line's specified terminal to end of coupled region Must be greater than the value of distance21 and connot be greater than Conductor.length of the referenced line. The value of Conductor.length attribute must be a positive number. |
|
|
g0ch |
1..1 |
Zero sequence mutual coupling shunt (charging) conductance, uniformly distributed, of the entire line section. |
|
|
r0 |
1..1 |
Zero sequence branch-to-branch mutual impedance coupling, resistance |
|
|
x0 |
1..1 |
Zero sequence branch-to-branch mutual impedance coupling, reactance |
|
|
First_Terminal |
1..1 |
The starting terminal for the calculation of distances along the first branch of the mutual coupling. Normally MutualCoupling would only be used for terminals of AC line segments. The first and second terminals of a mutual coupling should point to different AC line segments. |
|
|
Second_Terminal |
1..1 |
The starting terminal for the calculation of distances along the second branch of the mutual coupling. |
|
aliasName |
0..1 |
string |
see IdentifiedObject |
|---|---|---|---|
|
description |
0..1 |
string |
see IdentifiedObject |
|
name |
0..1 |
string |
see IdentifiedObject |
OperationalLimits
A set of limits associated with equipmnet. Sets of limits might apply to a specific temperature, or season for example. A set of limits may contain may different severiteis 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.
|
Terminal |
1..1 |
The terminal specifically associated to this operational limit set. If no terminal is associated, all terminals of the equipment are implied. For UCTE profile, the terminal associated with the limit is always required, and thus there is no need to exchange the associated Equipment which can always be derived from the terminal. |
|---|
|
aliasName |
0..1 |
string |
see IdentifiedObject |
|---|---|---|---|
|
description |
0..1 |
string |
see IdentifiedObject |
|
name |
0..1 |
string |
see IdentifiedObject |
OperationalLimits
A type of limit. The meaning of a specific limit is described in this class.
|
acceptableDuration |
1..1 |
The nominal acceptable duration of the limit. Limits are commonly expressed in terms of the a 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. |
|
|---|---|---|---|
|
direction |
1..1 |
The direction of the limit. |
|
aliasName |
0..1 |
string |
see IdentifiedObject |
|---|---|---|---|
|
description |
0..1 |
string |
see IdentifiedObject |
|
name |
0..1 |
string |
see IdentifiedObject |
Wires
A specialization of a voltage tap changer that has detailed modeling for phase shifting capabilities. A phase shifting tap changer is also in general a voltage magnitude transformer. The symmetrical and asymmetrical transformer tap changer models are defined here.
|
phaseTapChangerType |
1..1 |
The type of phase shifter construction. |
|
|---|---|---|---|
|
stepPhaseShiftIncrement |
0..1 |
Phase shift per step position. A positive value indicates a positive phase shift from the winding where the tap is located to the other winding (for a two-winding transformer). The actual phase shift increment might be more accureatly computed from the symmetrical or asymmetrical models or a tap step table lookup if those are available. |
|
|
voltageStepIncrementOutOfPhase |
0..1 |
The voltage step increment on the out of phase winding. This voltage step on the out of phase winding of the phase shifter. Similar to TapChanger.voltageStepIncrement, but it is applied only to the out of phase winding. This is required if PST is Asymmetrical. |
|
|
windingConnectionAngle |
0..1 |
The phase angle between the in-phase winding and the out-of -phase winding used for creating phase shift. It is only possible to have a symmemtrical transformer if this angle is 90 degrees. This is required if PST is Asymmetrical |
|
|
xStepMax |
0..1 |
The reactance at the maximum tap step. |
|
|
xStepMin |
0..1 |
The reactance at the minimum tap step. |
|
|
TransformerWinding |
1..1 |
The transformer winding to which the phase tap changer belongs. |
|
highStep |
1..1 |
integer |
see TapChanger |
|---|---|---|---|
|
lowStep |
1..1 |
integer |
see TapChanger |
|
neutralStep |
1..1 |
integer |
see TapChanger |
|
neutralU |
1..1 |
see TapChanger |
|
|
stepVoltageIncrement |
0..1 |
see TapChanger |
|
|
RegulatingControl |
0..1 |
see TapChanger |
|
aliasName |
0..1 |
string |
see IdentifiedObject |
|---|---|---|---|
|
description |
0..1 |
string |
see IdentifiedObject |
|
name |
0..1 |
string |
see IdentifiedObject |
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).
|
equivalent |
0..1 |
boolean |
see Equipment |
|---|---|---|---|
|
MemberOf_EquipmentContainer |
0..1 |
see Equipment |
|
aliasName |
0..1 |
string |
see IdentifiedObject |
|---|---|---|---|
|
description |
0..1 |
string |
see IdentifiedObject |
|
name |
0..1 |
string |
see IdentifiedObject |
Wires
A tap changer that changes the voltage ratio impacting the voltage magnitude but not direclty the phase angle across the transformer..
|
TransformerWinding |
1..1 |
The transformer winding to which the ratio tap changer belongs. |
|---|
|
highStep |
1..1 |
integer |
see TapChanger |
|---|---|---|---|
|
lowStep |
1..1 |
integer |
see TapChanger |
|
neutralStep |
1..1 |
integer |
see TapChanger |
|
neutralU |
1..1 |
see TapChanger |
|
|
stepVoltageIncrement |
0..1 |
see TapChanger |
|
|
RegulatingControl |
0..1 |
see TapChanger |
|
aliasName |
0..1 |
string |
see IdentifiedObject |
|---|---|---|---|
|
description |
0..1 |
string |
see IdentifiedObject |
|
name |
0..1 |
string |
see IdentifiedObject |
Wires
Reactive power rating envelope versus the synchronous machine's active power, in both the generating and motoring modes. For each active power value there is a corresponding high and low reactive power limit value. Typically there will be a separate curve for each coolant condition, such as hydrogen pressure. The Y1 axis values represent reactive minimum and the Y2 axis values represent reactive maximum.
By convention in this profile, the CurveData points have y1multiplier of M, y2Multiplier of M, y1Units of W and y2Units of W, xUnits of W and xMultiplier of M.
|
aliasName |
0..1 |
string |
see IdentifiedObject |
|---|---|---|---|
|
description |
0..1 |
string |
see IdentifiedObject |
|
name |
0..1 |
string |
see IdentifiedObject |
Wires
Specifies a set of equipment that works together to control a power system quantity such as voltage or flow.
|
discrete |
1..1 |
boolean |
The regulation is performed in a discrete mode. |
|---|---|---|---|
|
mode |
1..1 |
The regulating control mode presently available. This specifications allows for determining the kind of regualation without need for obtaining the units from a schedule. |
|
|
targetRange |
1..1 |
float |
This is the case input target range. This performs the same function as the value2 attribute on the regulation schedule in the case that schedules are not used. The units of those appropriate for the mode. |
|
targetValue |
1..1 |
float |
The target value specified for case input. This value can be used for the target value wihout the use of schedules. The value has the units appropriate to the mode attribute. |
|
Terminal |
1..1 |
The terminal associated with this regulating control. |
|
aliasName |
0..1 |
string |
see IdentifiedObject |
|---|---|---|---|
|
description |
0..1 |
string |
see IdentifiedObject |
|
name |
0..1 |
string |
see IdentifiedObject |
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. Negative values for mVArPerSection and nominalMVAr indicate that the compensator is a reactor.
mVArPerSection and nominalMVAr is now bPerSection.
|
b0PerSection |
0..1 |
Zero sequence shunt (charging) susceptance per section This is for Short Circuit only. |
|
|---|---|---|---|
|
bPerSection |
1..1 |
Positive sequence shunt (charging) susceptance per section |
|
|
g0PerSection |
0..1 |
Zero sequence shunt (charging) conductance per section This is for Short Circuit only. |
|
|
gPerSection |
1..1 |
Positive sequence shunt (charging) conductance per section |
|
|
maximumSections |
1..1 |
integer |
For a capacitor bank, the maximum number of sections that may be switched in. |
|
RegulatingControl |
0..1 |
see RegulatingCondEq |
|---|
|
BaseVoltage |
0..1 |
|---|
|
equivalent |
0..1 |
boolean |
see Equipment |
|---|---|---|---|
|
MemberOf_EquipmentContainer |
0..1 |
see Equipment |
|
aliasName |
0..1 |
string |
see IdentifiedObject |
|---|---|---|---|
|
description |
0..1 |
string |
see IdentifiedObject |
|
name |
0..1 |
string |
see IdentifiedObject |
Core
A subset of a geographical region of a power system network model.
|
Region |
1..1 |
The association is used in the naming hierarchy. |
|---|
|
aliasName |
0..1 |
string |
see IdentifiedObject |
|---|---|---|---|
|
description |
0..1 |
string |
see IdentifiedObject |
|
name |
0..1 |
string |
see IdentifiedObject |
Core
A collection of equipment for purposes other than generation or utilization, through which electric energy in bulk is passed for the purposes of switching or modifying its characteristics.
|
Region |
1..1 |
The association is used in the naming hierarchy. |
|---|
|
aliasName |
0..1 |
string |
see IdentifiedObject |
|---|---|---|---|
|
description |
0..1 |
string |
see IdentifiedObject |
|
name |
0..1 |
string |
see IdentifiedObject |
StateVariables
State variable for power flow.
Only Terminal instances of EnergyConsumer and SynchronousMachine will have SvPowerFlow instances assigned.
The number of SvPowerFlow instances in the model should match the number EnergyConsumer plus SynchronousMachine objects in the model regardless of the Terminal.connected values.
Any SvPowerFlow with a Terminal.connected value of false must have zero flow explicitly specified on an SvPowerFlow instance.
The other types of terminals are not included in exchanges since their values can be readily computed from local voltages and attributes without a global powerflow solution.
|
p |
1..1 |
The active power flow into the terminal. If the associated Terminal.connected status is "false", the flow specified in the SvPowerFlow.p should be zero. The power flow is into the Terminal of the ConductingEquipment. |
|
|---|---|---|---|
|
q |
1..1 |
The reactive power flow into the terminal. If the associated Terminal.connected status is "false", the flow specified in the SvPowerFlow.q should be zero. The power flow is into the Terminal of the ConductingEquipment. |
|
|
Terminal |
1..1 |
The terminal associated with the power flow state. The SvPowerFlow is only associated with the Terminal objects of shunt injection classes EnergyConsumer and SynchronousMachine. Branch flows are not exchanged since they can be readily computed from the voltages, impedances, and for transformers additionally the tap parameters including the SvTapStep. Similarly, Switch flows are not included because they can typically be uniquely computed, except in the case of meshed networks of Switch objects. Terminals of the ShuntCompensator class are not associated because the injection value can be computed from the solved voltage, number of sections, Termianl.connected state, and the impedance per section attributes on the ShuntCompensator. |
StateVariables
State variable for the number of sections in service for a shunt compensator.
A SvShuntCompensator is always associated with any instance of ShuntCompensator. The sections or continuousSections values are specified depending upon the value of the associated RegulatingControl.discrete attribute. If no RegulatingControl is associated, then the ShuntCompensator is treated as discrete. In discrete mode, the "sections" attribute must be present. In the not "discrete" mode (continuous mode) the "continuousSections" attribute must be present. In the case the Terminal.connected value is "false" the specificed number of sections is not meaningful to the powerflow solution and powerflow implementations should interpret this as zero injection. Note that an SvShuntCompensatorSections should be supplied even for ShuntCompensators whose Terminal.connected status is "false" to keep total number of ShuntCompensator and SvShuntCompensatorSection objects in the model the same.
|
continuousSections |
1..1 |
float |
The number of sections in service as a continous variable. |
|---|---|---|---|
|
ShuntCompensator |
1..1 |
The shunt compensator for which the state applies. |
StateVariables
State variable for transformer tap step. Normally a profile specifies only one of the attributes "position"or "continuousPosition".
SvTapStep is only meant to be used for taps that change under load.
|
continuousPosition |
1..1 |
float |
The floating point tap position. |
|---|---|---|---|
|
TapChanger |
1..1 |
The tap changer associated with the tap step state. |
StateVariables
State variable for voltage.
|
angle |
1..1 |
The voltage angle in radians of the topological node. |
|
|---|---|---|---|
|
v |
1..1 |
The voltage magnitude of the topological node. |
|
|
TopologicalNode |
1..1 |
The topological node associated with the voltage state. |
Wires
A generic device designed to close, or open, or both, one or more electric circuits.
|
BaseVoltage |
0..1 |
|---|
|
equivalent |
0..1 |
boolean |
see Equipment |
|---|---|---|---|
|
MemberOf_EquipmentContainer |
0..1 |
see Equipment |
|
aliasName |
0..1 |
string |
see IdentifiedObject |
|---|---|---|---|
|
description |
0..1 |
string |
see IdentifiedObject |
|
name |
0..1 |
string |
see IdentifiedObject |
Wires
An electromechanical device that operates synchronously with the network. It is a single machine operating either as a generator or synchronous condenser or pump.
In this profile:
- If a SynchronousMachine is not associated with a ReactiveCapabilityCurve, then the minQ and maxQ attributes will be used.
- If a ReactiveCapabilityCurve is supplied, then the minQ and maxQ attributes are not required.
- For UCTE, there is no synchronous condenser mode; therefore, the SynchronousMachine must be associated with one and only one GeneratingUnit. In this case, the type and operatingMode attributes must both be set to “condenser”.
|
maxQ |
0..1 |
Maximum reactive power limit. This is the maximum (nameplate) limit for the unit. |
|
|---|---|---|---|
|
minQ |
0..1 |
Minimum reactive power limit for the unit. |
|
|
operatingMode |
1..1 |
Current mode of operation. |
|
|
qPercent |
1..1 |
Percent of the coordinated reactive control that comes from this machine. |
|
|
r |
1..1 |
Positive sequence resistance of the synchronous machine. |
|
|
r0 |
0..1 |
Zero sequence resistance of the synchronous machine. This is for Short Circuit only. |
|
|
r2 |
0..1 |
Negative sequence resistance. This is for Short Circuit only. |
|
|
ratedS |
1..1 |
Nameplate apparent power rating for the unit |
|
|
type |
1..1 |
Modes that this synchronous machine can operate in. |
|
|
x |
1..1 |
Positive sequence reactance of the synchronous machine. |
|
|
x0 |
0..1 |
Zero sequence reactance of the synchronous machine. This is for Short Circuit only. |
|
|
x2 |
0..1 |
Negative sequence reactance. This is for Short Circuit only. |
|
|
InitialReactiveCapabilityCurve |
0..1 |
The default ReactiveCapabilityCurve for use by a SynchronousMachine |
|
|
MemberOf_GeneratingUnit |
1..1 |
A synchronous machine may operate as a generator and as such becomes a member of a generating unit Each SynchronousMachine is a member of one and only one GeneratingUnit plus each GeneratingUnit should have one and only one SynchronousMachine. This is required to properly proportion generation limits specified on GeneratingUnit to the appropriate injection points specified by SynchronousMachine and its Terminal connection. |
|
RegulatingControl |
0..1 |
see RegulatingCondEq |
|---|
|
BaseVoltage |
0..1 |
|---|
|
equivalent |
0..1 |
boolean |
see Equipment |
|---|---|---|---|
|
MemberOf_EquipmentContainer |
0..1 |
see Equipment |
|
aliasName |
0..1 |
string |
see IdentifiedObject |
|---|---|---|---|
|
description |
0..1 |
string |
see IdentifiedObject |
|
name |
0..1 |
string |
see IdentifiedObject |
Core
An electrical connection point to a piece of conducting equipment. Terminals are connected at physical connection points called "connectivity nodes".
The SvPowerFlow is only associated with the Terminal objects of shunt injection classes such as EnergyConsumer and SynchronousMachine. The flows at any ShuntCompensator can always be computed from connected voltage magnitude, number of sections and local attributes.
Branch flows are not exchanged since they can be readily be computed from the voltages, impedances, and for transformers additionally the tap parameters including the SvTapStep.
|
connected |
1..1 |
boolean |
The terminal connection status. True implies the terminal is connected, and false implies the terminal is not connected. This is the result of topoplogical processing of a detailed Connectivity node and Switch model whether present in the model or not. A terminal that is not connected cannot support a current flow. A terminal that is connected may have flow. In general a multi-terminal device may simultaneously have connected and disconnected terminals. No other aspect of the algorithm for topological analysis is implied. |
|---|---|---|---|
|
sequenceNumber |
0..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. In the case of class TransformerWinding only one terminal is used so its sequenceNumber must be 1. For UCTE profile, the terminal sequence number is not required. And, when used, follows the UML description. 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. In the case of class TransformerWinding only one terminal is used so its sequenceNumber must be 1. |
|
ConductingEquipment |
1..1 |
ConductingEquipment has 1 or 2 terminals that may be connected to other ConductingEquipment terminals via ConnectivityNodes |
|
|
TopologicalNode |
1..1 |
The topological node associated with the terminal. This can be used as an alternative to the connectivity node path to topological node, thus making it unneccesary to model connedtivity nodes in some cases. Note that the if connectivity nodes are in the model, this association would proably not be used. |
|
aliasName |
0..1 |
string |
see IdentifiedObject |
|---|---|---|---|
|
description |
0..1 |
string |
see IdentifiedObject |
|
name |
0..1 |
string |
see IdentifiedObject |
Production
A generating unit whose prime mover could be a steam turbine, combustion turbine, or diesel engine.
|
FossilFuels |
1..1 |
A thermal generating unit may have one or more fossil fuels The UCTE profile allows only one type of fuel per ThermalGeneratingUnit. |
|---|
ControlArea
A flow specification in terms of location and direction for a control area.
|
positiveFlowIn |
1..1 |
boolean |
The flow is positive into the terminal. A flow is positive if it is an import into the control area. The power flow is positive into the Terminal of the ConductingEquipment. |
|---|---|---|---|
|
ControlArea |
1..1 |
The control area of the tie flows. |
|
|
Terminal |
1..1 |
The terminal to which this tie flow belongs. |
Topology
An electrically connected subset of the network. Topological islands can change as the current network state changes (i.e., disconnect switches, breakers, etc. change state).
|
AngleRef_TopologicalNode |
0..1 |
The angle reference for the island. Normally there is one TopologicalNode that is selected as the angle reference for each island. Other reference schemes exist, so the association is optional. |
|---|
|
aliasName |
0..1 |
string |
see IdentifiedObject |
|---|---|---|---|
|
description |
0..1 |
string |
see IdentifiedObject |
|
name |
0..1 |
string |
see IdentifiedObject |
Topology
A set of connectivity nodes that, in the current network state, are connected together through any type of closed switches, including jumpers. Topological nodes can change as the current network state changes (i.e., switches, breakers, etc. change state).
|
equivalent |
0..1 |
boolean |
The topological node is equivalent and not real equipment. If this is missing, it is assumed to be False. If it is an X-Node, this equivalent is required. |
|---|---|---|---|
|
r0PerR |
0..1 |
float |
The ratio of zero sequence resistance to positive sequence resistance. This is for Short Circuit only. |
|
sShortCircuit |
0..1 |
The short circuit apparent power drawn at this node when faulted. This is for Short Circuit only. |
|
|
x0PerX |
0..1 |
float |
The ratio of zero sequence reactance per positive sequence reactance. This is for Short Circuit only. |
|
xPerR |
0..1 |
float |
Ratio of positive sequence reactance per postive sequence resistance. This is for Short Circuit only. |
|
BaseVoltage |
1..1 |
The base voltage of the topologocial node. The base voltage of the TopologicalNode should match the BaseVoltage of the containing VoltageLevel if such a containing VoltageLevel is specified. |
|
|
ConnectivityNodeContainer |
0..1 |
The connectivity node container to which the toplogical node belongs. The TopologicalNode will normally belong only to a VoltageLevel instance within a Substation. All instances of TopologicalNode that are not X-nodes will require an association to a containing VoltageLevel instance. The BaseVoltage of the VoltageLevel should match that of the TopologicalNode itself. A TopologicalNode object used for an X-node will not be contained, thus this association is specified as optional in the profile. |
|
|
ControlArea |
1..1 |
The control area into which the node is included. |
|
|
TopologicalIsland |
1..1 |
A topological node belongs to a topological island |
|
aliasName |
0..1 |
string |
see IdentifiedObject |
|---|---|---|---|
|
description |
0..1 |
string |
see IdentifiedObject |
|
name |
0..1 |
string |
see IdentifiedObject |
Wires
A winding is associated with each defined terminal of a transformer (or phase shifter).
The association between the TransformerWinding class and MemberOf_EquipmentContainer is not used in this Profile since the association to Power Transformer is already there. The only time this association should be used is if the association refers to a different substation than what is used in the PowerTransformer association.
|
b |
1..1 |
Magnetizing branch susceptance (B mag). |
|
|---|---|---|---|
|
b0 |
0..1 |
Zero sequence magnetizing branch susceptance. This is for Short Circuit only. |
|
|
connectionType |
1..1 |
The type of connection of the winding. |
|
|
g |
1..1 |
Magnetizing branch conductance (G mag). |
|
|
g0 |
0..1 |
Zero sequence magnetizing branch conductance. This is for Short Circuit only. |
|
|
r |
1..1 |
Positive sequence series resistance of the winding. |
|
|
r0 |
0..1 |
Zero sequence series resistance of the winding. This is for Short Circuit only. |
|
|
ratedS |
1..1 |
The normal apparent power rating for the winding |
|
|
ratedU |
1..1 |
The rated voltage (phase-to-phase) of the winding, usually the same as the neutral voltage. |
|
|
rground |
0..1 |
Ground resistance path through connected grounding transformer. This is for Short Circuit only. |
|
|
windingType |
1..1 |
The type of winding. |
|
|
x |
1..1 |
Positive sequence series reactance of the winding. |
|
|
x0 |
0..1 |
Zero sequence series reactance of the winding. This is for Short Circuit only. |
|
|
xground |
0..1 |
Ground reactance path through connected grounding transformer. This is for Short Circuit only. |
|
|
MemberOf_PowerTransformer |
1..1 |
A transformer has windings |
|
BaseVoltage |
0..1 |
|---|
|
equivalent |
0..1 |
boolean |
see Equipment |
|---|---|---|---|
|
MemberOf_EquipmentContainer |
0..1 |
see Equipment |
|
aliasName |
0..1 |
string |
see IdentifiedObject |
|---|---|---|---|
|
description |
0..1 |
string |
see IdentifiedObject |
|
name |
0..1 |
string |
see IdentifiedObject |
Core
A collection of equipment at one common system voltage forming a switchgear. The equipment typically consist of breakers, busbars, instrumentation, control, regulation and protection devices as well as assemblies of all these.
|
BaseVoltage |
1..1 |
The base voltage used for all equipment within the VoltageLevel. |
|
|---|---|---|---|
|
MemberOf_Substation |
1..1 |
The association is used in the naming hierarchy. |
|
aliasName |
0..1 |
string |
see IdentifiedObject |
|---|---|---|---|
|
description |
0..1 |
string |
see IdentifiedObject |
|
name |
0..1 |
string |
see IdentifiedObject |
OperationalLimits
Operational limit applied to voltage.
|
value |
1..1 |
Limit on voltage. High or low limit depends on the OperatoinalLimit.limitKind |
|---|
|
OperationalLimitSet |
1..1 |
see OperationalLimit |
|
|---|---|---|---|
|
OperationalLimitType |
1..1 |
see OperationalLimit |
|
aliasName |
0..1 |
string |
see IdentifiedObject |
|---|---|---|---|
|
description |
0..1 |
string |
see IdentifiedObject |
|
name |
0..1 |
string |
see IdentifiedObject |
Wires
A conductor, or group of conductors, with negligible impedance, that serve to connect other conducting equipment within a single substation.
Voltage measurements are typically obtained from VoltageTransformers that are connected to busbar sections. A bus bar section may have many physical terminals but for analysis is modelled with exactly one logical terminal.
Terminals of Switches can also be used for regulation.
|
VoltageControlZone |
1..1 |
A VoltageControlZone is controlled by a designated BusbarSection. |
|---|
Core
The parts of the power system that are designed to carry current or that are conductively connected therewith. ConductingEquipment is contained within an EquipmentContainer that may be a Substation, or a VoltageLevel or a Bay within a Substation.
|
BaseVoltage |
0..1 |
Use association to ConductingEquipment only when there is no VoltageLevel container used. The profile requires a BaseVoltage associaton on ConductingEquipment subtypes of classes ACLineSegment and TransformerWinding. The association is not used for any other subtypes. |
|---|
|
equivalent |
0..1 |
boolean |
see Equipment |
|---|---|---|---|
|
MemberOf_EquipmentContainer |
0..1 |
see Equipment |
|
aliasName |
0..1 |
string |
see IdentifiedObject |
|---|---|---|---|
|
description |
0..1 |
string |
see IdentifiedObject |
|
name |
0..1 |
string |
see IdentifiedObject |
Wires
Combination of conducting material with consistent electrical characteristics, building a single electrical system, used to carry current between points in the power system.
|
b0ch |
0..1 |
Zero sequence shunt (charging) susceptance, uniformly distributed, of the entire line section. This is for Short Circuit only. |
|
|---|---|---|---|
|
bch |
1..1 |
Positive sequence shunt (charging) susceptance, uniformly distributed, of the entire line section. |
|
|
g0ch |
0..1 |
Zero sequence shunt (charging) conductance, uniformly distributed, of the entire line section. This is for Short Circuit only. |
|
|
gch |
0..1 |
Positive sequence shunt (charging) conductance, uniformly distributed, of the entire line section. This is for Short Circuit only. |
|
|
length |
0..1 |
Segment length for calculating line section capabilities Required only for ACLineSegement objects involved in MutualCoupling. |
|
|
r |
1..1 |
Positive sequence series resistance of the entire line section. |
|
|
r0 |
0..1 |
Zero sequence series resistance of the entire line section. This is for Short Circuit only. |
|
|
x |
1..1 |
Positive sequence series reactance of the entire line section. |
|
|
x0 |
0..1 |
Zero sequence series reactance of the entire line section. This is for Short Circuit only. |
|
BaseVoltage |
0..1 |
|---|
|
equivalent |
0..1 |
boolean |
see Equipment |
|---|---|---|---|
|
MemberOf_EquipmentContainer |
0..1 |
see Equipment |
|
aliasName |
0..1 |
string |
see IdentifiedObject |
|---|---|---|---|
|
description |
0..1 |
string |
see IdentifiedObject |
|
name |
0..1 |
string |
see IdentifiedObject |
Core
A base class for all objects that may contain ConnectivityNodes or TopologicalNodes.
The TopologicalNode will normally belong only to a VoltageLevel within a Substation.
In the case of X-nodes, the TopologicalNode is not contained.
|
aliasName |
0..1 |
string |
see IdentifiedObject |
|---|---|---|---|
|
description |
0..1 |
string |
see IdentifiedObject |
|
name |
0..1 |
string |
see IdentifiedObject |
Core
Relationship between an independent variable (X-axis) and one or two dependent
variables (Y1-axis and Y2-axis). Curves can also serve as schedules.
|
aliasName |
0..1 |
string |
see IdentifiedObject |
|---|---|---|---|
|
description |
0..1 |
string |
see IdentifiedObject |
|
name |
0..1 |
string |
see IdentifiedObject |
Core
The parts of a power system that are physical devices, electronic or mechanical
|
equivalent |
0..1 |
boolean |
Indicates if the equipment is real equipment (false) or an equivalent. If this is missing, it is assumed to be False. It is required for Equipment connected to the X-Node. All classes derived from Equipment are to include this attribute except for the TransformerWinding class. For transformers the PowerTransformer class will be used to specify the real or equivalent status and the contained TransformerWinding class instances need not and should not specify this attribute. |
|---|---|---|---|
|
MemberOf_EquipmentContainer |
0..1 |
The association is used in the naming hierarchy. For a TransformerWinding and ACLineSegment, the association Equipment.MemberOf_EquipmentContainer is not used. The TransformerWinding instance is instead contained within a PowerTransformer unless the association refers to a different substation than what is used in the PowerTransformer association. |
|
aliasName |
0..1 |
string |
see IdentifiedObject |
|---|---|---|---|
|
description |
0..1 |
string |
see IdentifiedObject |
|
name |
0..1 |
string |
see IdentifiedObject |
Core
A modeling construct to provide a root class for all Equipment classes
For a TransformerWinding the association Equipment.MemberOf_EquipmentContainer is not used. The TransformerWinding instance is instead contained within a PowerTransformer unless the association refers to a different substation than what is used in the PowerTransformer Association.
|
aliasName |
0..1 |
string |
see IdentifiedObject |
|---|---|---|---|
|
description |
0..1 |
string |
see IdentifiedObject |
|
name |
0..1 |
string |
see IdentifiedObject |
Equivalents
The class represents equivalent objects that are the result of a network reduction. The class is the base for equivalent objects of different types.
|
BaseVoltage |
0..1 |
|---|
|
equivalent |
0..1 |
boolean |
see Equipment |
|---|---|---|---|
|
MemberOf_EquipmentContainer |
0..1 |
see Equipment |
|
aliasName |
0..1 |
string |
see IdentifiedObject |
|---|---|---|---|
|
description |
0..1 |
string |
see IdentifiedObject |
|
name |
0..1 |
string |
see IdentifiedObject |
Core
This is a root class to provide common naming attributes for all classes needing naming attributes
|
aliasName |
0..1 |
string |
The aliasName is free text human readable name of the object alternative to IdentifiedObject.name. It may be non unique and may not correlate to a naming hierarchy. In the UCTE profile the aliasName is used to hold the EIC code. The code length is 16 characters. Not all CIM classes have an EIC code so the attribute is optional. |
|---|---|---|---|
|
description |
0..1 |
string |
The description is a free human readable text describing or naming the object. It may be non unique and may not correlate to a naming hierarchy. |
|
name |
0..1 |
string |
The name is a free text human readable name of the object. It may be non unique and may not correlate to a naming hierarchy. This attribute is required on all instances in this Profile that inherit from IdentifiedObject except for the following Classes: 1) BaseVoltage; 2) Terminal; 3) TransformerWinding; 4) RatioTapChanger; 5) PhaseTapChanger; 6) OperationalLImitSet; 7) CurrentLimit; and, 8) VoltageLimit. |
Wires
A component part of a system extending between adjacent substations or from a substation to an adjacent interconnection point.
|
aliasName |
0..1 |
string |
see IdentifiedObject |
|---|---|---|---|
|
description |
0..1 |
string |
see IdentifiedObject |
|
name |
0..1 |
string |
see IdentifiedObject |
OperationalLimits
A value associated with a specific kind of limit.
|
OperationalLimitSet |
1..1 |
The limit set to which the limit values belong. |
|
|---|---|---|---|
|
OperationalLimitType |
1..1 |
The limit type associated with this limit. |
|
aliasName |
0..1 |
string |
see IdentifiedObject |
|---|---|---|---|
|
description |
0..1 |
string |
see IdentifiedObject |
|
name |
0..1 |
string |
see IdentifiedObject |
Wires
RegulatingCondEq is a type of ConductingEquipment that can regulate Measurements and have a RegulationSchedule.
|
RegulatingControl |
0..1 |
copy from ... Regulating control scheme in which this equipment participates. |
|---|
|
BaseVoltage |
0..1 |
|---|
|
equivalent |
0..1 |
boolean |
see Equipment |
|---|---|---|---|
|
MemberOf_EquipmentContainer |
0..1 |
see Equipment |
|
aliasName |
0..1 |
string |
see IdentifiedObject |
|---|---|---|---|
|
description |
0..1 |
string |
see IdentifiedObject |
|
name |
0..1 |
string |
see IdentifiedObject |
Wires
Mechanism for changing transformer winding tap positions.
|
highStep |
1..1 |
integer |
Highest possible tap step position, advance from neutral |
|---|---|---|---|
|
lowStep |
1..1 |
integer |
Lowest possible tap step position, retard from neutral |
|
neutralStep |
1..1 |
integer |
The neutral tap step position for this winding. This attribute is used to define the neutral step for a tap changer or a phase tap changer. The neutralStep value cannot be higher than the highStep value or lower than the lowStep value. |
|
neutralU |
1..1 |
Voltage at which the winding operates at the neutral tap setting. |
|
|
stepVoltageIncrement |
0..1 |
Tap step increment, in per cent of nominal voltage, per step position. This could be supplanted by more detailed model information in either the PhaseTapChanger if modeled or in detailed per tap step table information. This is required for RatioTapChanger. It is Optional for most phase shifters since these are not used to regulate voltages |
|
|
RegulatingControl |
0..1 |
|
aliasName |
0..1 |
string |
see IdentifiedObject |
|---|---|---|---|
|
description |
0..1 |
string |
see IdentifiedObject |
|
name |
0..1 |
string |
see IdentifiedObject |
Production
Type of fuel.
|
coal |
hard coal |
|---|---|
|
gas |
|
|
lignite |
The fuel is lignite coal. Note that this is a special type of coal, so the other enum of coal is reserved for hard coal types or if the exact type of coal is not known. |
|
oil |
OperationalLimits
The direction of an operational limit.
For the high and low attributes, the positive direction of the flow is into the Terminal of the ConductingEquipment.
|
absoluteValue |
If the absolute value of the monitored value is above the limit value, the limit is violated. In effect, the limit is both a high limit and its negative a low limit. |
|---|---|
|
high |
The limit is a high limit. If applied to a terminal flow, the positive direction is into the terminal. |
|
low |
The limit is a low limit. If applied to a terminal flow, the positive direction is into the terminal. |
Wires
The construction type of the phase shifting tap changer.
For the UCTE Profile, the "Unknown" type has been removed for this Enumeration.
|
asymmetrical |
Asymmetrical phase shifter construction. The assymetrical construction type causes the voltage ratio to change as the phase shift changes. An asymmetrical phase shifter can have the out-of-phase winding connected at 90 degrees or otherwise. |
|---|---|
|
symmetrical |
The phase shifter construction is symmetrical. A symmetrical construction causes the turns ratio and voltage magnitude transformation to remain constant while the voltage phase is shifted. A symmetrical construction typically requires the out of phase winding to be connected at 90 degrees. |
Wires
The kind of regulation model. For example regulating voltage, reactive power, active power, etc.
|
activePower |
Active power is specified. |
|---|---|
|
admittance |
Admittance is specified |
|
currentFlow |
Current flow is specified. |
|
fixed |
The regulation mode is fixed, and thus not regulating. |
|
reactivePower |
Reactive power is specified. |
|
voltage |
Voltage is specified. |
Wires
Winding type.
For UCTE, a WindingType of Quaternary is not allowed; therefore, that type has been removed from this Enumeration.
|
primary |
|
|---|---|
|
secondary |
|
|
tertiary |
Product of RMS value of the voltage and the RMS value of the in-phase component of the current
XSD type: float
Product of the RMS value of the voltage and the RMS value of the current
XSD type: float
Factor by which voltage must be multiplied to give corresponding power lost from a circuit. Real part of admittance.
XSD type: float
Electrical current (positive flow is out of the ConductingEquipment into the ConnectivityNode)
XSD type: float
Product of RMS value of the voltage and the RMS value of the quadrature component of the current.
XSD type: float