RatioTapChanger

Type: object

A tap changer that changes the voltage ratio impacting the voltage magnitude but not the phase angle across the transformer.

Angle sign convention (general): Positive value indicates a positive phase shift from the winding where the tap is located to the other winding (for a two-winding transformer).

No Additional Properties

AssetInfo_anyOfPointer

Type: object

Pointer to AssetInfo object

AssetInfo_Pointer

Type: string

Pointer to AssetInfo object

Must match regular expression: ^AssetInfo::'(.+)'$

PowerTransformerInfo_Pointer

Type: string

Pointer to PowerTransformerInfo object

Must match regular expression: ^PowerTransformerInfo::'(.+)'$

WireInfo_Pointer

Type: string

Pointer to WireInfo object

Must match regular expression: ^WireInfo::'(.+)'$

SwitchInfo_Pointer

Type: string

Pointer to SwitchInfo object

Must match regular expression: ^SwitchInfo::'(.+)'$

ShuntCompensatorInfo_Pointer

Type: string

Pointer to ShuntCompensatorInfo object

Must match regular expression: ^ShuntCompensatorInfo::'(.+)'$

WireAssemblyInfo_Pointer

Type: string

Pointer to WireAssemblyInfo object

Must match regular expression: ^WireAssemblyInfo::'(.+)'$

TransformerEndInfo_Pointer

Type: string

Pointer to TransformerEndInfo object

Must match regular expression: ^TransformerEndInfo::'(.+)'$

TapChangerInfo_Pointer

Type: string

Pointer to TapChangerInfo object

Must match regular expression: ^TapChangerInfo::'(.+)'$

WireSpacingInfo_Pointer

Type: string

Pointer to WireSpacingInfo object

Must match regular expression: ^WireSpacingInfo::'(.+)'$

TransformerTankInfo_Pointer

Type: string

Pointer to TransformerTankInfo object

Must match regular expression: ^TransformerTankInfo::'(.+)'$

CableInfo_Pointer

Type: string

Pointer to CableInfo object

Must match regular expression: ^CableInfo::'(.+)'$

OverheadWireInfo_Pointer

Type: string

Pointer to OverheadWireInfo object

Must match regular expression: ^OverheadWireInfo::'(.+)'$

ConcentricNeutralCableInfo_Pointer

Type: string

Pointer to ConcentricNeutralCableInfo object

Must match regular expression: ^ConcentricNeutralCableInfo::'(.+)'$

TapeShieldCableInfo_Pointer

Type: string

Pointer to TapeShieldCableInfo object

Must match regular expression: ^TapeShieldCableInfo::'(.+)'$

GenericAction_PointerArray

Type: array of string

Pointers to GenericAction objects

No Additional Items

Each item of this array must be:

GenericAction_Pointer

Type: string

Pointer to GenericAction object

Location_anyOfPointer

Type: object

Pointer to Location object

Location_Pointer

Type: string

Pointer to Location object

Must match regular expression: ^Location::'(.+)'$

ProposedSiteLocation_Pointer

Type: string

Pointer to ProposedSiteLocation object

Must match regular expression: ^ProposedSiteLocation::'(.+)'$

TapChangerControl

Type: object

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.

No Additional Properties

GenericAction_PointerArray

Type: array of string

Pointers to GenericAction objects

Same definition as PowerSystemResource.GenericAction

Location_anyOfPointer

Type: object

Pointer to Location object

Same definition as PowerSystemResource.Location

Terminal

Type: object

An AC electrical connection point to a piece of conducting equipment. Terminals are connected at physical connection points called connectivity nodes.

No Additional Properties

OperationalLimitSet_PointerArray

Type: array of string

Pointers to OperationalLimitSet objects

No Additional Items

Each item of this array must be:

OperationalLimitSet_Pointer

Type: string

Pointer to OperationalLimitSet object

SvPowerFlow_Array

Type: array

Array of SvPowerFlow objects

No Additional Items

Each item of this array must be:

SvPowerFlow

Type: object

State variable for power flow. Load convention is used for flow direction. This means flow out from the TopologicalNode into the equipment is positive.

No Additional Properties

p

Type: object or number

The active power flow. Load sign convention is used, i.e. positive sign means flow out from a TopologicalNode (bus) into the conducting equipment.

No Additional Properties

UnitSymbol

Type: enum (of string) Default: "W"

