EnergySource

A generic equivalent for an energy supplier on a transmission or distribution voltage level.

Type

Class

URI

cim:EnergySource

CIM standard (perspective)

IEC61970 (Grid)

Slots

Associated classes
Figure 1. Associated classes
Name Cardinality Type Description

InstanceSet

1

InstanceSet

Dataset containing the data objects.

EnergySchedulingType

0..1

EnergySchedulingType

Energy Scheduling Type of an Energy Source.

EnergySourceAction

0..1

EnergySourceAction

Action taken with this energy source.

activePower

0..1

ActivePower

High voltage source active injection. Load sign convention is used, i.e. positive sign means flow out from a node. Starting value for steady state solutions.

nominalVoltage

0..1

Voltage

Phase-to-phase nominal voltage.

pMax

0..1

ActivePower

This is the maximum active power that can be produced by the source. Load sign convention is used, i.e. positive sign means flow out from a TopologicalNode (bus) into the conducting equipment.

pMin

0..1

ActivePower

This is the minimum active power that can be produced by the source. Load sign convention is used, i.e. positive sign means flow out from a TopologicalNode (bus) into the conducting equipment.

r

0..1

Resistance

Positive sequence Thevenin resistance.

r0

0..1

Resistance

Zero sequence Thevenin resistance.

reactivePower

0..1

ReactivePower

High voltage source reactive injection. Load sign convention is used, i.e. positive sign means flow out from a node. Starting value for steady state solutions.

rn

0..1

Resistance

Negative sequence Thevenin resistance.

voltageAngle

0..1

AngleRadians

Phase angle of a-phase open circuit used when voltage characteristics need to be imposed at the node associated with the terminal of the energy source, such as when voltages and angles from the transmission level are used as input to the distribution network. The attribute shall be a positive value or zero.

voltageMagnitude

0..1

Voltage

Phase-to-phase open circuit voltage magnitude used when voltage characteristics need to be imposed at the node associated with the terminal of the energy source, such as when voltages and angles from the transmission level are used as input to the distribution network. The attribute shall be a positive value or zero.

x

0..1

Reactance

Positive sequence Thevenin reactance.

x0

0..1

Reactance

Zero sequence Thevenin reactance.

xn

0..1

Reactance

Negative sequence Thevenin reactance.

EnergySourcePhase

0..*

EnergySourcePhase

The individual phase information of the energy source.

AssetDatasheet

0..1

AssetInfo

Datasheet information for this power system resource.

BaseVoltage

0..1

BaseVoltage

Base voltage of this conducting equipment. Use only when there is no voltage level container used and only one base voltage applies. For example, not used for transformers.

EquipmentContainer

0..1

EquipmentContainer

Container of this equipment.

GroundingAction

0..1

GroundAction

Action involving grounding operation on this conducting equipment.

JumpingAction

0..1

JumperAction

Jumper action involving jumping operation on this conducting equipment.

Location

0..1

Location

Location of this power system resource.

Outage

0..1

Outage

The outage that is isolated by the outage isolation equipment.

PSRType

0..1

PSRType

Custom classification for this power system resource.

PropertiesCIMDataObject

0..1

ChangeSetMember

The single CIM data object in the appropriate dataset context.

aggregate

0..1

boolean

The aggregate flag provides an alternative way of representing an aggregated (equivalent) element. It is applicable in cases when the dedicated classes for equivalent equipment do not have all of the attributes necessary to represent the required level of detail. In case the flag is set to “true” the single instance of equipment represents multiple pieces of equipment that have been modelled together as an aggregate equivalent obtained by a network reduction procedure. Examples would be power transformers or synchronous machines operating in parallel modelled as a single aggregate power transformer or aggregate synchronous machine. The attribute is not used for EquivalentBranch, EquivalentShunt and EquivalentInjection.

aliasName

0..1

string

