IEC 61970-301:2016

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

IEC 61970-301:2016 lays down the common information model (CIM), which is an abstract model that represents all the major objects in an electric utility enterprise typically involved in utility operations. By providing a standard way of representing power system resources as object classes and attributes, along with their relationships, the CIM facilitates the integration of network applications developed independently by different vendors, between entire systems running network applications developed independently, or between a system running network applications and other systems concerned with different aspects of power system operations, such as generation or distribution management. SCADA is modeled to the extent necessary to support power system simulation and inter-control centre communication. The CIM facilitates integration by defining a common language (i.e. semantics) based on the CIM to enable these applications or systems to access public data and exchange information independent of how such information is represented internally. This new edition includes the following significant technical changes with respect to the previous edition:
- new model for grounding including Petersen coils;
- models for HVDC; addition of Static Var Compensation models;
- phase shift transformer updates;
- short circuit calculations based on IEC 60909;
- addition of non-linear shunt compensator;
- addition of model for steady state calculation inputs, Steady State Hypothesis;
- addition of base frequency model;
- Annex A with custom extensions 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)

L'IEC 61970-301:2016 définit le modèle d'information commun (CIM – common information model) est un modèle abstrait qui représente tous les objets principaux d'une entreprise de service public d'électricité habituellement nécessaires aux opérations d'une entreprise de service public d'électricité. La représentation normalisée des ressources de systèmes de puissance comme classes et attributs d'objets ainsi que leurs relations que fournit le CIM facilite l'intégration des applications réseau développées de façon indépendante par différents fournisseurs, entre des systèmes complets exploitant des applications réseau développés de façon indépendante ou entre un système exploitant des applications réseau et d'autres systèmes concernés par différents aspects des opérations d'un système de puissance tels que la gestion de la production ou de la distribution. Le système SCADA (système de supervision, contrôle et acquisition de données – supervisory control and data acquisition) est modélisé dans toute la mesure nécessaire pour prendre en charge la simulation des systèmes de puissance et la communication entre des centres de conduite. Le CIM facilite l'intégration en définissant un langage commun (c'est-à-dire une sémantique) fondé sur le modèle CIM pour permettre à ces applications ou systèmes d'accéder aux données publiques et d'échanger des informations indépendamment de la représentation interne de ces informations. Cette nouvelle édition inclut les modifications techniques majeures suivantes par rapport à l'édition précédente:
- un nouveau modèle de mise à la terre, y compris les bobines Petersen;
- des modèles de courant continu à haute tension (CCHT);
- l'ajout de modèles de compensation de var statique;
- des mises à jour concernant les transformateurs déphaseurs;
- la section a été ajoutée; des calculs de courts-circuits issus de l'IEC 60909;
- l'ajout d'un compensateur shunt non linéaire;
- l'ajout d'un modèle pour les données d'entrée des calculs du régime établi, Steady State Hypothesis (hypothèse en régime établi);
- l'ajout d'un modèle de fréquence de base;
- ajout d'une Annexe A comprenant l'ajout d'extensions personnalisées.

General Information

• Status: Published
• Publication Date: 15-Dec-2016
• ICS: 01 - GENERALITIES. TERMINOLOGY. STANDARDIZATION. DOCUMENTATION
• ICS: 29.060.10 - Wires
• 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
• Start Date: 31-Jul-2018
• Completion Date: 26-Jun-2020

Relations

• Revised: IEC 61970-301:2020 - Energy management system application program interface (EMS-API) - Part 301: Common information model (CIM) base
• Effective Date: 05-Sep-2023
• Revises: IEC 61970-301:2013 - 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 6.0 2016-12
REDLINE VERSION
INTERNATIONAL
STANDARD
colour
inside
Energy management system application program interface (EMS-API) –
Part 301: Common information model (CIM) base

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.

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.

