RegulatingControl

Specifies a set of equipment that works together to control a power system quantity such as voltage or flow. Remote bus voltage control is possible by specifying the controlled terminal located at some place remote from the controlling equipment. The specified terminal shall be associated with the connectivity node of the controlled point. The most specific subtype of RegulatingControl shall be used in case such equipment participate in the control, e.g. TapChangerControl for tap changers. For flow control, load sign convention is used, i.e. positive sign means flow out from a TopologicalNode (bus) into the conducting equipment. The attribute minAllowedTargetValue and maxAllowedTargetValue are required in the following cases: - For a power generating module operated in power factor control mode to specify maximum and minimum power factor values; - Whenever it is necessary to have an off center target voltage for the tap changer regulator. For instance, due to long cables to off shore wind farms and the need to have a simpler setup at the off shore transformer platform, the voltage is controlled from the land at the connection point for the off shore wind farm. Since there usually is a voltage rise along the cable, there is typical and overvoltage of up 3-4 kV compared to the on shore station. Thus in normal operation the tap changer on the on shore station is operated with a target set point, which is in the lower parts of the dead band. The attributes minAllowedTargetValue and maxAllowedTargetValue are not related to the attribute targetDeadband and thus they are not treated as an alternative of the targetDeadband. They are needed due to limitations in the local substation controller. The attribute targetDeadband is used to prevent the power flow from move the tap position in circles (hunting) that is to be used regardless of the attributes minAllowedTargetValue and maxAllowedTargetValue.

Type

Class

URI

cim:RegulatingControl

CIM standard (perspective)

IEC61970 (Grid)

Slots

Associated classes
Figure 1. Associated classes
Name Cardinality Type Description

InstanceSet

1

InstanceSet

Dataset containing the data objects.

Terminal

0..1

Terminal

The terminal associated with this regulating control. The terminal is associated instead of a node, since the terminal could connect into either a topological node or a connectivity node. Sometimes it is useful to model regulation at a terminal of a bus bar object.

discrete

0..1

boolean

The regulation is performed in a discrete mode. This applies to equipment with discrete controls, e.g. tap changers and shunt compensators.

enabled

0..1

boolean

The flag tells if regulation is enabled.

maxAllowedTargetValue

0..1

float

Maximum allowed target value (RegulatingControl.targetValue).

minAllowedTargetValue

0..1

float

Minimum allowed target value (RegulatingControl.targetValue).

mode

0..1

RegulatingControlModeKind

The regulating control mode presently available. This specification allows for determining the kind of regulation without need for obtaining the units from a schedule.

monitoredPhase

0..1

PhaseCode

Phase voltage controlling this regulator, measured at regulator location.

targetDeadband

0..1

float

This is a deadband used with discrete control to avoid excessive update of controls like tap changers and shunt compensator banks while regulating. The units of those appropriate for the mode. The attribute shall be a positive value or zero. If RegulatingControl.discrete is set to "false", the RegulatingControl.targetDeadband is to be ignored. Note that for instance, if the targetValue is 100 kV and the targetDeadband is 2 kV the range is from 99 to 101 kV.

targetValue

0..1

float

The target value specified for case input. This value can be used for the target value without the use of schedules. The value has the units appropriate to the mode attribute.

targetValueUnitMultiplier

0..1

UnitMultiplier

Specify the multiplier for used for the targetValue.

ProtectiveActionRegulation

0..*

ProtectiveActionRegulation

Enable/disable a regulating control or set new target value.

RegulatingCondEq

0..*

RegulatingCondEq

The equipment that participates in this regulating control scheme.

RegulationSchedule

0..*

RegulationSchedule

Schedule for this regulating control.

AssetDatasheet

0..1

AssetInfo

Datasheet information for this power system resource.

Location

0..1

Location

Location of this power system resource.

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.

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.

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.

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.

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.

GenericAction

0..*

GenericAction

The generic action that is performed on the power system resource

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.

OperationalTags

0..*

OperationalTag

All operational tags placed on this power system resource.

PSREvents

0..*

PSREvent

All events associated with this power system resource.

ReportingGroup

0..*

ReportingGroup

Reporting groups to which this power system resource belongs.

TargetingCIMDataObject

0..*

ChangeSetMember

Data objects registered.

VerificationAction

0..*

VerificationAction

The verification action that is performed on the power system resource


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

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

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

discrete

The regulation is performed in a discrete mode. This applies to equipment with discrete controls, e.g. tap changers and shunt compensators.

URI

cim:RegulatingControl.discrete

Cardinality

0..1

Type

boolean

enabled

The flag tells if regulation is enabled.

URI