The aliasName is free text human readable name of the object alternative to IdentifiedObject.name. It may be non unique and may not correlate to a naming hierarchy. The attribute aliasName is retained because of backwards compatibility between CIM relases. It is however recommended to replace aliasName with the Name class as aliasName is planned for retirement at a future time.

description

0..1

string

The description is a free human readable text describing or naming the object. It may be non unique and may not correlate to a naming hierarchy.

inService

0..1

boolean

Specifies the availability of the equipment. True means the equipment is available for topology processing, which determines if the equipment is energized or not. False means that the equipment is treated by network applications as if it is not in the model.

mRID

0..1

string

Master resource identifier issued by a model authority. The mRID is unique within an exchange context. Global uniqueness is easily achieved by using a UUID, as specified in RFC 4122, for the mRID. The use of UUID is strongly recommended. For CIMXML data files in RDF syntax conforming to IEC 61970-552, the mRID is mapped to rdf:ID or rdf:about attributes that identify CIM object elements.

name

0..1

string

The name is any free human readable and possibly non unique text naming the object.

networkAnalysisEnabled

0..1

boolean

The equipment is enabled to participate in network analysis. If unspecified, the value is assumed to be true.

normallyInService

0..1

boolean

Specifies the availability of the equipment under normal operating conditions. True means the equipment is available for topology processing, which determines if the equipment is energized or not. False means that the equipment is treated by network applications as if it is not in the model.

AdditionalEquipmentContainer

0..*

EquipmentContainer

Additional equipment container beyond the primary equipment container. The equipment is contained in another equipment container, but also grouped with this equipment container.

Assets

0..*

Asset

All assets represented by this power system resource. For example, multiple conductor assets are electrically modelled as a single AC line segment.

Clearances

0..*

ClearanceDocument

All clearances applicable to this power system resource.

ConfigurationEvent

0..*

ConfigurationEvent

All configuration events created for this Power System resource.

ContingencyEquipment

0..*

ContingencyEquipment

The contingency equipments in which this equipment participates.

Controls

0..*

Control

The controller outputs used to actually govern a regulating device, e.g. the magnetization of a synchronous machine or capacitor bank breaker actuator.

DiagramObjects

0..*

DiagramObject

The diagram objects that are associated with the domain object.

EnergyComponent

0..*

EnergyComponent

n/a

EqiupmentLimitSeriesComponent

0..*

EquipmentLimitSeriesComponent

Equipment limit series calculation component to which this equipment contributes.

EquipmentUnavailabilitySchedule

0..*

EquipmentUnavailabilitySchedule

n/a

Faults

0..*

Fault

All faults on this equipment.

GenericAction

0..*

GenericAction

The generic action that is performed on the power system resource

LimitDependencyModel

0..*

LimitDependency

Limit dependencymodels organized under this equipment as a means for organizing the model in a tree view.

Measurements

0..*

Measurement

The measurements associated with this power system resource.

Names

0..*

Name

All names of this identified object.

OperatingShare

0..*

OperatingShare

The operating shares of this power system resource.

OperationalLimitSet

0..*

OperationalLimitSet

The operational limit sets associated with this equipment.

OperationalRestrictions

0..*

OperationalRestriction

All operational restrictions for this equipment.

OperationalTags

0..*

OperationalTag

All operational tags placed on this power system resource.

Outages

0..*

Outage

All outages in which this equipment is involved.

PSREvents

0..*

PSREvent

All events associated with this power system resource.

PinEquipment

0..*

PinEquipment

n/a

ProtectionEquipments

0..*

ProtectionEquipment

Protection equipment used to protect specific conducting equipment.

ProtectiveActionAdjustment

0..*

ProtectiveActionAdjustment

The operating condition to the Conducting Equipment is changed when protective action adjustment is activated. For ShuntCompensator or other conducting equipment that operates on discrete values (integer), the values given in float will be rounded.

ProtectiveActionEquipment

0..*

