61970-301©1EC:2003 -1- Draft IEC 61970:Energy Management System Application Program Interface (EMS-API)一 Part 301:Common Information Model(CIM)Base Revision 7
61970-301 IEC:2003 – 1 – Draft IEC 61970: Energy Management System Application Program Interface (EMS-API) — Part 301: Common Information Model (CIM) Base Revision 7
61970-301©1EC:2003 -2- 1 Scope. 11 2 Normative References. 11 3 Definitions and Abbreviations.... 11 3.1 Energy Management System(EMS) 11 3.2 Application Program Interface (API). .12 4 CIM Specification.… 12 4.1 CIM Modeling Notation................. 12 4.2 CIM Packages. 12 4.2.1Core… 14 4.2.2 Topology… .14 4.2.3 Nires.… 14 4.2.40 utage.… 14 4.2.5 Protection.… .14 4.2.6Meas.… 14 4.2.7 LoadModel.… 14 4.2.8 Generation.… 15 4.2.9D0main… .15 4.3 CIM Classes and Relationships 15 4.3.1 Generalization....... 16 4.3.2 Simple Association.......... 17 4.3.3 Aggregation .17 4.4 CIM Model Concepts and Examples..... 17 4.4.1 Transformer Model............. 18 4.4.2 Connectivity Model.... 19 4.4.3 Inheritance Hierarchy........ 22 4.4.4 Equipment Containers... 24 4.5 Modeling Tools...................... 24 4.6 Modeling Guidelines....... 25 4.6.1 Amendments to the CIM. 25 4.6.2 CIM Profiles 26 4.7 User Implementation Conventions. 26 4.7.1 Naming................... 26 4.7.2 Use of Measurement-Related Classes...... 27 4.7.3 Number of Terminals for ConductingEquipment Objects 30 4.8 Examples.… 31 Anneg A. 32 A.1 Logical Architecture....... 32 1.1 Overview… 32 1.1.1 Context....... 32 2 Package Architecture. 33 2.1 CIM... 34 2.1.1 CimVersion.............. 34 2.2 Core.. 34 2.2.1 BasePower... 36
61970-301 IEC:2003 – 2 – 1 Scope..........................................................................................................................................................11 2 Normative References...........................................................................................................................11 3 Definitions and Abbreviations............................................................................................................. 11 3.1 Energy Management System (EMS)......................................................................................11 3.2 Application Program Interface (API)......................................................................................12 4 CIM Specification.................................................................................................................................... 12 4.1 CIM Modeling Notation.............................................................................................................. 12 4.2 CIM Packages.............................................................................................................................. 12 4.2.1 Core.................................................................................................................................. 14 4.2.2 Topology..........................................................................................................................14 4.2.3 Wires................................................................................................................................ 14 4.2.4 Outage............................................................................................................................. 14 4.2.5 Protection........................................................................................................................14 4.2.6 Meas.................................................................................................................................14 4.2.7 LoadModel...................................................................................................................... 14 4.2.8 Generation......................................................................................................................15 4.2.9 Domain.............................................................................................................................15 4.3 CIM Classes and Relationships.............................................................................................. 15 4.3.1 Generalization............................................................................................................... 16 4.3.2 Simple Association.......................................................................................................17 4.3.3 Aggregation....................................................................................................................17 4.4 CIM Model Concepts and Examples......................................................................................17 4.4.1 Transformer Model.......................................................................................................18 4.4.2 Connectivity Model.......................................................................................................19 4.4.3 Inheritance Hierarchy..................................................................................................22 4.4.4 Equipment Containers.................................................................................................24 4.5 Modeling Tools.............................................................................................................................24 4.6 Modeling Guidelines................................................................................................................... 25 4.6.1 Amendments to the CIM.............................................................................................25 4.6.2 CIM Profiles....................................................................................................................26 4.7 User Implementation Conventions......................................................................................... 26 4.7.1 Naming.............................................................................................................................26 4.7.2 Use of Measurement-Related Classes.................................................................. 27 4.7.3 Number of Terminals for ConductingEquipment Objects.................................30 4.8 Examples........................................................................................................................................31 Annex A......................................................................................................................................................... 32 A.1 Logical Architecture............................................................................................................................32 1.1 Overview.................................................................................................................................... 32 1.1.1 Context.........................................................................................................................32 2 Package Architecture........................................................................................................................ 33 2.1 CIM...............................................................................................................................................34 2.1.1 CimVersion................................................................................................................. 34 2.2 Core............................................................................................................................................. 34 2.2.1 BasePower..................................................................................................................36
61970-301©1EC:2003 -3- 2.2.2 BaseVoltage.… 36 2.2.3 Bay 36 2.2.4 C0 mpany… 37 2.2.5 ConductingEquipment. 37 2.2.6 ControlHouseEquipment. 38 2.2.7 CurveSchedData............ 38 2.2.8 CurveSchedFormula... 39 2.2.9 CurveSchedule.............. 39 2.2.10 Equipment........... 40 2.2.11 EquipmentContainer.... 40 2.2.12 Naming… 41 2.2.13 PowerSystemResource.... 41 2.2.14 PSRType… 42 2.2.15 SubControlArea............... 42 2.2.16 Substation. 43 2.2.17 Terminal.......... 44 2.2.18Unit… 45 2.2.19 VoltageLevel........ 45 2.3 D0main… 46 2.3.1 AbsoluteDateTime Primitive… 52 2.3.2 ActivePower Primitive..… 52 2.3.3 Admittance Primitive.... 52 2.3.4 AngleDegrees Primitive..… 52 2.3.5 AngleRadians Primitive 52 2.3.6 ApparentPower Primitive........ 53 2.3.7 BoilerControlMode Enumeration........ 53 2.3.8 Boolean Primitive.......... 53 2.3.9 BreakerConfiguration Enumeration... 53 2.3.10 BusbarConfiguration Enumeration......... 53 2.3.11 Classification Primitive..................... 54 2.3.12 ClearanceTagType Enumeration. 54 2.3.13 CompanyType Enumeration............. 54 2.3.14 CompensatorType Enumeration. 54 2.3.15 Complex Primitive 54 2.3.16 CompositeSwitchType Primitive...... 54 2.3.17 Conductance Primitive....................... 55 2.3.18 ControlHouseEquipmentType Enumeration 55 2.3.19 ControlMode Primitive. 55 2.3.20 CoolantType Enumeration........................ 55 2.3.21 CostPerEnergyUnit Primitive. 55 2.3.22 CostPerHeatUnit Primitive........... 55 2.3.23 CostPerHour Primitive........... 56 2.3.24 Counter Primitive 56 2.3.25 CurrentFlow Primitive....... 56 2.3.26 CurveStyle Enumeration. 56 2.3.27 Damping Primitive. 56
61970-301 IEC:2003 – 3 – 2.2.2 BaseVoltage............................................................................................................... 36 2.2.3 Bay................................................................................................................................ 36 2.2.4 Company..................................................................................................................... 37 2.2.5 ConductingEquipment............................................................................................. 37 2.2.6 ControlHouseEquipment.........................................................................................38 2.2.7 CurveSchedData.......................................................................................................38 2.2.8 CurveSchedFormula................................................................................................ 39 2.2.9 CurveSchedule.......................................................................................................... 39 2.2.10 Equipment...................................................................................................................40 2.2.11 EquipmentContainer................................................................................................ 40 2.2.12 Naming.........................................................................................................................41 2.2.13 PowerSystemResource...........................................................................................41 2.2.14 PSRType..................................................................................................................... 42 2.2.15 SubControlArea.........................................................................................................42 2.2.16 Substation................................................................................................................... 43 2.2.17 Terminal.......................................................................................................................44 2.2.18 Unit................................................................................................................................45 2.2.19 VoltageLevel...............................................................................................................45 2.3 Domain........................................................................................................................................46 2.3.1 AbsoluteDateTime Primitive...............................................................................52 2.3.2 ActivePower Primitive.......................................................................................... 52 2.3.3 Admittance Primitive.............................................................................................52 2.3.4 AngleDegrees Primitive.......................................................................................52 2.3.5 AngleRadians Primitive....................................................................................... 52 2.3.6 ApparentPower Primitive.....................................................................................53 2.3.7 BoilerControlMode Enumeration.......................................................................53 2.3.8 Boolean Primitive.................................................................................................. 53 2.3.9 BreakerConfiguration Enumeration..................................................................53 2.3.10 BusbarConfiguration Enumeration...................................................................53 2.3.11 Classification Primitive........................................................................................ 54 2.3.12 ClearanceTagType Enumeration......................................................................54 2.3.13 CompanyType Enumeration...............................................................................54 2.3.14 CompensatorType Enumeration....................................................................... 54 2.3.15 Complex Primitive................................................................................................. 54 2.3.16 CompositeSwitchType Primitive....................................................................... 54 2.3.17 Conductance Primitive.........................................................................................55 2.3.18 ControlHouseEquipmentType Enumeration..................................................55 2.3.19 ControlMode Primitive..........................................................................................55 2.3.20 CoolantType Enumeration.................................................................................. 55 2.3.21 CostPerEnergyUnit Primitive............................................................................. 55 2.3.22 CostPerHeatUnit Primitive..................................................................................55 2.3.23 CostPerHour Primitive......................................................................................... 56 2.3.24 Counter Primitive...................................................................................................56 2.3.25 CurrentFlow Primitive...........................................................................................56 2.3.26 CurveStyle Enumeration..................................................................................... 56 2.3.27 Damping Primitive.................................................................................................56
61970-301©1EC:2003 -4- 2.3.28 DateTime Primitive57 2.3.29 DayTypeName Enumeration....... 57 2.3.30 Double Primitive 57 2.3.31 Emission Primitive...... 57 2.3.32 EmissionType Enumeration.................. 57 2.3.33 EmissionValueSource Enumeration. 57 2.3.34 EnergyAsMWh Primitive.................. ------ 58 2.3.35 EnumeratedType Enumeration. 58 2.3.36 ExcitingCurrent Primitive. 58 2.3.37 Exponent Primitive.................. 58 2.3.38 Fraction Primitive.................... 58 2.3.39 FreqBiasFactor Primitive...... 58 2.3.40 Frequency Primitive........................ 59 2.3.41 FuelType Enumeration...... 59 2.3.42 GeneratorControlMode Enumeration. 59 2.3.43 GeneratorControlSource Enumeration. 59 2.3.44 GeneratorOperating Mode Enumeration...... 59 2.3.45 HeatperHour Primitive...................... 60 2.3.46 Hours Primitive. 60 2.3.47 HydroPlantType Enumeration. 60 2.3.48 Impedance Primitive................ 60 2.3.49 Inductance Primitive...... 61 2.3.50 Inertia Primitive 61 2.3.51 Load Primitive..... 61 2.3.52 LoadLoss Primitive....... 61 2.3.53 LongDouble Primitive. 61 2.3.54 LongLength Primitive..... 61 2.3.55 LongLong Primitive.......... 62 2.3.56 Money Primitive............. 62 2.3.57 NoLoadLoss Primitive. 62 2.3.58 Numeric union.................... 62 2.3.59 NumericType Enumeration. 62 2.3.60 OperatingMode Primitive.............. 63 2.3.61 ParticipationFactor Primitive....... 63 2.3.62 PenaltyFactor Primitive......... 63 2.3.63 PenstockType Enumeration. 63 2.3.64 PerCent Primitive.......... 63 2.3.65 Phasecode Primitive.. 64 2.3.66 PowerFactor Primitive........... 64 2.3.67 PowerROCPerMin Primitive..... 64 2.3.68 PowerROCPerSec Primitive................ 64 2.3.69 PowerVersusFrequency Primitive. 64 2.3.70 Powerversusvoltage Primitive 64 2.3.71 Pressure Primitive........... 65 2.3.72 Priority Primitive..... 65 2.3.73 PU Primitive.… 65
61970-301 IEC:2003 – 4 – 2.3.28 DateTime Primitive................................................................................................57 2.3.29 DayTypeName Enumeration.............................................................................. 57 2.3.30 Double Primitive.....................................................................................................57 2.3.31 Emission Primitive.................................................................................................57 2.3.32 EmissionType Enumeration............................................................................... 57 2.3.33 EmissionValueSource Enumeration................................................................ 57 2.3.34 EnergyAsMWh Primitive......................................................................................58 2.3.35 EnumeratedType Enumeration..........................................................................58 2.3.36 ExcitingCurrent Primitive.................................................................................... 58 2.3.37 Exponent Primitive................................................................................................58 2.3.38 Fraction Primitive.................................................................................................. 58 2.3.39 FreqBiasFactor Primitive.....................................................................................58 2.3.40 Frequency Primitive..............................................................................................59 2.3.41 FuelType Enumeration.........................................................................................59 2.3.42 GeneratorControlMode Enumeration.............................................................. 59 2.3.43 GeneratorControlSource Enumeration........................................................... 59 2.3.44 GeneratorOperatingMode Enumeration......................................................... 59 2.3.45 HeatPerHour Primitive......................................................................................... 60 2.3.46 Hours Primitive.......................................................................................................60 2.3.47 HydroPlantType Enumeration............................................................................60 2.3.48 Impedance Primitive.............................................................................................60 2.3.49 Inductance Primitive.............................................................................................61 2.3.50 Inertia Primitive......................................................................................................61 2.3.51 Load Primitive.........................................................................................................61 2.3.52 LoadLoss Primitive................................................................................................61 2.3.53 LongDouble Primitive...........................................................................................61 2.3.54 LongLength Primitive........................................................................................... 61 2.3.55 LongLong Primitive............................................................................................... 62 2.3.56 Money Primitive..................................................................................................... 62 2.3.57 NoLoadLoss Primitive.......................................................................................... 62 2.3.58 Numeric union........................................................................................................ 62 2.3.59 NumericType Enumeration.................................................................................62 2.3.60 OperatingMode Primitive.....................................................................................63 2.3.61 ParticipationFactor Primitive..............................................................................63 2.3.62 PenaltyFactor Primitive....................................................................................... 63 2.3.63 PenstockType Enumeration............................................................................... 63 2.3.64 PerCent Primitive.................................................................................................. 63 2.3.65 PhaseCode Primitive............................................................................................64 2.3.66 PowerFactor Primitive..........................................................................................64 2.3.67 PowerROCPerMin Primitive...............................................................................64 2.3.68 PowerROCPerSec Primitive...............................................................................64 2.3.69 PowerVersusFrequency Primitive.................................................................... 64 2.3.70 PowerVersusVoltage Primitive..........................................................................64 2.3.71 Pressure Primitive.................................................................................................65 2.3.72 Priority Primitive.................................................................................................... 65 2.3.73 PU Primitive............................................................................................................ 65
61970-301©1EC:2003 -5- 2.3.74 PUkVPerMVAr Primitive.................. 65 2.3.75 RampMethod Enumeration.... 65 2.3.76 RampStartMethod Enumeration. 65 2.3.77 RampUnits Enumeration. 66 2.3.78 RateOfChange Primitive. 66 2.3.79 Ratio Primitive. 66 2.3.80 Reactance Primitive................. 66 2.3.81 ReactivePower Primitive. 66 2.3.82 Reference/ Primitive..... 67 2.3.83 RemoteUnitType Enumeration. 67 2.3.84 Resistance Primitive................. 67 2.3.85 SeasonName Enumeration.... 67 2.3.86 Seconds Primitive...................... 67 2.3.87 Short Primitive..... 68 2.3.88 ShortLength Primitive. 68 2.3.89 Source Enumeration..... 68 2.3.90 SpillwayGateType Enumeration. 68 2.3.91 SurgeTankcode Enumeration........................................ 68 2.3.92 Susceptance Primitive 68 2.3.93 SwitchState Enumeration. 68 2.3.94 SynchronousMachineOperatingMode Enumeration........................ 69 2.3.95 SynchronousMachineType Enumeration......... 69 2.3.96 TapStep Primitive 69 2.3.97 Temperature Primitive..................... 69 2.3.98 TemperatureUnits Enumeration. 69 2.3.99 TerminalCount Primitive............... 70 2.3.100TerminalType Primitive.... 70 2.3.101TimeStamp Primitive........................ 70 2.3.102TransformerControlMode Enumeration.… 70 2.3.103TransformerCoolingType Enumeration.. 70 2.3.104TransformerType Enumeration. 70 2.3.105TurbineType Enumeration....... 71 2.3.106ULong Primitive...................... 71 2.3.107ULongLong Primitive....... 71 2.3.108Validity Enumeration...... 71 2.3.109Voltage Primitive............. 72 2.3.110Volume Primitive....... 72 2.3.111WaterLevel Primitive............... 72 2.3.112WindingConnection Enumeration. 72 2.3.113WindingType Enumeration....... 72 2.3.114XAxisType Enumeration........... 73 2.3.115XAxisUnits Enumeration..... 73 2.3.116Y1AxisUnits Enumeration............. 73 2.3.117Y2AxisUnits Enumeration.... 73 2.3.118YAxisType Enumeration. 73 2.4 Generation. 73
61970-301 IEC:2003 – 5 – 2.3.74 PUkVPerMVAr Primitive......................................................................................65 2.3.75 RampMethod Enumeration.................................................................................65 2.3.76 RampStartMethod Enumeration........................................................................65 2.3.77 RampUnits Enumeration..................................................................................... 66 2.3.78 RateOfChange Primitive......................................................................................66 2.3.79 Ratio Primitive........................................................................................................66 2.3.80 Reactance Primitive..............................................................................................66 2.3.81 ReactivePower Primitive..................................................................................... 66 2.3.82 Reference Primitive.............................................................................................. 67 2.3.83 RemoteUnitType Enumeration.......................................................................... 67 2.3.84 Resistance Primitive.............................................................................................67 2.3.85 SeasonName Enumeration.................................................................................67 2.3.86 Seconds Primitive................................................................................................. 67 2.3.87 Short Primitive........................................................................................................68 2.3.88 ShortLength Primitive...........................................................................................68 2.3.89 Source Enumeration.............................................................................................68 2.3.90 SpillwayGateType Enumeration........................................................................68 2.3.91 SurgeTankCode Enumeration........................................................................... 68 2.3.92 Susceptance Primitive......................................................................................... 68 2.3.93 SwitchState Enumeration....................................................................................68 2.3.94 SynchronousMachineOperatingMode Enumeration....................................69 2.3.95 SynchronousMachineType Enumeration........................................................69 2.3.96 TapStep Primitive..................................................................................................69 2.3.97 Temperature Primitive..........................................................................................69 2.3.98 TemperatureUnits Enumeration........................................................................69 2.3.99 TerminalCount Primitive......................................................................................70 2.3.100TerminalType Primitive........................................................................................70 2.3.101TimeStamp Primitive............................................................................................ 70 2.3.102TransformerControlMode Enumeration.......................................................... 70 2.3.103TransformerCoolingType Enumeration...........................................................70 2.3.104TransformerType Enumeration......................................................................... 70 2.3.105TurbineType Enumeration.................................................................................. 71 2.3.106ULong Primitive......................................................................................................71 2.3.107ULongLong Primitive............................................................................................ 71 2.3.108Validity Enumeration............................................................................................ 71 2.3.109Voltage Primitive................................................................................................... 72 2.3.110Volume Primitive....................................................................................................72 2.3.111WaterLevel Primitive............................................................................................ 72 2.3.112WindingConnection Enumeration..................................................................... 72 2.3.113WindingType Enumeration................................................................................. 72 2.3.114XAxisType Enumeration......................................................................................73 2.3.115XAxisUnits Enumeration......................................................................................73 2.3.116Y1AxisUnits Enumeration................................................................................... 73 2.3.117Y2AxisUnits Enumeration................................................................................... 73 2.3.118YAxisType Enumeration......................................................................................73 2.4 Generation.................................................................................................................................73