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

IEC 61970-301:2020 (E) 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 edition reflects the model content version ‘IEC61970CIM17v38’, dated ‘2020-01-21’, and includes the following significant technical changes with respect to the previous edition:
a) Added Feeder modelling;
b) Added ICCP configuration modelling;
c) Correction of issues found in interoperability testing or use of the standard;
d) Improved documentation;
e) Updated Annex A with custom extensions;
f) Added Annex B Examples of PST transformer modelling;
g) Added Annex C HVDC use cases.

General Information

Status
Published
Publication Date
25-Jun-2020
Current Stage
PPUB - Publication issued
Completion Date
26-Jun-2020
Ref Project

Buy Standard

Standard
IEC 61970-301:2020 - Energy management system application program interface (EMS-API) - Part 301: Common information model (CIM) base
English language
554 pages
sale 15% off
Preview
sale 15% off
Preview

Standards Content (sample)

IEC 61970-301
Edition 7.0 2020-06
INTERNATIONAL
STANDARD
colour
inside
Energy management system application program interface (EMS-API) –
Part 301: Common information model (CIM) base
IEC 61970-301:2020-06(en)
---------------------- Page: 1 ----------------------
THIS PUBLICATION IS COPYRIGHT PROTECTED
Copyright © 2020 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.
IEC Central Office Tel.: +41 22 919 02 11
3, rue de Varembé info@iec.ch
CH-1211 Geneva 20 www.iec.ch
Switzerland
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 corrigendum or an amendment might have been published.

IEC publications search - webstore.iec.ch/advsearchform Electropedia - www.electropedia.org

The advanced search enables to find IEC publications by a The world's leading online dictionary on electrotechnology,

variety of criteria (reference number, text, technical containing more than 22 000 terminological entries in English

committee,…). It also gives information on projects, replaced and French, with equivalent terms in 16 additional languages.

and withdrawn publications. Also known as the International Electrotechnical Vocabulary

(IEV) online.
IEC Just Published - webstore.iec.ch/justpublished

Stay up to date on all new IEC publications. Just Published IEC Glossary - std.iec.ch/glossary

details all new publications released. Available online and 67 000 electrotechnical terminology entries in English and

once a month by email. French extracted from the Terms and Definitions clause of

IEC publications issued since 2002. Some entries have been

IEC Customer Service Centre - webstore.iec.ch/csc collected from earlier publications of IEC TC 37, 77, 86 and

If you wish to give us your feedback on this publication or CISPR.
need further assistance, please contact the Customer Service
Centre: sales@iec.ch.
---------------------- Page: 2 ----------------------
IEC 61970-301
Edition 7.0 2020-06
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-8502-2

Warning! Make sure that you obtained this publication from an authorized distributor.

® Registered trademark of the International Electrotechnical Commission
---------------------- Page: 3 ----------------------
– 2 – IEC 61970-301:2020  IEC 2020
CONTENTS

FOREWORD ......................................................................................................................... 35

INTRODUCTION ................................................................................................................... 37

1 Scope ............................................................................................................................ 39

2 Normative references .................................................................................................... 39

3 Terms and definitions .................................................................................................... 40

4 CIM specification ........................................................................................................... 40

4.1 Overview............................................................................................................... 40

4.2 CIM modelling notation ......................................................................................... 41

4.3 CIM packages ....................................................................................................... 41

4.4 CIM classes and relationships ............................................................................... 43

4.4.1 Classes ......................................................................................................... 43

4.4.2 Generalization ............................................................................................... 44

4.4.3 Simple association ......................................................................................... 45

4.4.4 Aggregation ................................................................................................... 46

4.5 CIM model concepts and examples ....................................................................... 46

4.5.1 Concepts ....................................................................................................... 46

4.5.2 Containment, equipment hierarchies and naming ........................................... 47

4.5.3 Names model ................................................................................................ 48

4.5.4 Connectivity model ........................................................................................ 49

4.5.5 Inheritance hierarchy ..................................................................................... 52

4.5.6 Transformer model ........................................................................................ 54

4.5.7 Transformer tap modelling ............................................................................. 56

4.5.8 Phase wire modelling ..................................................................................... 69

4.5.9 Grounding devices modelling ......................................................................... 71

4.5.10 Cuts, clamps and jumpers model ................................................................... 75

