IEC 61970-301:2011

IEC 61970-301 ®
Edition 3.0 2011-08
INTERNATIONAL
STANDARD
NORME
INTERNATIONALE
colour
inside
Energy management system application program interface (EMS-API) –
Part 301: Common information model (CIM) base

Interface de programmation d'application pour système de gestion d'énergie
(EMS-API) –
Partie 301: Base de modèle d'information commun (CIM)

All rights reserved. Unless otherwise specified, no part of this publication may be reproduced or utilized in any form or by
any means, electronic or mechanical, including photocopying and microfilm, without permission in writing from either IEC or
IEC's member National Committee in the country of the requester.
If you have any questions about IEC copyright or have an enquiry about obtaining additional rights to this publication,
please contact the address below or your local IEC member National Committee for further information.

Droits de reproduction réservés. Sauf indication contraire, aucune partie de cette publication ne peut être reproduite
ni utilisée sous quelque forme que ce soit et par aucun procédé, électronique ou mécanique, y compris la photocopie
et les microfilms, sans l'accord écrit de la CEI ou du Comité national de la CEI du pays du demandeur.
Si vous avez des questions sur le copyright de la CEI ou si vous désirez obtenir des droits supplémentaires sur cette
publication, utilisez les coordonnées ci-après ou contactez le Comité national de la CEI de votre pays de résidence.

IEC Central Office
3, rue de Varembé
CH-1211 Geneva 20
Switzerland
Email: inmail@iec.ch
Web: www.iec.ch
About the IEC
The International Electrotechnical Commission (IEC) is the leading global organization that prepares and publishes
International Standards for all electrical, electronic and related technologies.

About IEC publications
The technical content of IEC publications is kept under constant review by the IEC. Please make sure that you have the
latest edition, a corrigenda or an amendment might have been published.
 Catalogue of IEC publications: www.iec.ch/searchpub
The IEC on-line Catalogue enables you to search by a variety of criteria (reference number, text, technical committee,…).
It also gives information on projects, withdrawn and replaced publications.
 IEC Just Published: www.iec.ch/online_news/justpub
Stay up to date on all new IEC publications. Just Published details twice a month all new publications released. Available
on-line and also by email.
 Electropedia: www.electropedia.org
The world's leading online dictionary of electronic and electrical terms containing more than 20 000 terms and definitions
in English and French, with equivalent terms in additional languages. Also known as the International Electrotechnical
Vocabulary online.
 Customer Service Centre: www.iec.ch/webstore/custserv
If you wish to give us your feedback on this publication or need further assistance, please visit the Customer Service
Centre FAQ or contact us:
Email: csc@iec.ch
Tel.: +41 22 919 02 11
Fax: +41 22 919 03 00
A propos de la CEI
La Commission Electrotechnique Internationale (CEI) est la première organisation mondiale qui élabore et publie des
normes internationales pour tout ce qui a trait à l'électricité, à l'électronique et aux technologies apparentées.

A propos des publications CEI
Le contenu technique des publications de la CEI est constamment revu. Veuillez vous assurer que vous possédez
l’édition la plus récente, un corrigendum ou amendement peut avoir été publié.
 Catalogue des publications de la CEI: www.iec.ch/searchpub/cur_fut-f.htm
Le Catalogue en-ligne de la CEI vous permet d’effectuer des recherches en utilisant différents critères (numéro de référence,
texte, comité d’études,…). Il donne aussi des informations sur les projets et les publications retirées ou remplacées.
 Just Published CEI: www.iec.ch/online_news/justpub
Restez informé sur les nouvelles publications de la CEI. Just Published détaille deux fois par mois les nouvelles
publications parues. Disponible en-ligne et aussi par email.
 Electropedia: www.electropedia.org
Le premier dictionnaire en ligne au monde de termes électroniques et électriques. Il contient plus de 20 000 termes et
définitions en anglais et en français, ainsi que les termes équivalents dans les langues additionnelles. Egalement appelé
Vocabulaire Electrotechnique International en ligne.
 Service Clients: www.iec.ch/webstore/custserv/custserv_entry-f.htm