ProtectiveActionEquipment

Protective action is controlling equipment. This can be direct signals from the control center, or emulation of action done by protection equipment.

ReportingGroup

0..*

ReportingGroup

Reporting groups to which this power system resource belongs.

SvStatus

0..*

SvStatus

The status state variable associated with this conducting equipment.

TargetingCIMDataObject

0..*

ChangeSetMember

Data objects registered.

Terminals

0..*

Terminal

Conducting equipment have terminals that may be connected to other conducting equipment terminals via connectivity nodes or topological nodes.

UsagePoints

0..*

UsagePoint

All usage points connected to the electrical grid through this equipment.

VerificationAction

0..*

VerificationAction

The verification action that is performed on the power system resource

WeatherStation

0..*

WeatherStation

n/a


activePower

High voltage source active injection. Load sign convention is used, i.e. positive sign means flow out from a node. Starting value for steady state solutions.

URI

cim:EnergySource.activePower

Cardinality

0..1

Type

ActivePower

AdditionalEquipmentContainer

Additional equipment container beyond the primary equipment container. The equipment is contained in another equipment container, but also grouped with this equipment container.

URI

cim:Equipment.AdditionalEquipmentContainer

Cardinality

0..*

Type

EquipmentContainer

Inherited from

Equipment

aggregate

The aggregate flag provides an alternative way of representing an aggregated (equivalent) element. It is applicable in cases when the dedicated classes for equivalent equipment do not have all of the attributes necessary to represent the required level of detail. In case the flag is set to “true” the single instance of equipment represents multiple pieces of equipment that have been modelled together as an aggregate equivalent obtained by a network reduction procedure. Examples would be power transformers or synchronous machines operating in parallel modelled as a single aggregate power transformer or aggregate synchronous machine. The attribute is not used for EquivalentBranch, EquivalentShunt and EquivalentInjection.

URI

cim:Equipment.aggregate

Cardinality

0..1

Type

boolean

Inherited from

Equipment

aliasName

The aliasName is free text human readable name of the object alternative to IdentifiedObject.name. It may be non unique and may not correlate to a naming hierarchy. The attribute aliasName is retained because of backwards compatibility between CIM relases. It is however recommended to replace aliasName with the Name class as aliasName is planned for retirement at a future time.

URI

cim:IdentifiedObject.aliasName

Cardinality

0..1

Type

string

Inherited from

IdentifiedObject

AssetDatasheet

Datasheet information for this power system resource.

URI

cim:PowerSystemResource.AssetDatasheet

Cardinality

0..1

Type

AssetInfo

Inherited from

PowerSystemResource

Assets

All assets represented by this power system resource. For example, multiple conductor assets are electrically modelled as a single AC line segment.

URI

cim:PowerSystemResource.Assets

Cardinality

0..*

Type

Asset

Inherited from

PowerSystemResource

BaseVoltage

Base voltage of this conducting equipment. Use only when there is no voltage level container used and only one base voltage applies. For example, not used for transformers.

URI

cim:ConductingEquipment.BaseVoltage

Cardinality

0..1

Type

BaseVoltage

Inherited from

ConductingEquipment

Clearances

All clearances applicable to this power system resource.

URI

cim:PowerSystemResource.Clearances

Cardinality

0..*

Type

ClearanceDocument

Inherited from

PowerSystemResource

ConfigurationEvent

All configuration events created for this Power System resource.

URI

cim:PowerSystemResource.ConfigurationEvent

Cardinality

0..*

Type

ConfigurationEvent

Inherited from

PowerSystemResource

ContingencyEquipment

The contingency equipments in which this equipment participates.

URI

cim:Equipment.ContingencyEquipment

Cardinality

0..*

Type

ContingencyEquipment

Inherited from

Equipment

Controls

The controller outputs used to actually govern a regulating device, e.g. the magnetization of a synchronous machine or capacitor bank breaker actuator.

URI