IEC Catalogue - webstore.iec.ch/catalogue Electropedia - www.electropedia.org
The stand-alone application for consulting the entire The world's leading online dictionary of electronic and
bibliographical information on IEC International Standards, electrical terms containing 20 000 terms and definitions in
Technical Specifications, Technical Reports and other English and French, with equivalent terms in 15 additional
documents. Available for PC, Mac OS, Android Tablets and languages. Also known as the International Electrotechnical
iPad. Vocabulary (IEV) online.

IEC publications search - www.iec.ch/searchpub IEC Glossary - std.iec.ch/glossary
The advanced search enables to find IEC publications by a 65 000 electrotechnical terminology entries in English and
variety of criteria (reference number, text, technical French extracted from the Terms and Definitions clause of
committee,…). It also gives information on projects, replaced IEC publications issued since 2002. Some entries have been
and withdrawn publications. collected from earlier publications of IEC TC 37, 77, 86 and

CISPR.
IEC Just Published - webstore.iec.ch/justpublished
Stay up to date on all new IEC publications. Just Published IEC Customer Service Centre - webstore.iec.ch/csc
details all new publications released. Available online and If you wish to give us your feedback on this publication or
also once a month by email. need further assistance, please contact the Customer Service
Centre: [e-mail].
IEC 61970-301 ®
Edition 6.0 2016-12
REDLINE VERSION
INTERNATIONAL
STANDARD
colour
inside
Energy management system application program interface (EMS-API) –

Part 301: Common information model (CIM) base

INTERNATIONAL
ELECTROTECHNICAL
COMMISSION
ICS 33.200 ISBN 978-2-8322-3763-2

– 2 – IEC 61970-301:2016 RLV © IEC 2016

CONTENTS
FOREWORD . 33

INTRODUCTION . 35

1 Scope . 37

2 Normative references . 37

3 Terms and definitions . 38

4 CIM specification . 39

4.1 Overview. 39
4.2 CIM modeling notation . 39
4.3 CIM packages . 39
4.4 CIM classes and relationships . 41
4.4.1 Classes . 41
4.4.2 Generalization . 42
4.4.3 Simple association . 43
4.4.4 Aggregation . 44
4.5 CIM model concepts and examples . 44
4.5.1 Concepts . 44
4.5.2 Containment, equipment hierarchies and naming . 45
4.5.3 Names model . 46
4.5.4 Connectivity model . 47
4.5.5 Inheritance hierarchy . 50
4.5.6 Transformer model . 52
4.5.7 Transformer tap modeling . 54
4.5.8 Phase wire modeling . 69
4.5.9 Grounding devices modeling . 71
4.5.10 Cuts, clamps and jumpers model . 74
4.5.11 Measurements and controls . 78
4.5.12 Regulating control models . 83
4.5.13 DC model for CIM . 84
4.5.14 Static Var Compensator voltage regulation . 103
4.6 Modeling guidelines . 105
4.6.1 Modeling for change . 105
4.6.2 Process for amendments to the CIM . 105

4.6.3 Changes to the CIM UML model . 105
4.6.4 Changes to the CIM standards documents . 106
4.6.5 Deprecations . 106
4.6.6 CIM profiles . 106
4.7 Modeling tools . 106
4.8 User implementation conventions . 107
4.8.1 Conventions beyond UML . 107
4.8.2 Number of terminals for ConductingEquipment objects . 107
4.9 CIM modeling examples . 107
5 Detailed model . 108
5.1 Overview. 108
5.2 Context . 108
6 Top package IEC61970 Package Base . 111
6.1 General . 111

6.2 IEC61970CIMVersion root class .

6.2 Package Faults . 112

6.2.1 General . 112

6.2.2 EquipmentFault . 112

6.2.3 Fault . 113

6.2.4 FaultCauseType . 114

6.2.5 FaultImpedance compound . 114

6.2.6 LineFault . 115

6.2.7 PhaseConnectedFaultKind enumeration . 115

6.3 Package DocIEC 61970 . 116