Si vous désirez nous donner des commentaires sur cette publication ou si vous avez des questions, visitez le FAQ du
Service clients ou contactez-nous:
Email: csc@iec.ch
Tél.: +41 22 919 02 11
Fax: +41 22 919 03 00
IEC 61970-301 ®
Edition 3.0 2011-08
INTERNATIONAL
STANDARD
NORME
INTERNATIONALE
colour
inside
Energy management system application program interface (EMS-API) –
Part 301: Common information model (CIM) base

Interface de programmation d'application pour système de gestion d'énergie
(EMS-API) –
Partie 301: Base de modèle d'information commun (CIM)
INTERNATIONAL
ELECTROTECHNICAL
COMMISSION
COMMISSION
ELECTROTECHNIQUE
PRICE CODE
INTERNATIONALE
XH
CODE PRIX
ICS 33.200 ISBN 978-2-88912-669-9
– 2 – 61970-301 © IEC:2011
CONTENTS
FOREWORD . 12
INTRODUCTION . 14
1 Scope . 16
2 Normative references . 16
3 Terms and definitions . 17
4 CIM specification . 17
4.1 CIM modeling notation . 17
4.2 CIM packages . 17
4.2.1 CIM packages overview . 17
4.2.2 Domain . 19
4.2.3 Core . 20
4.2.4 OperationalLimits . 20
4.2.5 Topology . 20
4.2.6 Wires . 20
4.2.7 Generation . 20
4.2.8 LoadModel. 20
4.2.9 Outage . 20
4.2.10 Protection . 21
4.2.11 Equivalents. 21
4.2.12 Meas . 21
4.2.13 SCADA . 21
4.2.14 ControlArea . 21
4.2.15 Contingency . 21
4.3 CIM classes and relationships . 21
4.3.1 Classes . 21
4.3.2 Generalization . 22
4.3.3 Simple association . 23
4.3.4 Aggregation . 24
4.4 CIM model concepts and examples . 24
4.4.1 Concepts . 24
4.4.2 Containment, equipment hierarchies and naming . 24
4.4.3 Connectivity model . 26
4.4.4 Inheritance hierarchy . 29
4.4.5 Transformer model . 30
4.4.6 Measurements and controls . 32
4.4.7 Regulating control models . 36
4.5 Modeling guidelines . 36
4.5.1 Modeling for change . 36
4.5.2 Process for amendments to the CIM . 37
4.5.3 Changes to the CIM UML model . 37
4.5.4 Changes to the CIM standards documents . 37
4.5.5 CIM profiles . 37
4.6 Modeling tools . 38
4.7 User implementation conventions . 38
4.7.1 Conventions beyond UML . 38
4.7.2 Number of Terminals for ConductingEquipment objects . 38
4.8 CIM modeling examples . 38

61970-301 © IEC:2011 – 3 –
5 Detailed model . 39
5.1 Overview . 39
5.2 Context . 39
6 Package architecture (normative) . 41
6.1 IEC 61970 . 41
6.1.1 IEC 61970 package summary . 41
6.1.2 IEC 61970CIMVersion . 41
6.2 Domain. 42
6.2.1 Domain package summary . 42
6.2.2 AbsoluteDate Datatype . 46
6.2.3 AbsoluteDateTime Datatype . 46
6.2.4 ActivePower Datatype . 46
6.2.5 ActivePowerChangeRate Datatype . 47
6.2.6 Admittance Datatype . 47
6.2.7 AngleDegrees Datatype . 47
6.2.8 AngleRadians Datatype . 47
6.2.9 ApparentPower Datatype . 47
6.2.10 Boolean Primitive . 47
6.2.11 Capacitance Datatype . 48
6.2.12 Conductance Datatype . 48
6.2.13 CostPerEnergyUnit Datatype . 48
6.2.14 CostRate Datatype . 48
6.2.15 Currency enumeration . 48
6.2.16 CurrentFlow Datatype . 49
6.2.17 Damping Datatype . 49
6.2.18 Float Primitive . 49
6.2.19 FloatQuantity Datatype . 49
6.2.20 Frequency Datatype . 50
6.2.21 Hours Datatype . 50
6.2.22 Impedance Datatype . 50
6.2.23 Inductance Datatype . 50
6.2.24 Integer Primitive . 50
6.2.25 IntegerQuantity Datatype . 51
6.2.26 KWActivePower Datatype . 51
6.2.27 LongLength Datatype . 51
6.2.28 Minutes Datatype. 51
6.2.29 MonetaryAmountPerEnergyUnit enumeration . 51
6.2.30 MonetaryAmountPerHeatUnit enumeration . 51
6.2.31 MonetaryAmountRate enumeration . 52
6.2.32 Money Datatype . 52
6.2.33 PerCent Datatype . 52
6.2.34 Pressure Datatype . 52
6.2.35 PU Datatype . 52
6.2.36 Reactance Datatype . 53
6.2.37 ReactivePower Datatype . 53
6.2.38 RealEnergy Datatype . 53
6.2.39 Resistance Datatype. 53
6.2.40 RotationSpeed Datatype . 53
6.2.41 Seconds Datatype . 54