cim:PowerSystemResource.Controls

Cardinality

0..*

Type

Control

Inherited from

PowerSystemResource

description

The description is a free human readable text describing or naming the object. It may be non unique and may not correlate to a naming hierarchy.

URI

cim:IdentifiedObject.description

Cardinality

0..1

Type

string

Inherited from

IdentifiedObject

DiagramObjects

The diagram objects that are associated with the domain object.

URI

cim:IdentifiedObject.DiagramObjects

Cardinality

0..*

Type

DiagramObject

Inherited from

IdentifiedObject

EnergyComponent

URI

cim:EnergyConnection.EnergyComponent

Cardinality

0..*

Type

EnergyComponent

Inherited from

EnergyConnection

EnergySchedulingType

Energy Scheduling Type of an Energy Source.

URI

cim:EnergySource.EnergySchedulingType

Cardinality

0..1

Type

EnergySchedulingType

EnergySourceAction

Action taken with this energy source.

URI

cim:EnergySource.EnergySourceAction

Cardinality

0..1

Type

EnergySourceAction

EnergySourcePhase

The individual phase information of the energy source.

URI

cim:EnergySource.EnergySourcePhase

Cardinality

0..*

Type

EnergySourcePhase

EqiupmentLimitSeriesComponent

Equipment limit series calculation component to which this equipment contributes.

URI

cim:Equipment.EqiupmentLimitSeriesComponent

Cardinality

0..*

Type

EquipmentLimitSeriesComponent

Inherited from

Equipment

EquipmentContainer

Container of this equipment.

URI

cim:Equipment.EquipmentContainer

Cardinality

0..1

Type

EquipmentContainer

Inherited from

Equipment

EquipmentUnavailabilitySchedule

URI

cim:Equipment.EquipmentUnavailabilitySchedule

Cardinality

0..*

Type

EquipmentUnavailabilitySchedule

Inherited from

Equipment

Faults

All faults on this equipment.

URI

cim:Equipment.Faults

Cardinality

0..*

Type

Fault

Inherited from

Equipment

GenericAction

The generic action that is performed on the power system resource

URI

cim:PowerSystemResource.GenericAction

Cardinality

0..*

Type

GenericAction

Inherited from

PowerSystemResource

GroundingAction

Action involving grounding operation on this conducting equipment.

URI

cim:ConductingEquipment.GroundingAction

Cardinality

0..1

Type

GroundAction

Inherited from

ConductingEquipment

inService

Specifies the availability of the equipment. True means the equipment is available for topology processing, which determines if the equipment is energized or not. False means that the equipment is treated by network applications as if it is not in the model.

URI

cim:Equipment.inService

Cardinality

0..1

Type

boolean

Inherited from

Equipment

InstanceSet

Dataset containing the data objects.

URI

cim:IdentifiedObject.InstanceSet

Cardinality

1

Type

InstanceSet

Inherited from

IdentifiedObject

JumpingAction

Jumper action involving jumping operation on this conducting equipment.

URI

cim:ConductingEquipment.JumpingAction

Cardinality

0..1

Type

JumperAction

Inherited from

ConductingEquipment

LimitDependencyModel

Limit dependencymodels organized under this equipment as a means for organizing the model in a tree view.

URI

cim:Equipment.LimitDependencyModel

Cardinality

0..*

Type

LimitDependency

Inherited from

Equipment

Location

Location of this power system resource.

URI

cim:PowerSystemResource.Location

Cardinality

0..1

Type

Location

Inherited from

PowerSystemResource

Measurements

The measurements associated with this power system resource.

URI

cim:PowerSystemResource.Measurements

Cardinality

0..*

Type

Measurement

Inherited from

PowerSystemResource

mRID

