IEC 61970-301:2013

Energy management system application program interface (EMS-API) - Part 301: Common information model (CIM) base

IEC 61970-301:2013 deals with the common information model (CIM), an abstract model that represents all the major objects in an electric utility enterprise typically involved in utility operations. The object classes represented in the CIM are abstract in nature and may be used in a wide variety of applications. The use of the CIM goes far beyond its application in an EMS. This standard is to be understood as a tool to enable integration in any domain where a common power system model is needed to facilitate interoperability and plug compatibility between applications and systems independent of any particular implementation. Major changes from the third edition include the following:
- extensions have been added to support UCTE exchange;
- the transformer regulation model has been expanded to support phase shifting transformer models needed by ENTSO-E;
- zero and negative sequence impedance terms have been added;
- new StateVariables package has been added;
- additional classes have been added.

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

La CEI 61970-301:2013 traite du modèle d'information commun (CIM), un modèle abstrait qui représente tous les objets principaux d'une entreprise de service public de distribution d'électricité habituellement impliqués dans les opérations de l'entreprise. Les classes d'objets représentées dans le CIM sont de nature abstraite et peuvent être utilisées dans une large gamme d'applications. L'utilisation du CIM n'est pas limitée à son application dans un EMS. Cette norme est destinée à être comprise comme un outil permettant l'intégration dans tout domaine où un modèle commun de réseau est nécessaire pour faciliter l'interopérabilité et la compatibilité de connexion entre des applications et des systèmes indépendants de toute mise en oeuvre particulière. Les principales modifications par rapport à la troisième édition sont les suivantes:
- extensions ajoutées pour prendre en charge l'échange UCTE;
- extension du modèle de régulation des transformateurs afin de prendre en charge les modèles de transformateurs de déphasage dont a besoin l'ENTSO-E;
- ajout des termes "impédance homopolaire" et "impédance inverse" aux endroits où ils étaient absents;
- ajout d'un nouveau paquetage StateVariables afin de prendre en charge l'échange de solutions de modèles de réseau à partir du calcul de répartition, de l'estimation d'état, etc.;
- ajout de classes complémentaires.

General Information

• Status: Published
• Publication Date: 22-May-2013
• ICS: 33.200 - Telecontrol. Telemetering
• Technical Committee: TC 57 - Power systems management and associated information exchange
• Drafting Committee: WG 13 - TC 57/WG 13
• Current Stage: DELPUB - Deleted Publication
• Completion Date: 13-Dec-2013

Relations

• Revises: IEC 61970-301:2011 - Energy management system application program interface (EMS-API) - Part 301: Common information model (CIM) base
• Effective Date: 05-Sep-2023

Standards Content (Sample)

IEC 61970-301
®
Edition 4.0 2013-05
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)
IEC 61970-301:2013

---------------------- Page: 1 ----------------------
THIS PUBLICATION IS COPYRIGHT PROTECTED
Copyright © 2013 IEC, Geneva, Switzerland
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 Tel.: [phone]
3, rue de Varembé Fax: [phone]
CH-1211 Geneva 20 [e-mail]
Switzerland 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.
Useful links:
IEC publications search - www.iec.ch/searchpub Electropedia - www.electropedia.org
The advanced search enables you to find IEC publications The world's leading online dictionary of electronic and
by a variety of criteria (reference number, text, technical electrical terms containing more than 30 000 terms and
committee,…). definitions in English and French, with equivalent terms in
It also gives information on projects, replaced and additional languages. Also known as the International
withdrawn publications. Electrotechnical Vocabulary (IEV) on-line.
IEC Just Published - webstore.iec.ch/justpublished Customer Service Centre - webstore.iec.ch/csc
Stay up to date on all new IEC publications. Just Published If you wish to give us your feedback on this publication
details all new publications released. Available on-line and or need further assistance, please contact the
also once a month by email. Customer Service Centre: [e-mail].
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é.
Liens utiles:
Recherche de publications CEI - www.iec.ch/searchpub Electropedia - www.electropedia.org
La recherche avancée vous permet de trouver des Le premier dictionnaire en ligne au monde de termes
publications CEI en utilisant différents critères (numéro de électroniques et électriques. Il contient plus de 30 000
référence, texte, comité d’études,…). termes et définitions en anglais et en français, ainsi que
Elle donne aussi des informations sur les projets et les les termes équivalents dans les langues additionnelles.
publications remplacées ou retirées. Egalement appelé Vocabulaire Electrotechnique
International (VEI) en ligne.
Just Published CEI - webstore.iec.ch/justpublished
Service Clients - webstore.iec.ch/csc
Restez informé sur les nouvelles publications de la CEI.
Just Published détaille les nouvelles publications parues. Si vous désirez nous donner des commentaires sur
Disponible en ligne et aussi une fois par mois par email. cette publication ou si vous avez des questions
contactez-nous:[e-mail].

