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

root Ravens.CimObjectType
Type: string

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

root TapChangerControl.limitVoltage
Type: object or number

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

root TapChangerControl.limitVoltage multiplier
Type: enum (of string) Default: "none"

nan

Must be one of:

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

root TapChangerControl.limitVoltage unit
Type: enum (of string) Default: "V"

nan

Must be one of:

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

root TapChangerControl.limitVoltage value
Type: number Default: null

nan

root TapChangerControl.lineDropCompensation
Type: boolean

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

root TapChangerControl.lineDropR
Type: object or number

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

root TapChangerControl.lineDropR multiplier
Type: enum (of string) Default: "none"

nan

Same definition as multiplier

root TapChangerControl.lineDropR unit
Type: enum (of string) Default: "ohm"

nan

Same definition as unit

root TapChangerControl.lineDropR value
Type: number Default: null

nan

root TapChangerControl.lineDropX
Type: object or number

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

root TapChangerControl.lineDropX value
Type: number Default: null

nan

root TapChangerControl.lineDropX multiplier
Type: enum (of string) Default: "none"

nan

Same definition as multiplier

root TapChangerControl.lineDropX unit
Type: enum (of string) Default: "ohm"

nan

Same definition as unit

root TapChangerControl.reverseLineDropR
Type: object or number

Line drop compensator resistance setting for reverse power flow.

Same definition as TapChangerControl.lineDropR

root TapChangerControl.reverseLineDropX
Type: object or number

Line drop compensator reactance setting for reverse power flow.

Same definition as TapChangerControl.lineDropX

root IdentifiedObject.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.

root RegulatingControl.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.

root RegulatingControl.mode
Type: enum (of string)

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

Must be one of:

  • "activePower"
  • "timeScheduled"
  • "voltage"
  • "admittance"
  • "temperature"
  • "reactivePower"
  • "powerFactor"
  • "currentFlow"

root RegulatingControl.monitoredPhase
Type: enum (of string)

Phase voltage controlling this regulator, measured at regulator location.

Must be one of:

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

root RegulatingControl.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.

root RegulatingControl.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.

root RegulatingControl.targetValueUnitMultiplier
Type: enum (of string)

Specify the multiplier for used for the targetValue.

Same definition as multiplier

root RegulatingControl.enabled
Type: boolean

The flag tells if regulation is enabled.

root RegulatingControl.maxAllowedTargetValue
Type: number

Maximum allowed target value (RegulatingControl.targetValue).

root RegulatingControl.minAllowedTargetValue
Type: number

Minimum allowed target value (RegulatingControl.targetValue).

root IdentifiedObject.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.

root IdentifiedObject.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.

root IdentifiedObject.name
Type: string

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