Master resource identifier issued by a model authority. The mRID is unique within an exchange context. Global uniqueness is easily achieved by using a UUID, as specified in RFC 4122, for the mRID. The use of UUID is strongly recommended. For CIMXML data files in RDF syntax conforming to IEC 61970-552, the mRID is mapped to rdf:ID or rdf:about attributes that identify CIM object elements.

URI

cim:IdentifiedObject.mRID

Cardinality

0..1

Type

string

Inherited from

IdentifiedObject

name

The name is any free human readable and possibly non unique text naming the object.

URI

cim:IdentifiedObject.name

Cardinality

0..1

Type

string

Inherited from

IdentifiedObject

Names

All names of this identified object.

URI

cim:IdentifiedObject.Names

Cardinality

0..*

Type

Name

Inherited from

IdentifiedObject

networkAnalysisEnabled

The equipment is enabled to participate in network analysis. If unspecified, the value is assumed to be true.

URI

cim:Equipment.networkAnalysisEnabled

Cardinality

0..1

Type

boolean

Inherited from

Equipment

nominalVoltage

Phase-to-phase nominal voltage.

URI

cim:EnergySource.nominalVoltage

Cardinality

0..1

Type

Voltage

normallyInService

Specifies the availability of the equipment under normal operating conditions. True means the equipment is available for topology processing, which determines if the equipment is energized or not. False means that the equipment is treated by network applications as if it is not in the model.

URI

cim:Equipment.normallyInService

Cardinality

0..1

Type

boolean

Inherited from

Equipment

OperatingShare

The operating shares of this power system resource.

URI

cim:PowerSystemResource.OperatingShare

Cardinality

0..*

Type

OperatingShare

Inherited from

PowerSystemResource

OperationalLimitSet

The operational limit sets associated with this equipment.

URI

cim:Equipment.OperationalLimitSet

Cardinality

0..*

Type

OperationalLimitSet

Inherited from

Equipment

OperationalRestrictions

All operational restrictions for this equipment.

URI

cim:Equipment.OperationalRestrictions

Cardinality

0..*

Type

OperationalRestriction

Inherited from

Equipment

OperationalTags

All operational tags placed on this power system resource.

URI

cim:PowerSystemResource.OperationalTags

Cardinality

0..*

Type

OperationalTag

Inherited from

PowerSystemResource

Outage

The outage that is isolated by the outage isolation equipment.

URI

cim:ConductingEquipment.Outage

Cardinality

0..1

Type

Outage

Inherited from

ConductingEquipment

Outages

All outages in which this equipment is involved.

URI

cim:Equipment.Outages

Cardinality

0..*

Type

Outage

Inherited from

Equipment

PinEquipment

URI

cim:Equipment.PinEquipment

Cardinality

0..*

Type

PinEquipment

Inherited from

Equipment

pMax

This is the maximum active power that can be produced by the source. Load sign convention is used, i.e. positive sign means flow out from a TopologicalNode (bus) into the conducting equipment.

URI

cim:EnergySource.pMax

Cardinality

0..1

Type

ActivePower

pMin

This is the minimum active power that can be produced by the source. Load sign convention is used, i.e. positive sign means flow out from a TopologicalNode (bus) into the conducting equipment.

URI

cim:EnergySource.pMin

Cardinality

0..1

Type

ActivePower

PropertiesCIMDataObject

The single CIM data object in the appropriate dataset context.

URI

cim:IdentifiedObject.PropertiesCIMDataObject

Cardinality

0..1

Type

ChangeSetMember

Inherited from

IdentifiedObject

ProtectionEquipments

Protection equipment used to protect specific conducting equipment.

URI

cim:ConductingEquipment.ProtectionEquipments

Cardinality

0..*

Type

ProtectionEquipment

Inherited from

ConductingEquipment

ProtectiveActionAdjustment

The operating condition to the Conducting Equipment is changed when protective action adjustment is activated. For ShuntCompensator or other conducting equipment that operates on discrete values (integer), the values given in float will be rounded.

URI

cim:ConductingEquipment.ProtectiveActionAdjustment

