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

Defines the Common Information Model Base set of packages which provide a logical view of the physical aspects of Energy Management System information. Is part of the EN 61970 series, which defines an Application Program Interface (API) for an Energy Management System (EMS).

Anwendungsprogramm-Schnittstelle für Netzführungssysteme (EMS-API) -- Teil 301: Allgemeines Informationsmodell (CIM), Basismodell

Système de gestion d'énergie - Interface de programmation d'application (EMS-API) -- Partie 301: Base de Modèle d'Information Commun (CIM)

Defines the Common Information Model Base set of packages which provide a logical view of the physical aspects of Energy Management System information. Is part of the EN 61970 series, which defines an Application Program Interface (API) for an Energy Management System (EMS).

Energy management system application program interface (EMS-API) - Part 301: Common Information Model (CIM) Base (IEC 61970-301:2003)

General Information

Status
Withdrawn
Publication Date
30-Apr-2004
Withdrawal Date
23-Nov-2014
Technical Committee
Current Stage
9900 - Withdrawal (Adopted Project)
Start Date
20-Nov-2014
Due Date
13-Dec-2014
Completion Date
24-Nov-2014

Relations

Buy Standard

Standard
EN 61970-301:2004
English language
188 pages
sale 10% off
Preview
sale 10% off
Preview
e-Library read for
1 day

Standards Content (Sample)

SLOVENSKI STANDARD
SIST EN 61970-301:2004
01-maj-2004
Energy management system application program interface (EMS-API) - Part 301:
Common Information Model (CIM) Base (IEC 61970-301:2003)
Energy management system application program interface (EMS-API) -- Part 301:
Common Information Model (CIM) base
Anwendungsprogramm-Schnittstelle für Netzführungssysteme (EMS-API) -- Teil 301:
Allgemeines Informationsmodell (CIM), Basismodell
Système de gestion d'énergie - Interface de programmation d'application (EMS-API) --
Partie 301: Base de Modèle d'Information Commun (CIM)
Ta slovenski standard je istoveten z: EN 61970-301:2004
ICS:
29.240.30 Krmilna oprema za Control equipment for electric
elektroenergetske sisteme power systems
35.200 Vmesniška in povezovalna Interface and interconnection
oprema equipment
SIST EN 61970-301:2004 en
2003-01.Slovenski inštitut za standardizacijo. Razmnoževanje celote ali delov tega standarda ni dovoljeno.

---------------------- Page: 1 ----------------------

SIST EN 61970-301:2004

---------------------- Page: 2 ----------------------

SIST EN 61970-301:2004
EUROPEAN STANDARD EN 61970-301
NORME EUROPÉENNE
EUROPÄISCHE NORM March 2004

ICS 33.200


English version


Energy management system application program interface (EMS-API)
Part 301: Common Information Model (CIM) Base
(IEC 61970-301:2003)


Système de gestion d'énergie –  Anwendungsprogramm-Schnittstelle für
Interface de programmation d'application Netzführungssysteme (EMS-API)
(EMS-API) Teil 301: Allgemeines Informationsmodell
Partie 301: Base de Modèle d'Information (CIM), Basismodell
Commun (CIM) (IEC 61970-301:2003)
(CEI 61970-301:2003)






This European Standard was approved by CENELEC on 2004-02-01. CENELEC members are bound to
comply with the CEN/CENELEC Internal Regulations which stipulate the conditions for giving this European
Standard the status of a national standard without any alteration.

Up-to-date lists and bibliographical references concerning such national standards may be obtained on
application to the Central Secretariat or to any CENELEC member.

This European Standard exists in three official versions (English, French, German). A version in any other
language made by translation under the responsibility of a CENELEC member into its own language and
notified to the Central Secretariat has the same status as the official versions.

CENELEC members are the national electrotechnical committees of Austria, Belgium, Cyprus, Czech
Republic, Denmark, Estonia, Finland, France, Germany, Greece, Hungary, Iceland, Ireland, Italy, Latvia,
Lithuania, Luxembourg, Malta, Netherlands, Norway, Poland, Portugal, Slovakia, Slovenia, Spain, Sweden,
Switzerland and United Kingdom.


CENELEC
European Committee for Electrotechnical Standardization
Comité Européen de Normalisation Electrotechnique
Europäisches Komitee für Elektrotechnische Normung

Central Secretariat: rue de Stassart 35, B - 1050 Brussels