nan

Must be one of:

  • "UnitSymbol.JPerkg"
  • "UnitSymbol.NPerm"
  • "UnitSymbol.WPerW"
  • "UnitSymbol.JPermol"
  • "UnitSymbol.WPerm2sr"
  • "UnitSymbol.V"
  • "UnitSymbol.A2h"
  • "UnitSymbol.JPerK"
  • "UnitSymbol.m3Perkg"
  • "UnitSymbol.HzPerHz"
  • "UnitSymbol.T"
  • "UnitSymbol.Vh"
  • "UnitSymbol.tonne"
  • "UnitSymbol.JPerm2"
  • "UnitSymbol.CPerkg"
  • "UnitSymbol.VPerHz"
  • "UnitSymbol.ohm"
  • "UnitSymbol.K"
  • "UnitSymbol.m3Compensated"
  • "UnitSymbol.lx"
  • "UnitSymbol.lPerh"
  • "UnitSymbol.APerm"
  • "UnitSymbol.charPers"
  • "UnitSymbol.katPerm3"
  • "UnitSymbol.Pas"
  • "UnitSymbol.ohmPerm"
  • "UnitSymbol.radPers2"
  • "UnitSymbol.Btu"
  • "UnitSymbol.WPers"
  • "UnitSymbol.h"
  • "UnitSymbol.lPerl"
  • "UnitSymbol.l"
  • "UnitSymbol.As"
  • "UnitSymbol.cosPhi"
  • "UnitSymbol.W"
  • "UnitSymbol.count"
  • "UnitSymbol.PaPers"
  • "UnitSymbol.onePerHz"
  • "UnitSymbol.m3Pers"
  • "UnitSymbol.KPers"
  • "UnitSymbol.Vs"
  • "UnitSymbol.m2Pers"
  • "UnitSymbol.Ah"
  • "UnitSymbol.deg"
  • "UnitSymbol.mPers2"
  • "UnitSymbol.lm"
  • "UnitSymbol.d"
  • "UnitSymbol.JPerkgK"
  • "UnitSymbol.m"
  • "UnitSymbol.min"
  • "UnitSymbol.dB"
  • "UnitSymbol.Gy"
  • "UnitSymbol.Nm"
  • "UnitSymbol.JPerm3"
  • "UnitSymbol.sPers"
  • "UnitSymbol.Q"
  • "UnitSymbol.rev"
  • "UnitSymbol.N"
  • "UnitSymbol.Bq"
  • "UnitSymbol.WPermK"
  • "UnitSymbol.GyPers"
  • "UnitSymbol.HPerm"
  • "UnitSymbol.molPerkg"
  • "UnitSymbol.molPerm3"
  • "UnitSymbol.Wb"
  • "UnitSymbol.VPerm"
  • "UnitSymbol.WPerm2"
  • "UnitSymbol.kn"
  • "UnitSymbol.CPerm2"
  • "UnitSymbol.anglemin"
  • "UnitSymbol.Oe"
  • "UnitSymbol.kgm"
  • "UnitSymbol.character"
  • "UnitSymbol.APerA"
  • "UnitSymbol.A2s"
  • "UnitSymbol.Qh"
  • "UnitSymbol.JPers"
  • "UnitSymbol.Hz"
  • "UnitSymbol.rad"
  • "UnitSymbol.kat"
  • "UnitSymbol.degC"
  • "UnitSymbol.bar"
  • "UnitSymbol.M"
  • "UnitSymbol.molPermol"
  • "UnitSymbol.kgPerJ"
  • "UnitSymbol.J"
  • "UnitSymbol.HzPers"
  • "UnitSymbol.WPersr"
  • "UnitSymbol.anglesec"
  • "UnitSymbol.F"
  • "UnitSymbol.Mx"
  • "UnitSymbol.ha"
  • "UnitSymbol.SPerm"
  • "UnitSymbol.gal"
  • "UnitSymbol.mmHg"
  • "UnitSymbol.m2"
  • "UnitSymbol.mPers"
  • "UnitSymbol.V2h"
  • "UnitSymbol.m3"
  • "UnitSymbol.G"
  • "UnitSymbol.H"
  • "UnitSymbol.mol"
  • "UnitSymbol.rotPers"
  • "UnitSymbol.VAh"
  • "UnitSymbol.mPerm3"
  • "UnitSymbol.onePerm"
  • "UnitSymbol.V2"
  • "UnitSymbol.WPerA"
  • "UnitSymbol.Pa"
  • "UnitSymbol.kgPerm3"
  • "UnitSymbol.CPerm3"
  • "UnitSymbol.Sv"
  • "UnitSymbol.S"
  • "UnitSymbol.JPermolK"
  • "UnitSymbol.ft3"
  • "UnitSymbol.Wh"
  • "UnitSymbol.radPers"
  • "UnitSymbol.ohmm"
  • "UnitSymbol.kgm2"
  • "UnitSymbol.m3Perh"
  • "UnitSymbol.dBm"
  • "UnitSymbol.VA"
  • "UnitSymbol.A2"
  • "UnitSymbol.s"
  • "UnitSymbol.therm"
  • "UnitSymbol.VArh"
  • "UnitSymbol.cd"
  • "UnitSymbol.VPerV"
  • "UnitSymbol.gPerg"
  • "UnitSymbol.kg"
  • "UnitSymbol.A"
  • "UnitSymbol.m3Uncompensated"
  • "UnitSymbol.ppm"
  • "UnitSymbol.FPerm"
  • "UnitSymbol.C"
  • "UnitSymbol.sr"
  • "UnitSymbol.none"
  • "UnitSymbol.VPerVAr"
  • "UnitSymbol.VAr"
  • "UnitSymbol.VPerVA"
  • "UnitSymbol.lPers"