– 4 – 61970-301 © IEC:2011
6.2.42 ShortLength Datatype . 54
6.2.43 String Primitive . 54
6.2.44 StringQuantity Datatype . 54
6.2.45 Susceptance Datatype . 54
6.2.46 Temperature Datatype . 55
6.2.47 UnitMultiplier enumeration . 55
6.2.48 UnitSymbol enumeration . 55
6.2.49 Voltage Datatype . 56
6.2.50 VoltagePerReactivePower Datatype . 56
6.2.51 Volume Datatype . 56
6.2.52 WaterLevel Datatype . 57
6.2.53 Weight Datatype . 57
6.3 Core . 57
6.3.1 Core package summary . 57
6.3.2 BasePower . 62
6.3.3 BaseVoltage . 62
6.3.4 BasicIntervalSchedule . 62
6.3.5 Bay . 63
6.3.6 BreakerConfiguration Enumeration . 64
6.3.7 BusbarConfiguration Enumeration . 64
6.3.8 Company . 64
6.3.9 CompanyType enumeration . 65
6.3.10 ConductingEquipment . 65
6.3.11 ConnectivityNodeContainer . 66
6.3.12 Curve . 66
6.3.13 CurveData . 67
6.3.14 CurveStyle enumeration . 67
6.3.15 Equipment . 68
6.3.16 EquipmentContainer . 68
6.3.17 GeographicalRegion . 69
6.3.18 IdentifiedObject . 70
6.3.19 IrregularIntervalSchedule. 70
6.3.20 IrregularTimePoint . 71
6.3.21 ModelingAuthority . 71
6.3.22 ModelingAuthoritySet . 72
6.3.23 OperatingParticipant . 72
6.3.24 OperatingShare . 73
6.3.25 PhaseCode enumeration . 73
6.3.26 PowerSystemResource . 74
6.3.27 PsrList . 75
6.3.28 PSRType . 75
6.3.29 RegularIntervalSchedule . 76
6.3.30 RegularTimePoint . 76
6.3.31 ReportingGroup . 77
6.3.32 ReportingSuperGroup . 77
6.3.33 SubGeographicalRegion . 78
6.3.34 Substation . 78
6.3.35 Terminal . 79
6.3.36 Unit . 80