© 2004 CENELEC - All rights of exploitation in any form and by any means reserved worldwide for CENELEC members.

Ref. No. EN 61970-301:2004 E

---------------------- Page: 3 ----------------------

SIST EN 61970-301:2004
EN 61970-301:2004 - 2 -
Foreword
The text of document 57/656/FDIS, future edition 1 of IEC 61970-301, prepared by IEC TC 57, Power
systems management and associated information exchange, was submitted to the IEC-CENELEC
parallel vote and was approved by CENELEC as EN 61970-301 on 2004-02-01.
The following dates were fixed:
– latest date by which the EN has to be implemented
at national level by publication of an identical
national standard or by endorsement (dop) 2004-11-01
– latest date by which the national standards conflicting
with the EN have to be withdrawn (dow) 2007-02-01
The International Electrotechnical Commission (IEC) and CENELEC draw attention to the fact that it is
claimed that compliance with this document may involve the use of a patent concerning a computer-
based implementation of an object-oriented power system model in a relational database. As such, it
does not conflict with the development of any logical power system model including the Common
Information Model (CIM), where implementation of the model is not defined.
The IEC and CENELEC take no position concerning the evidence, validity and scope of this patent
right.
The holder of this patent right, ICL, has assured the IEC that they are willing to grant a royalty free
license to any entity implementing this standard. This license is issued by default, and vendors wishing
to take up the license are not required to notify ICL. The statement of the holder of this patent right is
registered with the IEC. Information may be obtained from:
ICL
Wenlock WAY
West Gorton
Manchester
M12 5DR
United Kingdom
Attention is drawn to the possibility that some of the elements of this document may be the subject of
patent rights other than those identified above. IEC and CENELEC shall not be held responsible for
identifying any or all such patent rights.
Annex ZA has been added by CENELEC.
__________
Endorsement notice
The text of the International Standard IEC 61970-301:2003 was approved by CENELEC as a
European Standard without any modification.
__________

---------------------- Page: 4 ----------------------

SIST EN 61970-301:2004
- 3 - EN 61970-301:2004
Annex ZA
(normative)

Normative references to international publications
with their corresponding European publications
The following referenced documents are indispensable for the application of this document. For dated
references, only the edition cited applies. For undated references, the latest edition of the referenced
document (including any amendments) applies.
NOTE When an international publication has been modified by common modifications, indicated by (mod), the relevant
EN/HD applies.
Publication Year Title EN/HD Year
IEC 61850 Series Communication networks and systems EN 61850 Series
in substations

ISO 8601 1988 Data elements and interchange formats EN 28601 1992
- Information interchange -
Representation of dates and times

---------------------- Page: 5 ----------------------

SIST EN 61970-301:2004

---------------------- Page: 6 ----------------------

SIST EN 61970-301:2004
NORME CEI

INTERNATIONALE IEC



61970-301
INTERNATIONAL


Première édition
STANDARD

First edition

2003-11


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

Energy management system application
program interface (EMS-API) –
Part 301:
Common Information Model (CIM) base

 IEC 2005 Droits de reproduction réservés  Copyright - all rights reserved
Aucune partie de cette publication ne peut être reproduite ni No part of this publication may be reproduced or utilized in any
utilisée sous quelque forme que ce soit et par aucun procédé, form or by any means, electronic or mechanical, including
électronique ou mécanique, y compris la photocopie et les photocopying and microfilm, without permission in writing from
microfilms, sans l'accord écrit de l'éditeur. the publisher.
International Electrotechnical Commission, 3, rue de Varembé, PO Box 131, CH-1211 Geneva 20, Switzerland
Telephone: +41 22 919 02 11 Telefax: +41 22 919 03 00 E-mail: inmail@iec.ch Web: www.iec.ch
CODE PRIX
Commission Electrotechnique Internationale PRICE CODE XJ
International Electrotechnical Commission
Международная Электротехническая Комиссия
Pour prix, voir catalogue en vigueur
For price, see current catalogue

---------------------- Page: 7 ----------------------

SIST EN 61970-301:2004
61970-301  IEC:2005 – 3 –
CONTENTS
FOREWORD.7
INTRODUCTION.11

1 Scope.13
2 Normative references.13
3 Terms and definitions .13
4 CIM specification.15
4.1 CIM modeling notation .15
4.2 CIM packages.15
4.3 CIM classes and relationships .21
4.4 CIM model concepts and examples .27
4.5 Modeling tools.41
4.6 Modeling guidelines.41
4.7 User implementation conventions .43
4.8 Examples.51