4.5.11 Measurements and controls ........................................................................... 79

4.5.12 Regulating control models ............................................................................. 84

4.5.13 DC model for CIM .......................................................................................... 85

4.5.14 Static Var Compensator Voltage Regulation ................................................ 107

4.5.15 ICCP Configuration Model ........................................................................... 108

4.5.16 Feeder Model .............................................................................................. 115

4.5.17 Control area modelling ................................................................................. 115

4.6 Modelling guidelines ........................................................................................... 117

4.6.1 Modelling for change ................................................................................... 117

4.6.2 Process for amendments to the CIM ............................................................ 117

4.6.3 Changes to the CIM UML model .................................................................. 118

4.6.4 Changes to the CIM standards documents ................................................... 118

4.6.5 Deprecations ............................................................................................... 118

4.6.6 CIM profiles ................................................................................................. 118

4.7 Modelling tools .................................................................................................... 119

4.8 User implementation conventions ........................................................................ 119

4.8.1 Conventions beyond UML ............................................................................ 119

4.8.2 Number of terminals for ConductingEquipment objects ................................ 119

4.8.3 Nominal quantities ....................................................................................... 120

4.8.4 Datatypes .................................................................................................... 120

4.9 CIM modelling examples ..................................................................................... 120

5 Detailed model ............................................................................................................ 120

---------------------- Page: 4 ----------------------
IEC 61970-301:2020  IEC 2020 – 3 –

5.1 Overview............................................................................................................. 120

5.2 Context ............................................................................................................... 120

6 Package Base ............................................................................................................. 122

6.1 General ............................................................................................................... 122

6.2 Package Domain ................................................................................................. 122

6.2.1 General ....................................................................................................... 122

6.2.2 ActivePower datatype .................................................................................. 128

6.2.3 ActivePowerChangeRate datatype ............................................................... 129

6.2.4 ActivePowerPerCurrentFlow datatype .......................................................... 129

6.2.5 ActivePowerPerFrequency datatype ............................................................ 129

6.2.6 Admittance datatype .................................................................................... 129

6.2.7 AngleDegrees datatype ............................................................................... 130

6.2.8 AngleRadians datatype ................................................................................ 130

6.2.9 ApparentPower datatype.............................................................................. 130

6.2.10 Area datatype .............................................................................................. 130

6.2.11 Boolean primitive ......................................................................................... 131

6.2.12 Capacitance datatype .................................................................................. 131

6.2.13 CapacitancePerLength datatype .................................................................. 131

6.2.14 Classification datatype ................................................................................. 131

6.2.15 Conductance datatype ................................................................................. 131

6.2.16 ConductancePerLength datatype ................................................................. 132

6.2.17 CostPerEnergyUnit datatype ........................................................................ 132

6.2.18 CostPerHeatUnit datatype ........................................................................... 132

6.2.19 CostPerVolume datatype ............................................................................. 132

6.2.20 CostRate datatype ....................................................................................... 133

6.2.21 Currency enumeration ................................................................................. 133

6.2.22 CurrentFlow datatype .................................................................................. 137

6.2.23 Damping datatype ........................................................................................ 137

6.2.24 Date primitive .............................................................................................. 137

6.2.25 DateInterval compound ................................................................................ 137

6.2.26 DateTime primitive ....................................................................................... 138

6.2.27 DateTimeInterval compound ........................................................................ 138

6.2.28 Decimal primitive ......................................................................................... 138

6.2.29 DecimalQuantity compound ......................................................................... 138

6.2.30 Displacement datatype ................................................................................ 138

6.2.31 Duration primitive ........................................................................................ 139

6.2.32 Emission datatype ....................................................................................... 139

6.2.33 Float primitive .............................................................................................. 139

6.2.34 FloatQuantity compound .............................................................................. 139

6.2.35 Frequency datatype ..................................................................................... 139

6.2.36 HeatRate datatype ....................................................................................... 140

6.2.37 Hours datatype ............................................................................................ 140

6.2.38 Impedance datatype .................................................................................... 140

6.2.39 Inductance datatype .................................................................................... 140

6.2.40 InductancePerLength datatype .................................................................... 141

6.2.41 Integer primitive ........................................................................................... 141

6.2.42 IntegerQuantity compound ........................................................................... 141