UnitMultiplier

Type: enum (of string) Default: "none"

nan

Must be one of:

  • "UnitMultiplier.f"
  • "UnitMultiplier.c"
  • "UnitMultiplier.G"
  • "UnitMultiplier.d"
  • "UnitMultiplier.z"
  • "UnitMultiplier.p"
  • "UnitMultiplier.y"
  • "UnitMultiplier.h"
  • "UnitMultiplier.Y"
  • "UnitMultiplier.a"
  • "UnitMultiplier.none"
  • "UnitMultiplier.k"
  • "UnitMultiplier.m"
  • "UnitMultiplier.n"
  • "UnitMultiplier.E"
  • "UnitMultiplier.da"
  • "UnitMultiplier.T"
  • "UnitMultiplier.M"
  • "UnitMultiplier.P"
  • "UnitMultiplier.Z"
  • "UnitMultiplier.micro"

phase

Type: enum (of string)

The individual phase of the flow. If unspecified, then assumed to be balanced among phases.

Must be one of:

  • "SinglePhaseKind.B"
  • "SinglePhaseKind.N"
  • "SinglePhaseKind.C"
  • "SinglePhaseKind.s2"
  • "SinglePhaseKind.A"
  • "SinglePhaseKind.s1"

q

Type: object or number

The reactive power flow. Load sign convention is used, i.e. positive sign means flow out from a TopologicalNode (bus) into the conducting equipment.

No Additional Properties

UnitMultiplier

Type: enum (of string) Default: "none"

nan

Must be one of:

  • "UnitMultiplier.f"
  • "UnitMultiplier.c"
  • "UnitMultiplier.G"
  • "UnitMultiplier.d"
  • "UnitMultiplier.z"
  • "UnitMultiplier.p"
  • "UnitMultiplier.y"
  • "UnitMultiplier.h"
  • "UnitMultiplier.Y"
  • "UnitMultiplier.a"
  • "UnitMultiplier.none"
  • "UnitMultiplier.k"
  • "UnitMultiplier.m"
  • "UnitMultiplier.n"
  • "UnitMultiplier.E"
  • "UnitMultiplier.da"
  • "UnitMultiplier.T"
  • "UnitMultiplier.M"
  • "UnitMultiplier.P"
  • "UnitMultiplier.Z"
  • "UnitMultiplier.micro"

UnitSymbol

Type: enum (of string) Default: "VAr"

nan