Annex A (normative) Common information model for control center application
program interface .53
Annex B (informative) CIM notation mapping from entity relationship diagram to class
diagram in UML .365

Bibliography .369

Figure 1 – CIM Part 301 Package Diagram.17
Figure 2 – Example of generalization .25
Figure 3 – Example of Simple Association .25
Figure 4 – Example of Aggregation .27
Figure 5 – Transformer Model .29
Figure 6 – Connectivity Model .31
Figure 7 – Simple Network Example .33
Figure 8 – Simple Network Connectivity Modeled with CIM Topology .35
Figure 9 – Equipment Inheritance Hierarchy .37
Figure 10 – Equipment Containers .39
Figure 11 – Navigating from PSR to MeasurementValue .47
Figure 12 – Measurement placement.51
Figure A.1 – CIM Top Level Packages.53
Figure A.2 – Main .55
Figure A.3 – Main .57
Figure A.4 – Integer Datatypes.81
Figure A.5 – Float Datatypes.83
Figure A.6 – String Datatypes .85
Figure A.7 – Other Datatypes.87

---------------------- Page: 8 ----------------------

SIST EN 61970-301:2004
61970-301  IEC:2005 – 5 –
Figure A.8 – Enumeration Datatypes .89
Figure A.9 – Main .129
Figure A.10 – Main .131
Figure A.11 – Hydro.133
Figure A.12 – Thermal .135
Figure A.13 – Main .205
Figure A.14 – Main .233
Figure A.15 – Main .253
Figure A.16 – Measurements .255
Figure A.17 – Quality .257
Figure A.18 – Main .275
Figure A.19 – Main .281
Figure A.20 – Main .287
Figure A.21 – Transformer Model .293
Figure A.22 – EquipmentContainment .295
Figure A.23 – InheritanceHierarchy .297
Figure A.24 – LineModel .299
Figure A.25 – RegulatingEquipment .301
Figure A.26 – VoltageControl .303

Table 1 – MeasurementType Naming Conventions .47
Table 2 – MeasurementValueSource Naming Conventions.49
Table B.1 – CIM Mapping Conventions.365

---------------------- Page: 9 ----------------------

SIST EN 61970-301:2004
61970-301  IEC:2005 – 7 –
INTERNATIONAL ELECTROTECHNICAL COMMISSION
___________

ENERGY MANAGEMENT SYSTEM APPLICATION
PROGRAM INTERFACE (EMS-API) –

Part 301: Common Information Model (CIM) base


FOREWORD
1) The International Electrotechnical Commission (IEC) is a worldwide organization for standardization comprising
all national electrotechnical committees (IEC National Committees). The object of IEC is to promote
international co-operation on all questions concerning standardization in the electrical and electronic fields. To
this end and in addition to other activities, IEC publishes International Standards, Technical Specifications,
Technical Reports, Publicly Available Specifications (PAS) and Guides (hereafter referred to as “IEC
Publication(s)”). Their preparation is entrusted to technical committees; any IEC National Committee interested
in the subject dealt with may participate in this preparatory work. International, governmental and non-
governmental organizations liaising with the IEC also participate in this preparation. IEC collaborates closely
with the International Organization for Standardization (ISO) in accordance with conditions determined by
agreement between the two organizations.
2) The formal decisions or agreements of IEC on technical matters express, as nearly as possible, an international
consensus of opinion on the relevant subjects since each technical committee has representation from all
interested IEC National Committees.
3) IEC Publications have the form of recommendations for international use and are accepted by IEC National
Committees in that sense. While all reasonable efforts are made to ensure that the technical content of IEC
Publications is accurate, IEC cannot be held responsible for the way in which they are used or for any
misinterpretation by any end user.
4) In order to promote international uniformity, IEC National Committees undertake to apply IEC Publications
transparently to the maximum extent possible in their national and regional publications. Any divergence
between any IEC Publication and the corresponding national or regional publication shall be clearly indicated in
the latter.
5) IEC provides no marking procedure to indicate its approval and cannot be rendered responsible for any
equipment declared to be in conformity with an IEC Publication.
6) All users should ensure that they have the latest edition of this publication.
7) No liability shall attach to IEC or its directors, employees, servants or agents including individual experts and
members of its technical committees and IEC National Committees for any personal injury, property damage or
other damage of any nature whatsoever, whether direct or indirect, or for costs (including legal fees) and
expenses arising out of the publication, use of, or reliance upon, this IEC Publication or any other IEC
Publications.
8) Attention is drawn to the Normative references cited in this publication. Use of the referenced publications is
indispensable for the correct application of this publication.
The International Electrotechnical Commission (IEC) draws attention to the fact that it is claimed that compliance
with this document may involve the use of a patent concerning a computer-based implementation of an object-
oriented power system model in a relational database. As such, it does not conflict with the development of any
logical power system model including the Common Information Model (CIM), where implementation of the model is
not defined.
The IEC takes no position concerning the evidence, validity and scope of this patent right.
The holder of this patent right, ICL, has assured the IEC that they are willing to grant a royalty free license to any
entity implementing this standard. This license is issued by default, and vendors wishing to take up the license are
not required to notify ICL. The statement of the holder of this patent right is registered with IEC. Information may
be obtained from:
ICL
Wenlock Way
West Gorton
Manchester
M12 5DR
United Kingdom (U.K.)
Attention is drawn to the possibility that some of the elements of this document may be the subject of patent rights
other than those identified above. IEC shall not be held responsible for identifying any or all such patent rights.