6.2.43 KiloActivePower datatype ............................................................................ 141

6.2.44 Length datatype ........................................................................................... 142

---------------------- Page: 5 ----------------------
– 4 – IEC 61970-301:2020  IEC 2020

6.2.45 Mass datatype ............................................................................................. 142

6.2.46 Minutes datatype ......................................................................................... 142

6.2.47 Money datatype ........................................................................................... 142

6.2.48 MonthDay primitive ...................................................................................... 143

6.2.49 MonthDayInterval compound ....................................................................... 143

6.2.50 PU datatype ................................................................................................. 143

6.2.51 PerCent datatype ......................................................................................... 143

6.2.52 Pressure datatype ....................................................................................... 143

6.2.53 Reactance datatype ..................................................................................... 144

6.2.54 ReactancePerLength datatype ..................................................................... 144

6.2.55 ReactivePower datatype .............................................................................. 144

6.2.56 RealEnergy datatype ................................................................................... 144

6.2.57 Resistance datatype .................................................................................... 145

6.2.58 ResistancePerLength datatype .................................................................... 145

6.2.59 RotationSpeed datatype .............................................................................. 145

6.2.60 Seconds datatype ........................................................................................ 146

6.2.61 Speed datatype ........................................................................................... 146

6.2.62 String primitive ............................................................................................ 146

6.2.63 StringQuantity compound............................................................................. 146

6.2.64 Susceptance datatype ................................................................................. 146

6.2.65 SusceptancePerLength datatype ................................................................. 147

6.2.66 Temperature datatype.................................................................................. 147

6.2.67 Time primitive .............................................................................................. 147

6.2.68 TimeInterval compound ............................................................................... 147

6.2.69 UnitMultiplier enumeration ........................................................................... 148

6.2.70 UnitSymbol enumeration .............................................................................. 149

6.2.71 Voltage datatype.......................................................................................... 154

6.2.72 VoltagePerReactivePower datatype ............................................................. 154

6.2.73 Volume datatype .......................................................................................... 154

6.2.74 VolumeFlowRate datatype ........................................................................... 155

6.2.75 WaterLevel datatype .................................................................................... 155

6.3 Package Core ..................................................................................................... 155

6.3.1 General ....................................................................................................... 155

6.3.2 ACDCTerminal ............................................................................................. 160

6.3.3 BaseFrequency............................................................................................ 161

6.3.4 BasePower .................................................................................................. 162

6.3.5 BaseVoltage ................................................................................................ 162

6.3.6 BasicIntervalSchedule ................................................................................. 163

6.3.7 Bay .............................................................................................................. 163

6.3.8 BreakerConfiguration enumeration............................................................... 164

6.3.9 BusbarConfiguration enumeration ................................................................ 165

6.3.10 ConductingEquipment .................................................................................. 165

6.3.11 ConnectivityNode ........................................................................................ 166

6.3.12 ConnectivityNodeContainer ......................................................................... 167

6.3.13 Curve .......................................................................................................... 167

6.3.14 CurveData root class ................................................................................... 168

6.3.15 CurveStyle enumeration .............................................................................. 169

6.3.16 Equipment ................................................................................................... 169

6.3.17 EquipmentContainer .................................................................................... 170

---------------------- Page: 6 ----------------------
IEC 61970-301:2020  IEC 2020 – 5 –

6.3.18 Feeder ......................................................................................................... 171

6.3.19 GeographicalRegion .................................................................................... 172

6.3.20 IdentifiedObject root class ........................................................................... 173

6.3.21 IrregularIntervalSchedule ............................................................................. 174

6.3.22 IrregularTimePoint root class ....................................................................... 174

6.3.23 Name root class ........................................................................................... 175

6.3.24 NameType root class ................................................................................... 175

6.3.25 NameTypeAuthority root class ..................................................................... 176

6.3.26 OperatingParticipant .................................................................................... 176

6.3.27 OperatingShare root class ........................................................................... 177

6.3.28 PSRType ..................................................................................................... 177

6.3.29 PhaseCode enumeration ............................................................................. 178

6.3.30 PowerSystemResource ................................................................................ 179

6.3.31 RegularIntervalSchedule .............................................................................. 179

6.3.32 RegularTimePoint root class ........................................................................ 180