61970-301 © IEC:2011 – 5 –
6.3.37 VoltageLevel . 81
6.4 OperationalLimits . 82
6.4.1 OperationalLimits package summary . 82
6.4.2 ActivePowerLimit . 83
6.4.3 ApparentPowerLimit . 84
6.4.4 BranchGroup . 84
6.4.5 BranchGroupTerminal . 85
6.4.6 CurrentLimit. 85
6.4.7 OperationalLimit . 85
6.4.8 OperationalLimitDirectionKind enumeration . 86
6.4.9 OperationalLimitSet . 86
6.4.10 OperationalLimitType . 87
6.4.11 VoltageLimit . 87
6.5 Topology . 88
6.5.1 Topology package summary . 88
6.5.2 BusNameMarker . 91
6.5.3 ConnectivityNode . 92
6.5.4 TopologicalIsland . 93
6.5.5 TopologicalNode . 93
6.6 Wires . 94
6.6.1 Wires package summary . 94
6.6.2 ACLineSegment. 104
6.6.3 Breaker . 105
6.6.4 BusbarSection . 106
6.6.5 CompositeSwitch . 107
6.6.6 CompositeSwitchType Datatype . 108
6.6.7 Conductor . 108
6.6.8 ConductorType . 109
6.6.9 Connector . 110
6.6.10 CoolantType enumeration . 111
6.6.11 DCLineSegment . 111
6.6.12 Disconnector . 112
6.6.13 EnergyConsumer . 113
6.6.14 EnergySource . 114
6.6.15 FrequencyConverter . 115
6.6.16 Fuse . 116
6.6.17 Ground . 117
6.6.18 GroundDisconnector . 118
6.6.19 HeatExchanger . 118
6.6.20 Jumper . 119
6.6.21 Junction . 120
6.6.22 Line . 121
6.6.23 LoadBreakSwitch . 122
6.6.24 MutualCoupling . 123
6.6.25 OperatingMode Datatype . 123
6.6.26 Plant . 124
6.6.27 PowerTransformer . 124
6.6.28 ProtectedSwitch . 125
6.6.29 ReactiveCapabilityCurve . 126

– 6 – 61970-301 © IEC:2011
6.6.30 RectifierInverter . 127
6.6.31 RegulatingCondEq . 128
6.6.32 RegulatingControl . 129
6.6.33 RegulatingControlModeKind enumeration . 130
6.6.34 RegulationSchedule. 130
6.6.35 SeriesCompensator . 131
6.6.36 ShuntCompensator . 132
6.6.37 StaticVarCompensator . 133
6.6.38 SVCControlMode enumeration . 134
6.6.39 Switch . 134
6.6.40 SynchronousMachine . 135
6.6.41 SynchronousMachineOperatingMode enumeration . 138
6.6.42 SynchronousMachineType enumeration. 138
6.6.43 TapChanger . 138
6.6.44 TapChangerKind enumeration . 139
6.6.45 TransformerControlMode enumeration . 139
6.6.46 TransformerCoolingType enumeration . 140
6.6.47 TransformerWinding . 140
6.6.48 VoltageControlZone . 141
6.6.49 WindingConnection enumeration . 142
6.6.50 WindingTest . 142
6.6.51 WindingType enumeration . 143
6.6.52 WireArrangement . 143
6.6.53 WireType . 144
6.7 Generation ‒ Generation package summary . 145
6.8 Production . 145
6.8.1 Production package summary . 145
6.8.2 AirCompressor . 150
6.8.3 CAESPlant . 151
6.8.4 Classification Datatype . 152
6.8.5 CogenerationPlant . 152
6.8.6 CombinedCyclePlant . 153
6.8.7 CostPerHeatUnit Datatype . 153
6.8.8 Emission Datatype . 153
6.8.9 EmissionAccount . 154
6.8.10 EmissionCurve . 154
6.8.11 EmissionType enumeration . 155
6.8.12 EmissionValueSource enumeration . 155
6.8.13 FossilFuel . 156
6.8.14 FuelAllocationSchedule . 157
6.8.15 FuelType enumeration . 157
6.8.16 GeneratingUnit . 158
6.8.17 GeneratorControlMode enumeration . 160
6.8.18 GeneratorControlSource enumeration. 160
6.8.19 GeneratorOperatingMode enumeration . 161
6.8.20 GenUnitOpCostCurve . 161
6.8.21 GenUnitOpSchedule . 162
6.8.22 GrossToNetActivePowerCurve . 162
6.8.23 HeatInputCurve . 163