---------------------- Page: 10 ----------------------

SIST EN 61970-301:2004
61970-301  IEC:2005 – 9 –
International Standard IEC 61970-301 has been prepared by IEC technical committee 57:
Power systems management and associated information exchange.
This bilingual version (2005-03) replaces the English version.
The text of this standard is based on the following documents:
FDIS Report on voting
57/656/FDIS 57/682/RVD

Full information on the voting for the approval of this standard can be found in the report on
voting indicated in the above table.
The French version of this standard has not been voted upon.
This publication has been drafted in accordance with the ISO/IEC Directives, Part 2.
IEC 61970 consists of the following parts, under the general title Energy management system
application program interface (EMS-API):
Part 1: Guidelines and general requirements
Part 2: Glossary
Part 301: Common Information Model (CIM) base
Part 401: Component interface specification framework
The committee has decided that the contents of this publication will remain unchanged until
the maintenance result date indicated on the IEC web site under "http://webstore.iec.ch" in
the data related to the specific publication. At this date, the publication will be
• reconfirmed;
• withdrawn;
• replaced by a revised edition, or
• amended.

---------------------- Page: 11 ----------------------

SIST EN 61970-301:2004
61970-301  IEC:2005 – 11 –
INTRODUCTION
This standard is part of the IEC 61970 series, which defines an Application Program Interface
(API) for an Energy Management System (EMS). This standard is based upon the work of the
EPRI Control Center API (CCAPI) research project (RP-3654-1). The principal objectives of
the EPRI CCAPI project are to:
– reduce the cost and time needed to add new applications to an EMS;
– protect the investment of existing applications or systems that are working effectively with
an EMS.
The principal task of the CCAPI project is to produce requirements and draft text for
standards to facilitate the integration of EMS applications developed independently by
different vendors, between entire EMS systems developed independently, or between an EMS
system and other systems concerned with different aspects of power system operations, such
as generation or Distribution Management Systems (DMS). This is accomplished by defining
application program interfaces to enable these applications or systems access to public data
and exchange information independent of how such information is represented internally. The
Common Information Model (CIM) specifies the semantics for this API. The Component
Interface Specifications (CIS) specify the content of the messages exchanged.
This part of IEC 61970-301 defines the CIM Base set of packages which provide a logical
view of the physical aspects of Energy Management System information. Future IEC 61970-
302 defines the financial and energy scheduling logical view. Future IEC 61970-303 defines
the SCADA logical view. The CIM is an abstract model that represents all the major objects in
an electric utility enterprise typically needed to model the operational aspects of a utility. This
model includes public classes and attributes for these objects, as well as the relationships
between them.
The objects 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
should 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.

---------------------- Page: 12 ----------------------

SIST EN 61970-301:2004
61970-301  IEC:2005 – 13 –
ENERGY MANAGEMENT SYSTEM APPLICATION
PROGRAM INTERFACE (EMS-API) –

Part 301: Common Information Model (CIM) base