6.3.33 ReportingGroup ........................................................................................... 181

6.3.34 ReportingSuperGroup .................................................................................. 181

6.3.35 SubGeographicalRegion .............................................................................. 182

6.3.36 Substation ................................................................................................... 183

6.3.37 Terminal ...................................................................................................... 184

6.3.38 VoltageLevel ................................................................................................ 185

6.4 Package Wires .................................................................................................... 186

6.4.1 General ....................................................................................................... 186

6.4.2 AsynchronousMachineKind enumeration ...................................................... 201

6.4.3 ACLineSegment ........................................................................................... 202

6.4.4 ACLineSegmentPhase ................................................................................. 203

6.4.5 AsynchronousMachine ................................................................................. 204

6.4.6 Breaker........................................................................................................ 206

6.4.7 BusbarSection ............................................................................................. 208

6.4.8 Clamp .......................................................................................................... 209

6.4.9 CompositeSwitch ......................................................................................... 210

6.4.10 Conductor .................................................................................................... 211

6.4.11 Connector .................................................................................................... 212

6.4.12 CoolantType enumeration ............................................................................ 213

6.4.13 Cut .............................................................................................................. 213

6.4.14 Disconnector ............................................................................................... 215

6.4.15 DisconnectingCircuitBreaker ........................................................................ 216

6.4.16 EarthFaultCompensator ............................................................................... 217

6.4.17 EnergyConnection ....................................................................................... 218

6.4.18 EnergyConsumer ......................................................................................... 219

6.4.19 EnergyConsumerPhase ............................................................................... 221

6.4.20 EnergySchedulingType ................................................................................ 222

6.4.21 EnergySource .............................................................................................. 222

6.4.22 EnergySourcePhase .................................................................................... 224

6.4.23 ExternalNetworkInjection ............................................................................. 225

6.4.24 FrequencyConverter .................................................................................... 227

6.4.25 Fuse ............................................................................................................ 228

6.4.26 Ground ........................................................................................................ 229

6.4.27 GroundingImpedance .................................................................................. 230

---------------------- Page: 7 ----------------------
– 6 – IEC 61970-301:2020  IEC 2020

6.4.28 GroundDisconnector .................................................................................... 231

6.4.29 Jumper ........................................................................................................ 232

6.4.30 Junction ....................................................................................................... 234

6.4.31 Line ............................................................................................................. 234

6.4.32 LinearShuntCompensator ............................................................................ 235

6.4.33 LinearShuntCompensatorPhase ................................................................... 237

6.4.34 LoadBreakSwitch ......................................................................................... 237

6.4.35 MutualCoupling ............................................................................................ 239

6.4.36 NonlinearShuntCompensator ....................................................................... 240

6.4.37 NonlinearShuntCompensatorPhase ............................................................. 241

6.4.38 NonlinearShuntCompensatorPhasePoint root class ..................................... 242

6.4.39 NonlinearShuntCompensatorPoint root class ............................................... 243

6.4.40 PerLengthImpedance ................................................................................... 243

6.4.41 PerLengthLineParameter ............................................................................. 244

6.4.42 PerLengthPhaseImpedance ......................................................................... 244

6.4.43 PerLengthSequenceImpedance ................................................................... 245

6.4.44 PetersenCoil ................................................................................................ 246

6.4.45 PetersenCoilModeKind enumeration ............................................................ 247

6.4.46 PhaseImpedanceData root class .................................................................. 247

6.4.47 PhaseShuntConnectionKind enumeration .................................................... 248

6.4.48 PhaseTapChanger ....................................................................................... 249

6.4.49 PhaseTapChangerAsymmetrical .................................................................. 250

6.4.50 PhaseTapChangerLinear ............................................................................. 251

6.4.51 PhaseTapChangerNonLinear ....................................................................... 252

6.4.52 PhaseTapChangerSymmetrical .................................................................... 254

6.4.53 PhaseTapChangerTable .............................................................................. 255

6.4.54 PhaseTapChangerTablePoint ...................................................................... 255

6.4.55 PhaseTapChangerTabular ........................................................................... 256

6.4.56 Plant ............................................................................................................ 257

6.4.57 PowerElectronicsConnection ....................................................................... 258

6.4.58 PowerElectronicsConnectionPhase ........
...

Questions, Comments and Discussion

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