CsConverter

Type: object

DC side of the current source converter (CSC).
The firing angle controls the dc voltage at the converter, both for rectifier and inverter. The difference between the dc voltages of the rectifier and inverter determines the dc current. The extinction angle is used to limit the dc voltage at the inverter, if needed, and is not used in active power control. The firing angle, transformer tap position and number of connected filters are the primary means to control a current source dc line. Higher level controls are built on top, e.g. dc voltage, dc current and active power. From a steady state perspective it is sufficient to specify the wanted active power transfer (ACDCConverter.targetPpcc) and the control functions will set the dc voltage, dc current, firing angle, transformer tap position and number of connected filters to meet this. Therefore attributes targetAlpha and targetGamma are not applicable in this case.
The reactive power consumed by the converter is a function of the firing angle, transformer tap position and number of connected filter, which can be approximated with half of the active power. The losses is a function of the dc voltage and dc current.
The attributes minAlpha and maxAlpha define the range of firing angles for rectifier operation between which no discrete tap changer action takes place. The range is typically 10-18 degrees.
The attributes minGamma and maxGamma define the range of extinction angles for inverter operation between which no discrete tap changer action takes place. The range is typically 17-20 degrees.

Type: string

Type: array

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

No Additional Items

Each item of this array must be:

Type: object

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

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.

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:

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

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.

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.

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.

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.

Type: string

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

Type: array

State variable for status.

No Additional Items

Each item of this array must be:

Type: object

State variable for status.

Type: boolean

The in service status as a result of topology processing. It indicates if the equipment is considered as energized by the power flow. It reflects if the equipment is connected within a solvable island. It does not necessarily reflect whether or not the island was solved by the power flow.

Type: enum (of string)

The individual phase status. If the attribute is unspecified, then three phase model is assumed.

Must be one of:

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

Type: object or number

Firing angle that determines the dc voltage at the converter dc terminal. Typical value between 10 degrees and 18 degrees for a rectifier. It is converter’s state variable, result from power flow. The attribute shall be a positive value.

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

nan

Must be one of:

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

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

nan

Must be one of:

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

Type: number Default: null

nan

Type: object or number

Extinction angle. It is used to limit the dc voltage at the inverter if needed. Typical value between 17 degrees and 20 degrees for an inverter. It is converter’s state variable, result from power flow. The attribute shall be a positive value.

Same definition as CsConverter.alpha

Type: object or number

Maximum firing angle. It is converter’s configuration data used in power flow. The attribute shall be a positive value.

Same definition as CsConverter.alpha

Type: object or number

Maximum extinction angle. It is converter’s configuration data used in power flow. The attribute shall be a positive value.

Same definition as CsConverter.alpha

Type: object or number

Minimum firing angle. It is converter’s configuration data used in power flow. The attribute shall be a positive value.

Same definition as CsConverter.alpha

Type: object or number

Minimum extinction angle. It is converter’s configuration data used in power flow. The attribute shall be a positive value.

Same definition as CsConverter.alpha

Type: object or number

Target firing angle. It is converter’s control variable used in power flow. It is only applicable for rectifier if continuous tap changer control is used. Allowed values are within the range minAlpha<=targetAlpha<=maxAlpha. The attribute shall be a positive value.

Same definition as CsConverter.alpha

Type: object or number

Target extinction angle. It is converter’s control variable used in power flow. It is only applicable for inverter if continuous tap changer control is used. Allowed values are within the range minGamma<=targetGamma<=maxGamma. The attribute shall be a positive value.

Same definition as CsConverter.alpha

Type: object or number

DC current target value. It is converter’s control variable used in power flow. The attribute shall be a positive value.

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

nan

Same definition as multiplier

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

nan

Same definition as unit

Type: number Default: null

nan

Type: object or number

The minimum direct current (Id) on the DC side at which the converter should operate. It is converter’s configuration data used in power flow. The attribute shall be a positive value.

Same definition as CsConverter.targetIdc

Type: enum (of string)

Indicates whether the DC pole is operating as an inverter or as a rectifier. It is converter’s control variable used in power flow.

Must be one of:

  • "inverter"
  • "rectifier"

Type: object or number

Active power at the point of common coupling. Load sign convention is used, i.e. positive sign means flow out from a node.
Starting value for a steady state solution in the case a simplified power flow model is used.

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