Must be one of:

  • "UnitSymbol.JPerkg"
  • "UnitSymbol.NPerm"
  • "UnitSymbol.WPerW"
  • "UnitSymbol.JPermol"
  • "UnitSymbol.WPerm2sr"
  • "UnitSymbol.V"
  • "UnitSymbol.A2h"
  • "UnitSymbol.JPerK"
  • "UnitSymbol.m3Perkg"
  • "UnitSymbol.HzPerHz"
  • "UnitSymbol.T"
  • "UnitSymbol.Vh"
  • "UnitSymbol.tonne"
  • "UnitSymbol.JPerm2"
  • "UnitSymbol.CPerkg"
  • "UnitSymbol.VPerHz"
  • "UnitSymbol.ohm"
  • "UnitSymbol.K"
  • "UnitSymbol.m3Compensated"
  • "UnitSymbol.lx"
  • "UnitSymbol.lPerh"
  • "UnitSymbol.APerm"
  • "UnitSymbol.charPers"
  • "UnitSymbol.katPerm3"
  • "UnitSymbol.Pas"
  • "UnitSymbol.ohmPerm"
  • "UnitSymbol.radPers2"
  • "UnitSymbol.Btu"
  • "UnitSymbol.WPers"
  • "UnitSymbol.h"
  • "UnitSymbol.lPerl"
  • "UnitSymbol.l"
  • "UnitSymbol.As"
  • "UnitSymbol.cosPhi"
  • "UnitSymbol.W"
  • "UnitSymbol.count"
  • "UnitSymbol.PaPers"
  • "UnitSymbol.onePerHz"
  • "UnitSymbol.m3Pers"
  • "UnitSymbol.KPers"
  • "UnitSymbol.Vs"
  • "UnitSymbol.m2Pers"
  • "UnitSymbol.Ah"
  • "UnitSymbol.deg"
  • "UnitSymbol.mPers2"
  • "UnitSymbol.lm"
  • "UnitSymbol.d"
  • "UnitSymbol.JPerkgK"
  • "UnitSymbol.m"
  • "UnitSymbol.min"
  • "UnitSymbol.dB"
  • "UnitSymbol.Gy"
  • "UnitSymbol.Nm"
  • "UnitSymbol.JPerm3"
  • "UnitSymbol.sPers"
  • "UnitSymbol.Q"
  • "UnitSymbol.rev"
  • "UnitSymbol.N"
  • "UnitSymbol.Bq"
  • "UnitSymbol.WPermK"
  • "UnitSymbol.GyPers"
  • "UnitSymbol.HPerm"
  • "UnitSymbol.molPerkg"
  • "UnitSymbol.molPerm3"
  • "UnitSymbol.Wb"
  • "UnitSymbol.VPerm"
  • "UnitSymbol.WPerm2"
  • "UnitSymbol.kn"
  • "UnitSymbol.CPerm2"
  • "UnitSymbol.anglemin"
  • "UnitSymbol.Oe"
  • "UnitSymbol.kgm"
  • "UnitSymbol.character"
  • "UnitSymbol.APerA"
  • "UnitSymbol.A2s"
  • "UnitSymbol.Qh"
  • "UnitSymbol.JPers"
  • "UnitSymbol.Hz"
  • "UnitSymbol.rad"
  • "UnitSymbol.kat"
  • "UnitSymbol.degC"
  • "UnitSymbol.bar"
  • "UnitSymbol.M"
  • "UnitSymbol.molPermol"
  • "UnitSymbol.kgPerJ"
  • "UnitSymbol.J"
  • "UnitSymbol.HzPers"
  • "UnitSymbol.WPersr"
  • "UnitSymbol.anglesec"
  • "UnitSymbol.F"
  • "UnitSymbol.Mx"
  • "UnitSymbol.ha"
  • "UnitSymbol.SPerm"
  • "UnitSymbol.gal"
  • "UnitSymbol.mmHg"
  • "UnitSymbol.m2"
  • "UnitSymbol.mPers"
  • "UnitSymbol.V2h"
  • "UnitSymbol.m3"
  • "UnitSymbol.G"
  • "UnitSymbol.H"
  • "UnitSymbol.mol"
  • "UnitSymbol.rotPers"
  • "UnitSymbol.VAh"
  • "UnitSymbol.mPerm3"
  • "UnitSymbol.onePerm"
  • "UnitSymbol.V2"
  • "UnitSymbol.WPerA"
  • "UnitSymbol.Pa"
  • "UnitSymbol.kgPerm3"
  • "UnitSymbol.CPerm3"
  • "UnitSymbol.Sv"
  • "UnitSymbol.S"
  • "UnitSymbol.JPermolK"
  • "UnitSymbol.ft3"
  • "UnitSymbol.Wh"
  • "UnitSymbol.radPers"
  • "UnitSymbol.ohmm"
  • "UnitSymbol.kgm2"
  • "UnitSymbol.m3Perh"
  • "UnitSymbol.dBm"
  • "UnitSymbol.VA"
  • "UnitSymbol.A2"
  • "UnitSymbol.s"
  • "UnitSymbol.therm"
  • "UnitSymbol.VArh"
  • "UnitSymbol.cd"
  • "UnitSymbol.VPerV"
  • "UnitSymbol.gPerg"
  • "UnitSymbol.kg"
  • "UnitSymbol.A"
  • "UnitSymbol.m3Uncompensated"
  • "UnitSymbol.ppm"
  • "UnitSymbol.FPerm"
  • "UnitSymbol.C"
  • "UnitSymbol.sr"
  • "UnitSymbol.none"
  • "UnitSymbol.VPerVAr"
  • "UnitSymbol.VAr"
  • "UnitSymbol.VPerVA"
  • "UnitSymbol.lPers"