---------------------- Page: 2 ----------------------
IEC 61970-301
®
Edition 4.0 2013-05
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-83220-813-7
Warning! Make sure that you obtained this publication from an authorized distributor.
Attention! Veuillez vous assurer que vous avez obtenu cette publication via un distributeur agréé.
® Registered trademark of the International Electrotechnical Commission
Marque déposée de la Commission Electrotechnique Internationale

---------------------- Page: 3 ----------------------
– 2 – 61970-301 © IEC:2013
CONTENTS
FOREW ORD . 18
INTRODUCTION . 20
1 Scope . 22
2 Normative references . 22
3 Terms and definitions . 23
4 CIM specification . 23
4.1 CIM modeling notation . 23
4.2 CIM packages . 23
4.3 CIM classes and relationships . 25
4.3.1 Classes . 25
4.3.2 Generalization . 26
4.3.3 Simple association . 27
4.3.4 Aggregation . 28
4.4 CIM model concepts and examples . 28
4.4.1 Concepts . 28
4.4.2 Containment, equipment hierarchies and naming . 28
4.4.3 Connectivity model . 31
4.4.4 Inheritance hierarchy . 34
4.4.5 Transformer model . 36
4.4.6 Regulating transformer modeling . 37
4.4.7 Measurements and controls . 40
4.4.8 Regulating control models . 44
4.5 Modeling guidelines. 44
4.5.1 Modeling for change . 44
4.5.2 Process for amendments to the CIM . 45
4.5.3 Changes to the CIM UML model . 45
4.5.4 Changes to the CIM standards documents . 45
4.5.5 CIM profiles . 45
4.6 Modeling tools . 46
4.7 User implementation conventions . 46
4.8 CIM modeling examples . 46
5 Detailed model . 47
5.1 Ov erv iew . 47
5.2 Context . 47
6 Package architecture . 49
6.1 Top package IEC61970 . 49
6.1.1 General . 49
6.1.2 IEC61970CIMVersion root class . 49
6.1.3 Package Domain . 50
6.1.4 Package Core . 69
6.1.5 Package OperationalLimits . 96
6.1.6 Package Topology . 103
6.1.7 Package Wires . 110
6.1.8 Package Generation . 174
6.1.9 Package LoadModel . 238
6.1.10 Package Outage . 251

---------------------- Page: 4 ----------------------
61970-301 © IEC:2013 – 3 –
6.1.11 Package Protection . 256
6.1.12 Package Equivalents . 262
6.1.13 Package Meas . 267
6.1.14 Package SCADA . 291
6.1.15 Package ControlArea . 296
6.1.16 Package Contingency . 302
6.1.17 Package StateVariables . 305
Bibliography . 310
Figure 1 – CIM IEC 61970-301 package diagram . 25
Figure 2 – Example of generalization . 27
Figure 3 – Example of simple association . 28
Figure 4 – Example of aggregation . 28
Figure 5 – Equipment containers . 30
Figure 6 – Connectivity model . 31
Figure 7 – Simple network example . 33
Figure 8 – Simple network connectivity modeled with CIM Topology . 33
Figure 9 – Equipment inheritance hierarchy. 35
Figure 10 – Transformer model . 37
Figure 11 – Symmetrical Phase Shifter . 38
Figure 12 – Asymmetrical Phase Shifter. 39
Figure 13 – Navigating from PSR to MeasurementValue . 41
Figure 14 – Measurement placement . 43
Figure 15 – Regulating control models . 44
Figure 16 – CIM top level packages . 47
Figure 17 – Logical diagram IEC61970::Main . 49
Figure 18 – Logical diagram Domain::CombinedDatatypes . 50
Figure 19 – Logical diagram Domain::BasicDatatypes . 51
Figure 20 – Logical diagram Domain::ElectricityDatatypes . 51
Figure 21 – Logical diagram Domain::EnumeratedUnitDatatypes . 52
Figure 22 – Logical diagram Domain::GeneralDatatypes . 53
Figure 23 – Logical diagram Domain::MonetaryDatatypes . 54
Figure 24 – Logical diagram Domain::TimeDatatypes . 54
Figure 25 – Logical diagram Core::Reporting . 69
Figure 26 – Logical diagram Core::Main . 70
Figure 27 – Logical diagram Core::CurveSchedule . 71
Figure 28 – Logical diagram Core::Datatypes . 71
Figure 29 – Logical diagram Core::DocumentationExampleAggregation . 72
Figure 30 – Logical diagram Core::DocumentationExampleAssociation . 72
Figure 31 – Logical diagram Core::Ownership . 73
Figure 32 – Logical diagram OperationalLimits::OperationalLimits . 96
Figure 33 – Logical diagram OperationalLimits::BranchGroup . 97
Figure 34 – Logical diagram Topology::TopologicalNodeTerminal . 104
Figure 35 – Logical diagram Topology::Topology . 105