6.4 Package Domain . 117
6.4.1 General . 117
6.4.2 ActivePower datatype . 123
6.4.3 ActivePowerChangeRate datatype . 123
6.4.4 ActivePowerPerCurrentFlow datatype . 124
6.4.5 ActivePowerPerFrequency datatype . 124
6.4.6 Admittance datatype . 124
6.4.7 AngleDegrees datatype . 125
6.4.8 AngleRadians datatype . 125
6.4.9 ApparentPower datatype. 125
6.4.10 Area datatype . 125
6.4.11 Boolean primitive . 126
6.4.12 Capacitance datatype . 126
6.4.13 CapacitancePerLength datatype . 126
6.4.14 Conductance datatype . 126
6.4.15 ConductancePerLength datatype . 126
6.4.16 CostPerEnergyUnit datatype . 127
6.4.17 CostPerVolume datatype . 127
6.4.18 CostRate datatype . 127
6.4.19 Currency enumeration . 128
6.4.20 CurrentFlow datatype . 128
6.4.21 Damping datatype . 128
6.4.22 Date primitive . 129
6.4.23 DateInterval compound . 129
6.4.24 DateTime primitive . 129

6.4.25 DateTimeInterval compound . 129
6.4.26 Decimal primitive . 129
6.4.27 PsrList .
6.4.27 DecimalQuantity compound . 129
6.4.28 Displacement datatype . 130
6.4.29 Duration primitive . 130
6.4.30 Float primitive . 130
6.4.31 ReportingGroup .
6.4.31 FloatQuantity datatype compound . 130
6.4.32 Frequency datatype . 130
6.4.33 Hours datatype . 131
6.4.34 Impedance datatype . 131
6.4.35 In
...

IEC 61970-301 ®
Edition 6.0 2016-12
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 l'IEC ou du Comité national de l'IEC du pays du demandeur. Si vous avez des
questions sur le copyright de l'IEC 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 l'IEC 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.

IEC Catalogue - webstore.iec.ch/catalogue Electropedia - www.electropedia.org
The stand-alone application for consulting the entire The world's leading online dictionary of electronic and
bibliographical information on IEC International Standards, electrical terms containing 20 000 terms and definitions in
Technical Specifications, Technical Reports and other English and French, with equivalent terms in 15 additional
documents. Available for PC, Mac OS, Android Tablets and languages. Also known as the International Electrotechnical
iPad. Vocabulary (IEV) online.

IEC publications search - www.iec.ch/searchpub IEC Glossary - std.iec.ch/glossary
The advanced search enables to find IEC publications by a 65 000 electrotechnical terminology entries in English and
variety of criteria (reference number, text, technical French extracted from the Terms and Definitions clause of
committee,…). It also gives information on projects, replaced IEC publications issued since 2002. Some entries have been
and withdrawn publications. collected from earlier publications of IEC TC 37, 77, 86 and

CISPR.
IEC Just Published - webstore.iec.ch/justpublished
Stay up to date on all new IEC publications. Just Published IEC Customer Service Centre - webstore.iec.ch/csc
details all new publications released. Available online and If you wish to give us your feedback on this publication or
also once a month by email. need further assistance, please contact the Customer Service
Centre: [e-mail].
A propos de l'IEC
La Commission Electrotechnique Internationale (IEC) 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 IEC
Le contenu technique des publications IEC 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 IEC - webstore.iec.ch/catalogue Electropedia - www.electropedia.org
Application autonome pour consulter tous les renseignements
Le premier dictionnaire en ligne de termes électroniques et
bibliographiques sur les Normes internationales,
électriques. Il contient 20 000 termes et définitions en anglais
Spécifications techniques, Rapports techniques et autres
et en français, ainsi que les termes équivalents dans 15
documents de l'IEC. Disponible pour PC, Mac OS, tablettes
langues additionnelles. Egalement appelé Vocabulaire
Android et iPad.
Electrotechnique International (IEV) en ligne.