Cardinality

0..*

Type

ProtectiveActionAdjustment

Inherited from

ConductingEquipment

ProtectiveActionEquipment

Protective action is controlling equipment. This can be direct signals from the control center, or emulation of action done by protection equipment.

URI

cim:Equipment.ProtectiveActionEquipment

Cardinality

0..*

Type

ProtectiveActionEquipment

Inherited from

Equipment

PSREvents

All events associated with this power system resource.

URI

cim:PowerSystemResource.PSREvents

Cardinality

0..*

Type

PSREvent

Inherited from

PowerSystemResource

PSRType

Custom classification for this power system resource.

URI

cim:PowerSystemResource.PSRType

Cardinality

0..1

Type

PSRType

Inherited from

PowerSystemResource

r

Positive sequence Thevenin resistance.

URI

cim:EnergySource.r

Cardinality

0..1

Type

Resistance

r0

Zero sequence Thevenin resistance.

URI

cim:EnergySource.r0

Cardinality

0..1

Type

Resistance

reactivePower

High voltage source reactive injection. Load sign convention is used, i.e. positive sign means flow out from a node. Starting value for steady state solutions.

URI

cim:EnergySource.reactivePower

Cardinality

0..1

Type

ReactivePower

ReportingGroup

Reporting groups to which this power system resource belongs.

URI

cim:PowerSystemResource.ReportingGroup

Cardinality

0..*

Type

ReportingGroup

Inherited from

PowerSystemResource

rn

Negative sequence Thevenin resistance.

URI

cim:EnergySource.rn

Cardinality

0..1

Type

Resistance

SvStatus

The status state variable associated with this conducting equipment.

URI

cim:ConductingEquipment.SvStatus

Cardinality

0..*

Type

SvStatus

Inherited from

ConductingEquipment

TargetingCIMDataObject

Data objects registered.

URI

cim:IdentifiedObject.TargetingCIMDataObject

Cardinality

0..*

Type

ChangeSetMember

Inherited from

IdentifiedObject

Terminals

Conducting equipment have terminals that may be connected to other conducting equipment terminals via connectivity nodes or topological nodes.

URI

cim:ConductingEquipment.Terminals

Cardinality

0..*

Type

Terminal

Inherited from

ConductingEquipment

UsagePoints

All usage points connected to the electrical grid through this equipment.

URI

cim:Equipment.UsagePoints

Cardinality

0..*

Type

UsagePoint

Inherited from

Equipment

VerificationAction

The verification action that is performed on the power system resource

URI

cim:PowerSystemResource.VerificationAction

Cardinality

0..*

Type

VerificationAction

Inherited from

PowerSystemResource

voltageAngle

Phase angle of a-phase open circuit used when voltage characteristics need to be imposed at the node associated with the terminal of the energy source, such as when voltages and angles from the transmission level are used as input to the distribution network. The attribute shall be a positive value or zero.

URI

cim:EnergySource.voltageAngle

Cardinality

0..1

Type

AngleRadians

voltageMagnitude

Phase-to-phase open circuit voltage magnitude used when voltage characteristics need to be imposed at the node associated with the terminal of the energy source, such as when voltages and angles from the transmission level are used as input to the distribution network. The attribute shall be a positive value or zero.

URI

cim:EnergySource.voltageMagnitude

Cardinality

0..1

Type

Voltage

WeatherStation

URI

cim:Equipment.WeatherStation

Cardinality

0..*

Type

WeatherStation

Inherited from

Equipment

x

Positive sequence Thevenin reactance.

URI

cim:EnergySource.x

Cardinality

0..1

Type

Reactance

x0

Zero sequence Thevenin reactance.

URI

cim:EnergySource.x0

Cardinality

0..1

Type

Reactance

xn

Negative sequence Thevenin reactance.

URI

cim:EnergySource.xn

Cardinality

0..1

Type

Reactance