---------------------- Page: 5 ----------------------
– 4 – 61970-301 © IEC:2013
Figure 36 – Logical diagram Topology::TopologyMeasRelations . 106
Figure 37 – Logical diagram Topology::TopologyReporting . 107
Figure 38 – Logical diagram Topology::Main . 108
Figure 39 – Logical diagram Wires::DocumentationExampleInheritance . 111
Figure 40 – Logical diagram Wires::MutualCoupling . 112
Figure 41 – Logical diagram Wires::Schedules . 113
Figure 42 – Logical diagram Wires::Datatypes . 114
Figure 43 – Logical diagram Wires::InheritanceHierarchy. 115
Figure 44 – Logical diagram Wires::LineModel. 116
Figure 45 – Logical diagram Wires::NamingHierarchyPart1 . 117
Figure 46 – Logical diagram Wires::NamingHierarchyPart2 . 118
Figure 47 – Logical diagram Wires::RegulatingEquipment . 119
Figure 48 – Logical diagram Wires::TransformerModel . 120
Figure 49 – Logical diagram Wires::VoltageControl . 121
Figure 50 – Logical diagram Generation::Main . 175
Figure 51 – Logical diagram GenerationDynamics::Main . 175
Figure 52 – Logical diagram GenerationDynamics::Datatypes . 176
Figure 53 – Logical diagram Production::Nuclear . 192
Figure 54 – Logical diagram Production::Main . 193
Figure 55 – Logical diagram Production::Datatypes . 194
Figure 56 – Logical diagram Production::Hydro . 195
Figure 57 – Logical diagram Production::Thermal . 196
Figure 58 – Logical diagram LoadModel::Main . 238
Figure 59 – Logical diagram LoadModel::Datatypes . 239
Figure 60 – Logical diagram Outage::Datatypes . 251
Figure 61 – Logical diagram Outage::Main . 252
Figure 62 – Logical diagram Protection::Main . 256
Figure 63 – Logical diagram Equivalents::Main . 262
Figure 64 – Logical diagram Meas::Datatypes . 268
Figure 65 – Logical diagram Meas::Meas . 268
Figure 66 – Logical diagram Meas::Control . 269
Figure 67 – Logical diagram Meas::InheritanceStructure . 270
Figure 68 – Logical diagram Meas::Measurement with limits . 271
Figure 69 – Logical diagram Meas::Quality . 272
Figure 70 – Logical diagram SCADA::Datatypes . 292
Figure 71 – Logical diagram SCADA::Main . 292
Figure 72 – Logical diagram ControlArea::ControlArea . 297
Figure 73 – Logical diagram ControlArea::ControlAreaInheritance . 298
Figure 74 – Logical diagram ControlArea::Datatypes . 298
Figure 75 – Logical diagram Contingency::Contingency . 302
Figure 76 – Logical diagram StateVariables::StateVariables . 305
Table 1 – MeasurementType naming conventions . 42