cimObjectType

Type: enum (of string)

Used in RAVENS Schema to identify the corresponding CIM Object Type of the JSON object.

Must be one of:

  • "SvPowerFlow"

Circuit_Pointer

Type: string

Pointer to Circuit object

Must match regular expression: ^Circuit::'(.+)'$

ConnectivityNode_Pointer

Type: string

Pointer to ConnectivityNode object

Must match regular expression: ^ConnectivityNode::'(.+)'$

TopologicalNode_Pointer

Type: string

Pointer to TopologicalNode object

Must match regular expression: ^TopologicalNode::'(.+)'$

connected

Type: boolean

The connected status is related to a bus-branch model and the topological node to terminal relation. True implies the terminal is connected to the related topological node and false implies it is not.
In a bus-branch model, the connected status is used to tell if equipment is disconnected without having to change the connectivity described by the topological node to terminal relation. A valid case is that conducting equipment can be connected in one end and open in the other. In particular for an AC line segment, where the reactive line charging can be significant, this is a relevant case.

phases

Type: enum (of string)

Represents the normal network phasing condition. If the attribute is missing, three phases (ABC) shall be assumed, except for terminals of grounding classes (specializations of EarthFaultCompensator, GroundDisconnector, and Ground) which will be assumed to be N. Therefore, phase code ABCN is explicitly declared when needed, e.g. for star point grounding equipment.
The phase code on terminals connecting same ConnectivityNode or same TopologicalNode as well as for equipment between two terminals shall be consistent.

Must be one of:

  • "PhaseCode.ACN"
  • "PhaseCode.s2N"
  • "PhaseCode.N"
  • "PhaseCode.X"
  • "PhaseCode.BN"
  • "PhaseCode.s12N"
  • "PhaseCode.none"
  • "PhaseCode.s1"
  • "PhaseCode.AC"
  • "PhaseCode.ABC"
  • "PhaseCode.AB"
  • "PhaseCode.s1N"
  • "PhaseCode.BC"
  • "PhaseCode.XY"
  • "PhaseCode.ABCN"
  • "PhaseCode.C"
  • "PhaseCode.s12"
  • "PhaseCode.AN"
  • "PhaseCode.XYN"
  • "PhaseCode.ABN"
  • "PhaseCode.XN"
  • "PhaseCode.s2"
  • "PhaseCode.CN"
  • "PhaseCode.B"
  • "PhaseCode.A"
  • "PhaseCode.BCN"

sequenceNumber

Type: integer

The orientation of the terminal connections for a multiple terminal conducting equipment. The sequence numbering starts with 1 and additional terminals should follow in increasing order. The first terminal is the "starting point" for a two terminal branch.

cimObjectType

Type: enum (of string)

Used in RAVENS Schema to identify the corresponding CIM Object Type of the JSON object.

Must be one of:

  • "Terminal"

description

Type: 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.

aliasName

Type: 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.

mRID

Type: 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

Type: string

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

cimObjectType

Type: enum (of string)

Used in RAVENS Schema to identify the corresponding CIM Object Type of the JSON object.

Must be one of:

  • "TapChangerControl"

limitVoltage

Type: Voltage

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

lineDropCompensation

Type: boolean

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

lineDropR

Type: Resistance

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

lineDropX

Type: Reactance

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

reverseLineDropR

Type: Resistance

Line drop compensator resistance setting for reverse power flow.