61970-301 © IEC:2011 – 7 –
6.8.24 HeatRate Datatype . 164
6.8.25 HeatRateCurve . 164
6.8.26 HydroEnergyConversionKind enumeration . 165
6.8.27 HydroGeneratingEfficiencyCurve . 165
6.8.28 HydroGeneratingUnit . 166
6.8.29 HydroPlantType enumeration . 168
6.8.30 HydroPowerPlant . 168
6.8.31 HydroPump . 169
6.8.32 HydroPumpOpSchedule. 170
6.8.33 IncrementalHeatRateCurve . 171
6.8.34 InflowForecast . 171
6.8.35 LevelVsVolumeCurve . 172
6.8.36 NuclearGeneratingUnit . 173
6.8.37 PenstockLossCurve . 174
6.8.38 PenstockType enumeration . 175
6.8.39 Reservoir . 175
6.8.40 ShutdownCurve . 176
6.8.41 SpillwayGateType Enumeration . 177
6.8.42 StartIgnFuelCurve . 177
6.8.43 StartMainFuelCurve . 178
6.8.44 StartRampCurve . 178
6.8.45 StartupModel . 179
6.8.46 SteamSendoutSchedule . 180
6.8.47 SurgeTankCode enumeration . 181
6.8.48 TailbayLossCurve . 181
6.8.49 TargetLevelSchedule . 181
6.8.50 ThermalGeneratingUnit. 182
6.9 GenerationDynamics . 185
6.9.1 GenerationDynamics package summary . 185
6.9.2 BoilerControlMode enumeration . 186
6.9.3 BWRSteamSupply . 186
6.9.4 CombustionTurbine . 187
6.9.5 CTTempActivePowerCurve . 188
6.9.6 DrumBoiler . 189
6.9.7 FossilSteamSupply . 190
6.9.8 HeatRecoveryBoiler . 191
6.9.9 HydroTurbine . 192
6.9.10 PrimeMover . 193
6.9.11 PWRSteamSupply . 194
6.9.12 SteamSupply . 195
6.9.13 SteamTurbine . 196
6.9.14 Subcritical . 197
6.9.15 Supercritical . 198
6.9.16 TurbineType enumeration . 199
6.10 LoadModel . 199
6.10.1 LoadModel package summary . 199
6.10.2 ConformLoad . 201
6.10.3 ConformLoadGroup . 201
6.10.4 ConformLoadSchedule . 202

– 8 – 61970-301 © IEC:2011
6.10.5 CustomerLoad . 203
6.10.6 DayType . 204
6.10.7 EnergyArea . 204
6.10.8 InductionMotorLoad . 204
6.10.9 Load . 205
6.10.10 LoadArea . 207
6.10.11 LoadGroup . 207
6.10.12 LoadResponseCharacteristic . 208
6.10.13 NonConformLoad . 209
6.10.14 NonConformLoadGroup . 210
6.10.15 NonConformLoadSchedule . 210
6.10.16 PowerCutZone . 211
6.10.17 Season . 212
6.10.18 SeasonDayTypeSchedule . 212
6.10.19 SeasonName enumeration . 212
6.10.20 StationSupply . 213
6.10.21 SubLoadArea. 214
6.11 Outage . 214
6.11.1 Outage package summary . 214
6.11.2 ClearanceTag . 215
6.11.3 ClearanceTagType . 216
6.11.4 OutageSchedule . 216
6.11.5 SwitchingOperation . 217
6.11.6 SwitchState enumeration . 218
6.12 Protection . 218
6.12.1 Protection package summary . 218
6.12.2 CurrentRelay . 218
6.12.3 ProtectionEquipment . 219
6.12.4 RecloseSequence . 220
6.12.5 SynchrocheckRelay . 221
6.13 Equivalents . 222
6.13.1 Equivalents package summary . 222
6.13.2 EquivalentBranch . 223
6.13.3 EquivalentEquipment . 224
6.13.4 EquivalentNetwork . 225
6.13.5 EquivalentShunt . 226
6.14 Meas . 227
6.14.1 Meas package summary . 227
6.14.2 Accumulator . 231
6.14.3 AccumulatorLimit . 232
6.14.4 AccumulatorLimitSet . 232
6.14.5 AccumulatorValue . 232
6.14.6 Analog . 233
6.14.7 AnalogLimit . 234
6.14.8 AnalogLimitSet . 234
6.14.9 AnalogValue . 235
6.14.10 Command . 235
6.14.11 Control . 236
6.14.12 ControlType .
...