---------------------- Page: 6 ----------------------
61970-301 © IEC:2013 – 5 –
Table 2 – MeasurementValueSource naming conventions . 43
Table 3 – Attributes . 47
Table 4 – Association ends . 48
Table 5 – Enums . 48
Table 6 – Attributes of IEC61970::IEC61970CIMVersion . 50
Table 7 – Attributes of Domain::AbsoluteDate. 54
Table 8 – Attributes of Domain::AbsoluteDateTime . 55
Table 9 – Attributes of Domain::ActivePower . 55
Table 10 – Attributes of Domain::ActivePowerChangeRate . 55
Table 11 – Attributes of Domain::Admittance . 56
Table 12 – Attributes of Domain::AngleDegrees . 56
Table 13 – Attributes of Domain::AngleRadians . 56
Table 14 – Attributes of Domain::ApparentPower . 56
Table 15 – Attributes of Domain::Capacitance . 57
Table 16 – Attributes of Domain::Conductance . 57
Table 17 – Attributes of Domain::CostPerEnergyUnit. 57
Table 18 – Attributes of Domain::CostRate . 58
Table 19 – Literals of Domain::Currency . 58
Table 20 – Attributes of Domain::CurrentFlow. 58
Table 21 – Attributes of Domain::Damping . 59
Table 22 – Attributes of Domain::FloatQuantity . 59
Table 23 – Attributes of Domain::Frequency . 59
Table 24 – Attributes of Domain::Hours. 60
Table 25 – Attributes of Domain::Impedance . 60
Table 26 – Attributes of Domain::Inductance . 60
Table 27 – Attributes of Domain::IntegerQuantity . 60
Table 28 – Attributes of Domain::KWActivePower . 61
Table 29 – Attributes of Domain::Length . 61
Table 30 – Attributes of Domain::Minutes . 61
Table 31 – Literals of Domain::MonetaryAmountPerEnergyUnit . 62
Table 32 – Literals of Domain::MonetaryAmountPerHeatUnit . 62
Table 33 – Literals of Domain::MonetaryAmountRate . 62
Table 34 – Attributes of Domain::Money. 62
Table 35 – Attributes of Domain::PerCent . 63
Table 36 – Attributes of Domain::Pressure . 63
Table 37 – Attributes of Domain::PU . 63
Table 38 – Attributes of Domain::Reactance . 63
Table 39 – Attributes of Domain::ReactivePower . 64
Table 40 – Attributes of Domain::RealEnergy . 64
Table 41 – Attributes of Domain::Resistance . 64
Table 42 – Attributes of Domain::RotationSpeed . 65
Table 43 – Attributes of Domain::Seconds . 65
Table 44 – Attributes of Domain::StringQuantity. 65

---------------------- Page: 7 ----------------------
– 6 – 61970-301 © IEC:2013
Table 45 – Attributes of Domain::Susceptance. 66
Table 46 – Attributes of Domain::Temperature . 66
Table 47 – Literals of Domain::UnitMultiplier . 66
Table 48 – Literals of Domain::UnitSymbol . 67
Table 49 – Attributes of Domain::Voltage . 68
Table 50 – Attributes of Domain::VoltagePerReactivePower. 68
Table 51 – Attributes of Domain::Volume . 68
Table 52 – Attributes of Domain::WaterLevel . 68
Table 53 – Attributes of Domain::Weight . 69
Table 54 – Attributes of Core::ReportingGroup . 73
Table 55 – Association ends of Core::ReportingGroup with other classes . 74
Table 56 – Attributes of Core::ReportingSuperGroup . 74
Table 57 – Association ends of Core::ReportingSuperGroup with other classes . 74
Table 58 – Attributes of Core::BasePower . 74
Table 59 – Attributes of Core::BaseVoltage . 75
Table 60 – Association ends of Core::BaseVoltage with other classes. 75
Table 61 – Attributes of Core::BasicIntervalSchedule . 76
Table 62 – Attributes of Core::Bay . 76
Table 63 – Association ends of Core::Bay with other classes . 77
Table 64 – Literals of Core::BreakerConfiguration . 77
Table 65 – Literals of Core::BusbarConfiguration . 77
Table 66 – Literals of Core::CompanyType . 78
Table 67 – Attributes of Core::ConductingEquipment. 78
Table 68 – Association ends of Core::ConductingEquipment with other classes . 78
Table 69 – Attributes of Core::ConnectivityNode . 79
Table 70 – Association ends of Core::ConnectivityNode with other classes . 79
Table 71 – Attributes of Core::ConnectivityNodeContainer . 80
Table 72 – Association ends of Core::ConnectivityNodeContainer with other classes. 80
Table 73 – Attributes of Core::Curve. 80
Table 74 – Association ends of Core::Curve with other classes . 81
Table 75 – Attributes of Core::CurveData . 81
Table 76 – Association ends of Core::CurveData with other classes . 81
Table 77 – Literals of Core::CurveStyle. 82
Table 78 – Attributes of Core::Equipment . 82
Table 79 – Association ends of Core::Equipment with other classes . 82
Table 80 – Attributes of Core::EquipmentContainer . 83
Table 81 – Association ends of Core::EquipmentContainer with other classes . 83
Table 82 – Attributes of Core::GeographicalRegion . 84
Table 83 – Association ends of Core::GeographicalRegion with other classes . 84
Table 84 – Attributes of Core::IdentifiedObject . 84
Table 85 – Attributes of Core::IrregularIntervalSchedule . 85
Table 86 – Association ends of Core::IrregularIntervalSchedule with other classes . 85
Table 87 – Attributes of Core::IrregularTimePoint .
...