cim:RegulatingControl.enabled

Cardinality

0..1

Type

boolean

GenericAction

The generic action that is performed on the power system resource

URI

cim:PowerSystemResource.GenericAction

Cardinality

0..*

Type

GenericAction

Inherited from

PowerSystemResource

InstanceSet

Dataset containing the data objects.

URI

cim:IdentifiedObject.InstanceSet

Cardinality

1

Type

InstanceSet

Inherited from

IdentifiedObject

Location

Location of this power system resource.

URI

cim:PowerSystemResource.Location

Cardinality

0..1

Type

Location

Inherited from

PowerSystemResource

maxAllowedTargetValue

Maximum allowed target value (RegulatingControl.targetValue).

URI

cim:RegulatingControl.maxAllowedTargetValue

Cardinality

0..1

Type

float

Measurements

The measurements associated with this power system resource.

URI

cim:PowerSystemResource.Measurements

Cardinality

0..*

Type

Measurement

Inherited from

PowerSystemResource

minAllowedTargetValue

Minimum allowed target value (RegulatingControl.targetValue).

URI

cim:RegulatingControl.minAllowedTargetValue

Cardinality

0..1

Type

float

mode

The regulating control mode presently available. This specification allows for determining the kind of regulation without need for obtaining the units from a schedule.

URI

cim:RegulatingControl.mode

Cardinality

0..1

Type

RegulatingControlModeKind

monitoredPhase

Phase voltage controlling this regulator, measured at regulator location.

URI

cim:RegulatingControl.monitoredPhase

Cardinality

0..1

Type

PhaseCode

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

OperatingShare

The operating shares of this power system resource.

URI

cim:PowerSystemResource.OperatingShare

Cardinality

0..*

Type

OperatingShare

Inherited from

PowerSystemResource

OperationalTags

All operational tags placed on this power system resource.

URI

cim:PowerSystemResource.OperationalTags

Cardinality

0..*

Type

OperationalTag

Inherited from

PowerSystemResource

PropertiesCIMDataObject

The single CIM data object in the appropriate dataset context.

URI

cim:IdentifiedObject.PropertiesCIMDataObject

Cardinality

0..1

Type

ChangeSetMember

Inherited from

IdentifiedObject

ProtectiveActionRegulation

Enable/disable a regulating control or set new target value.

URI

cim:RegulatingControl.ProtectiveActionRegulation

Cardinality

0..*

Type

ProtectiveActionRegulation

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

RegulatingCondEq

The equipment that participates in this regulating control scheme.

URI

cim:RegulatingControl.RegulatingCondEq

Cardinality

0..*

Type

RegulatingCondEq

RegulationSchedule

Schedule for this regulating control.

URI

cim:RegulatingControl.RegulationSchedule

Cardinality

0..*

Type

RegulationSchedule

ReportingGroup

Reporting groups to which this power system resource belongs.

URI

cim:PowerSystemResource.ReportingGroup

Cardinality

0..*

Type

ReportingGroup

Inherited from

PowerSystemResource

targetDeadband

This is a deadband used with discrete control to avoid excessive update of controls like tap changers and shunt compensator banks while regulating. The units of those appropriate for the mode. The attribute shall be a positive value or zero. If RegulatingControl.discrete is set to "false", the RegulatingControl.targetDeadband is to be ignored. Note that for instance, if the targetValue is 100 kV and the targetDeadband is 2 kV the range is from 99 to 101 kV.

URI

cim:RegulatingControl.targetDeadband

Cardinality

0..1

Type

float

TargetingCIMDataObject

Data objects registered.

URI

cim:IdentifiedObject.TargetingCIMDataObject

Cardinality

0..*

Type

ChangeSetMember

Inherited from

IdentifiedObject

targetValue

The target value specified for case input. This value can be used for the target value without the use of schedules. The value has the units appropriate to the mode attribute.

URI

cim:RegulatingControl.targetValue

Cardinality

0..1

Type

float

targetValueUnitMultiplier

Specify the multiplier for used for the targetValue.

URI

cim:RegulatingControl.targetValueUnitMultiplier

Cardinality

0..1

Type

UnitMultiplier

Terminal

The terminal associated with this regulating control. The terminal is associated instead of a node, since the terminal could connect into either a topological node or a connectivity node. Sometimes it is useful to model regulation at a terminal of a bus bar object.

URI

cim:RegulatingControl.Terminal

Cardinality

0..1

Type

Terminal

VerificationAction

The verification action that is performed on the power system resource

URI

cim:PowerSystemResource.VerificationAction

Cardinality

0..*

Type

VerificationAction

Inherited from

PowerSystemResource