reverseLineDropX

Type: Reactance

Line drop compensator reactance setting for reverse power flow.

description

Type: 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

Type: boolean

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

mode

Type: 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

Type: PhaseCode

Phase voltage controlling this regulator, measured at regulator location.

targetDeadband

Type: number

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

Type: number

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

Type: UnitMultiplier

Specify the multiplier for used for the targetValue.

enabled

Type: boolean

The flag tells if regulation is enabled.

maxAllowedTargetValue

Type: number

Maximum allowed target value (RegulatingControl.targetValue).

minAllowedTargetValue

Type: number

Minimum allowed target value (RegulatingControl.targetValue).

aliasName

Type: 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.

mRID

Type: 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

Type: string

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

TapChangerRatio

Type: object
No Additional Properties

cimObjectType

Type: enum (of string)

Used in RAVENS Schema to identify the corresponding CIM Object Type of the JSON object.

Must be one of:

  • "TapChangerRatio"

ptRatio

Type: number

Ratio of the PT that converts the controlled voltage to the regulator voltage. Default is 60.

ctRatio

Type: number

Ratio of the CT from line amps to control ampere setting for current and kvar control types.

description

Type: 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.

aliasName

Type: 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.

mRID

Type: 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

Type: string

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

SvTapStep

Type: object

State variable for transformer tap step.

No Additional Properties

position

Type: number

The floating point tap position. This is not the tap ratio, but rather the tap step position as defined by the related tap changer model and normally is constrained to be within the range of minimum and maximum tap positions.

cimObjectType

Type: enum (of string)

Used in RAVENS Schema to identify the corresponding CIM Object Type of the JSON object.

Must be one of:

  • "SvTapStep"

tculControlMode

Type: TransformerControlMode

Specifies the regulation control mode (voltage or reactive) of the RatioTapChanger.

controlEnabled

Type: boolean

Specifies the regulation status of the equipment. True is regulating, false is not regulating.

initialDelay

Type: Seconds

For an LTC, the delay for initial tap changer operation (first step change).

lowStep

Type: integer

Lowest possible tap step position, retard from neutral.

ltcFlag

Type: boolean

Specifies whether or not a TapChanger has load tap changing capabilities.

neutralStep

Type: integer

The neutral tap step position for this winding.
The attribute shall be equal to or greater than lowStep and equal or less than highStep.
It is the step position where the voltage is neutralU when the other terminals of the transformer are at the ratedU. If there are other tap changers on the transformer those taps are kept constant at their neutralStep.

neutralU

Type: Voltage

Voltage at which the winding operates at the neutral tap setting. It is the voltage at the terminal of the PowerTransformerEnd associated with the tap changer when all tap changers on the transformer are at their neutralStep position. Normally neutralU of the tap changer is the same as ratedU of the PowerTransformerEnd, but it can differ in special cases such as when the tapping mechanism is separate from the winding more common on lower voltage transformers.
This attribute is not relevant for PhaseTapChangerAsymmetrical, PhaseTapChangerSymmetrical and PhaseTapChangerLinear.

normalStep

Type: integer

The tap step position used in "normal" network operation for this winding. For a "Fixed" tap changer indicates the current physical tap setting.
The attribute shall be equal to or greater than lowStep and equal to or less than highStep.

highStep

Type: integer

Highest possible tap step position, advance from neutral.
The attribute shall be greater than lowStep.

subsequentDelay

Type: Seconds

For an LTC, the delay for subsequent tap changer operation (second and later step changes).

cimObjectType

Type: enum (of string)

Used in RAVENS Schema to identify the corresponding CIM Object Type of the JSON object.

Must be one of:

  • "RatioTapChanger"

step

Type: number

Tap changer position.
Starting step for a steady state solution. Non integer values are allowed to support continuous tap variables. The reasons for continuous value are to support study cases where no discrete tap changer has yet been designed, a solution where a narrow voltage band forces the tap step to oscillate or to accommodate for a continuous solution as input.
The attribute shall be equal to or greater than lowStep and equal to or less than highStep.

stepVoltageIncrement

Type: PerCent

Tap step increment, in per cent of rated voltage of the power transformer end, per step position.
When the increment is negative, the voltage decreases when the tap step increases.

description

Type: 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.

aliasName

Type: 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.

mRID

Type: 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

Type: string

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