Recherche de publications IEC - www.iec.ch/searchpub
Glossaire IEC - std.iec.ch/glossary
65 000 entrées terminologiques électrotechniques, en anglais
La recherche avancée permet de trouver des publications IEC
en utilisant différents critères (numéro de référence, texte, et en français, extraites des articles Termes et Définitions des
comité d’études,…). Elle donne aussi des informations sur les publications IEC parues depuis 2002. Plus certaines entrées
projets et les publications remplacées ou retirées. antérieures extraites des publications des CE 37, 77, 86 et

CISPR de l'IEC.
IEC Just Published - webstore.iec.ch/justpublished

Service Clients - webstore.iec.ch/csc
Restez informé sur les nouvelles publications IEC. Just
Published détaille les nouvelles publications parues. Si vous désirez nous donner des commentaires sur cette
Disponible en ligne et aussi une fois par mois par email. publication ou si vous avez des questions contactez-nous:
[e-mail].
IEC 61970-301 ®
Edition 6.0 2016-12
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
INTERNATIONALE
ICS 33.200 ISBN 978-2-8322-3787-8

– 2 – IEC 61970-301:2016  IEC 2016
CONTENTS
FOREWORD . 32
INTRODUCTION . 34
1 Scope . 36
2 Normative references . 36
3 Terms and definitions . 37
4 CIM specification . 37
4.1 Overview. 37
4.2 CIM modeling notation . 38
4.3 CIM packages . 38
4.4 CIM classes and relationships . 40
4.4.1 Classes . 40
4.4.2 Generalization . 41
4.4.3 Simple association . 42
4.4.4 Aggregation . 43
4.5 CIM model concepts and examples . 43
4.5.1 Concepts . 43
4.5.2 Containment, equipment hierarchies and naming . 44
4.5.3 Names model . 45
4.5.4 Connectivity model . 46
4.5.5 Inheritance hierarchy . 49
4.5.6 Transformer model . 51
4.5.7 Transformer tap modeling . 53
4.5.8 Phase wire modeling . 66
4.5.9 Grounding devices modeling . 68
4.5.10 Cuts, clamps and jumpers model . 71
4.5.11 Measurements and controls . 75
4.5.12 Regulating control models . 80
4.5.13 DC model for CIM . 81
4.5.14 Static Var Compensator voltage regulation . 100
4.6 Modeling guidelines . 102
4.6.1 Modeling for change . 102
4.6.2 Process for amendments to the CIM . 102
4.6.3 Changes to the CIM UML model . 102
4.6.4 Changes to the CIM standards documents . 103
4.6.5 Deprecations . 103
4.6.6 CIM profiles . 103
4.7 Modeling tools . 103
4.8 User implementation conventions . 104
4.8.1 Conventions beyond UML . 104
4.8.2 Number of terminals for ConductingEquipment objects . 104
4.9 CIM modeling examples . 104
5 Detailed model . 105
5.1 Overview. 105
5.2 Context . 105
6 Package Base . 107
6.1 General . 107

6.2 Package Faults . 107
6.2.1 General . 107
6.2.2 EquipmentFault . 107
6.2.3 Fault . 108
6.2.4 FaultCauseType . 109
6.2.5 FaultImpedance compound . 109
6.2.6 LineFault . 109
6.2.7 PhaseConnectedFaultKind enumeration . 110
6.3 Package DocIEC 61970 . 111
6.4 Package Domain . 112
6.4.1 General . 112
6.4.2 ActivePower datatype . 118
6.4.3 ActivePowerChangeRate datatype . 118
6.4.4 ActivePowerPerCurrentFlow datatype . 119
6.4.5 ActivePowerPerFrequency datatype . 119
6.4.6 Admittance datatype . 119
6.4.7 AngleDegrees datatype . 120
6.4.8 AngleRadians datatype . 120
6.4.9 ApparentPower datatype. 120
6.4.10 Area datatype . 120
6.4.11 Boolean primitive . 121
6.4.12 Capacitance datatype .
...