1 Scope
The Common Information Model (CIM) 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 Energy Management System
(EMS) applications developed independently by different vendors, between entire EMS
systems developed independently, or between an EMS system and other systems concerned
with different aspects of power system operations, such as generation or distribution
management. This is accomplished by defining a common language (i.e., semantics and
syntax) based on the CIM to enable these applications or systems to access public data and
exchange information independently of how such information is represented internally.
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 should 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.
Due to the size of the complete CIM, the object classes contained in the CIM are grouped into
a number of logical Packages, each of which represents a certain part of the overall power
system being modeled. Collections of these Packages are progressed as separate
International Standards. This part of IEC 61970 specifies a base set of packages which
provide a logical view of the physical aspects of Energy Management System (EMS)
information within the electric utility enterprise that is shared between all applications. Other
standards specify more specific parts of the model that are needed by only certain
applications. Subclause 4.2 below provides the current grouping of packages into standards
documents.
2 Normative references
The following referenced documents are indispensable for the application of this document.
For dated references, only the edition cited applies. For undated references, the latest edition
of the referenced document (including any amendments) applies.
IEC 61850 (all parts), Communication networks and systems in substations
ISO 8601, Data elements and interchange formats – Information interchange – Represent-
ation of dates and times
3 Terms and definitions
For the purposes of this part of IEC 61970, the terms and definitions given in IEC 60050,
Annex A of this document and the following apply.

---------------------- Page: 13 ----------------------

SIST EN 61970-301:2004
61970-301  IEC:2005 – 15 –
3.1
Energy Management System
EMS
computer system comprising a software platform providing basic support services and a set of
applications providing the functionality needed for the effective operation of electrical
generation and transmission facilities so as to assure adequate security of energy supply at
minimum cost
3.2
Application Program Interface
API
set of public functions provided by an executable application component for use by other
executable application components
4 CIM specification
4.1 CIM modeling notation
The CIM is defined using object-oriented modeling techniques. Specifically, the CIM
specification uses the Unified Modeling Language (UML) notation, which defines the CIM as a
group of packages.
Each package in the CIM contains one or more class diagrams showing graphically all the
classes in that package and their relationships. Each class is then defined in text in terms of
its attributes and relationships to other classes.
The UML notation is described in Object Management Group (OMG) documents and several
published textbooks.
4.2 CIM packages
The CIM is partitioned into a set of packages. A package is a general purpose means of
grouping related model elements. There is no specific semantic meaning. The packages have
been chosen to make the model easier to design, understand and review. The common
information model consists of the complete set of packages. Entities may have associations
that cross many package boundaries. Each application will use information represented in
several packages.
The comprehensive CIM is partitioned into the following packages for convenience, where
packages are grouped to be handled as a single standard document as shown:
IEC 61970-301
– Core
– Domain
– Generation
– Generation Dynamics
– LoadModel
– Meas
– Outage
– Production
– Protection
– Topology
– Wires

---------------------- Page: 14 ----------------------

SIST EN 61970-301:2004
61970-301  IEC:2005 – 17 –
Future IEC 61970-302
– Energy Scheduling
– Financial
– Reservation
Future IEC 61970-303
– SCADA
IEC 61968
– Assets
– Consumer
– Core2
– Distribution
– Documentation
Note that the package boundaries do not imply application boundaries. An application may
use CIM entities from several packages.
Figure 1 shows the packages defined for IEC 61970-301 CIM Base and their dependency
relationships. The dashed line indicates a dependency relationship, with the arrowhead
pointing from the dependent package to the package on which it has a dependency.
Generation LoadModel Outage Protection
Meas
Wires
Topology
Core <>
Domain

IEC  2608/03
Figure 1 – CIM Part 301 Package Diagram
The following Subclauses summarize the contents of each CIM package. Annex A contains
the specification for each of the CIM packages.

---------------------- Page: 15 ----------------------

SIST EN 61970-301:2004
61970-301  IEC:2005 – 19 –
NOTE 1 The package definitions are loosely based on the “Conformance Blocks” that were defined for the CIM
specification version 7 defined in the EPRI CCAPI project.
NOTE 2 The contents of the CIM defined in this specification were obtained from a straight conversion of the
CCAPI CIM static information model defined in the CCAPI CIM Version 10.
NOTE 3 Annex B contains a mapping of the information modeling notation used in the CCAPI CIM Version 7 to
the UML used in this sta
...

Questions, Comments and Discussion

Ask us and Technical Secretary will try to provide an answer. You can facilitate discussion about the standard in here.