nan

Same definition as multiplier

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

nan

Same definition as unit

Type: number Default: null

nan

Type: object or number

Reactive power at the point of common coupling. Load sign convention is used, i.e. positive sign means flow out from a node.
Starting value for a steady state solution in the case a simplified power flow model is used.

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

nan

Same definition as multiplier

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

nan

Same definition as unit

Type: number Default: null

nan

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.

Type: object or number

Minimum active power limit. The value is overwritten by values of VsCapabilityCurve, if present.

Same definition as ACDCConverter.p

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

Type: boolean

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

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

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.

Type: object or number

Base apparent power of the converter pole. The attribute shall be a positive value.

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

nan

Same definition as multiplier

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

nan

Same definition as unit

Type: number Default: null

nan

Type: object or number

Switching losses, relative to the base apparent power 'baseS'. Refer to poleLossP. The attribute shall be a positive value.

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

nan

Same definition as multiplier

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

nan

Same definition as unit

Type: number Default: null

nan

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

Type: object or number

Real power injection target in AC grid, at point of common coupling. Load sign convention is used, i.e. positive sign means flow out from a node.

Same definition as ACDCConverter.p

Type: object or number

Target value for DC voltage magnitude. The attribute shall be a positive value.

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

nan

Same definition as multiplier

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

nan

Same definition as unit

Type: number Default: null

nan

Type: object or number

Valve threshold voltage, also called Uvalve. Forward voltage drop when the valve is conducting. Used in loss calculations, i.e. the switchLoss depend on numberOfValves * valveU0.

Same definition as ACDCConverter.targetUdc

Type: integer

Number of valves in the converter. Used in loss calculations.

Type: object or number

Converter DC current, also called Id. It is converter’s state variable, result from power flow.

Same definition as CsConverter.targetIdc

Type: object or number

Active power loss in pole at no power transfer. It is converter’s configuration data used in power flow. The attribute shall be a positive value.

Same definition as ACDCConverter.p

Type: object or number

The maximum direct current (Id) on the DC side at which the converter should operate. It is converter’s configuration data use in power flow. The attribute shall be a positive value.

Same definition as CsConverter.targetIdc

Type: object or number

The maximum voltage on the DC side at which the converter should operate. It is converter’s configuration data used in power flow. The attribute shall be a positive value.

Same definition as ACDCConverter.targetUdc

Type: object or number

The minimum voltage on the DC side at which the converter should operate. It is converter’s configuration data used in power flow. The attribute shall be a positive value.

Same definition as ACDCConverter.targetUdc

Type: object or number

The active power loss at a DC Pole
= idleLoss + switchingLoss|Idc| + resitiveLossIdc^2.
For lossless operation Pdc=Pac.
For rectifier operation with losses Pdc=Pac-lossP.
For inverter operation with losses Pdc=Pac+lossP.
It is converter’s state variable used in power flow. The attribute shall be a positive value.

Same definition as ACDCConverter.p

Type: object or number

Rated converter DC current, also called IdN. The attribute shall be a positive value. It is converter’s configuration data used in power flow.

Same definition as CsConverter.targetIdc

Type: object or number

Rated converter DC voltage, also called UdN. The attribute shall be a positive value. It is converter’s configuration data used in power flow. For instance a bipolar HVDC link with value 200 kV has a 400kV difference between the dc lines.

Same definition as ACDCConverter.targetUdc

Type: object or number

It is converter’s configuration data used in power flow. Refer to poleLossP. The attribute shall be a positive value.

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

nan

Same definition as multiplier

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

nan

Same definition as unit

Type: number Default: null

nan

Type: object or number

Maximum active power limit. The value is overwritten by values of VsCapabilityCurve, if present.

Same definition as ACDCConverter.p

Type: object or number

Line-to-line converter voltage, the voltage at the AC side of the valve. It is converter’s state variable, result from power flow. The attribute shall be a positive value.

Same definition as ACDCConverter.targetUdc

Type: object or number

Converter voltage at the DC side, also called Ud. It is converter’s state variable, result from power flow. The attribute shall be a positive value.

Same definition as ACDCConverter.targetUdc

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.

Type: enum (of string)

Kind of active power control.

Must be one of:

  • "activePower"
  • "dcVoltage"
  • "dcCurrent"

Type: string

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