TapChangerControl

Describes behaviour specific to tap changers, e.g. how the voltage at the end of a line varies with the load level and compensation of the voltage drop by tap adjustment.

Type

Class

URI

cim:TapChangerControl

CIM standard (perspective)

IEC61970 (Grid)

Class hierarchy

Slots

Associated classes
Figure 1. Associated classes
Name Cardinality Type Description

TapChanger

1..*

TapChanger

The tap changers that participates in this regulating tap control scheme.

InstanceSet

1

InstanceSet

Dataset containing the data objects.

limitVoltage

0..1

Voltage

Maximum allowed regulated voltage on the PT secondary, regardless of line drop compensation. Sometimes referred to as first-house protection.

lineDropCompensation

0..1

boolean

If true, the line drop compensation is to be applied.

lineDropR

0..1

Resistance

Line drop compensator resistance setting for normal (forward) power flow.

lineDropX

0..1

Reactance

Line drop compensator reactance setting for normal (forward) power flow.

reverseLineDropR

0..1

Resistance

Line drop compensator resistance setting for reverse power flow.

reverseLineDropX

0..1

Reactance

Line drop compensator reactance setting for reverse power flow.

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.

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.

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.

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.

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.

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.

name

0..1

string

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

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.

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.

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.

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

Inherited from

RegulatingControl

enabled

The flag tells if regulation is enabled.

URI

cim:RegulatingControl.enabled

Cardinality

0..1

Type

boolean

Inherited from

RegulatingControl

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

limitVoltage

Maximum allowed regulated voltage on the PT secondary, regardless of line drop compensation. Sometimes referred to as first-house protection.

URI

cim:TapChangerControl.limitVoltage

Cardinality

0..1

Type

Voltage

lineDropCompensation

If true, the line drop compensation is to be applied.

URI

cim:TapChangerControl.lineDropCompensation

Cardinality

0..1

Type

boolean

lineDropR

Line drop compensator resistance setting for normal (forward) power flow.

URI

cim:TapChangerControl.lineDropR

Cardinality

0..1

Type

Resistance

lineDropX

Line drop compensator reactance setting for normal (forward) power flow.

URI

cim:TapChangerControl.lineDropX

Cardinality

0..1

Type

Reactance

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

Inherited from

RegulatingControl

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

Inherited from

RegulatingControl

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

Inherited from

RegulatingControl

monitoredPhase

Phase voltage controlling this regulator, measured at regulator location.

URI

cim:RegulatingControl.monitoredPhase

Cardinality

0..1

Type

PhaseCode

Inherited from

RegulatingControl

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

Inherited from

RegulatingControl

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

Inherited from

RegulatingControl

RegulationSchedule

Schedule for this regulating control.

URI

cim:RegulatingControl.RegulationSchedule

Cardinality

0..*

Type

RegulationSchedule

Inherited from

RegulatingControl

ReportingGroup

Reporting groups to which this power system resource belongs.

URI

cim:PowerSystemResource.ReportingGroup

Cardinality

0..*

Type

ReportingGroup

Inherited from

PowerSystemResource

reverseLineDropR

Line drop compensator resistance setting for reverse power flow.

URI

cim:TapChangerControl.reverseLineDropR

Cardinality

0..1

Type

Resistance

reverseLineDropX

Line drop compensator reactance setting for reverse power flow.

URI

cim:TapChangerControl.reverseLineDropX

Cardinality

0..1

Type

Reactance

TapChanger

The tap changers that participates in this regulating tap control scheme.

URI

cim:TapChangerControl.TapChanger

Cardinality

1..*

Type

TapChanger

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

Inherited from

RegulatingControl

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

Inherited from

RegulatingControl

targetValueUnitMultiplier

Specify the multiplier for used for the targetValue.

URI

cim:RegulatingControl.targetValueUnitMultiplier

Cardinality

0..1

Type

UnitMultiplier

Inherited from

RegulatingControl

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

Inherited from

RegulatingControl

VerificationAction

The verification action that is performed on the power system resource

URI

cim:PowerSystemResource.VerificationAction

Cardinality

0..*

Type

VerificationAction

Inherited from

PowerSystemResource