A unit with valves for three phases, together with unit control equipment, essential protective and switching devices, DC storage capacitors, phase reactors and auxiliaries, if any, used for conversion.
No Additional PropertiesHash table of VsConverter objects
No Additional PropertiesAll properties whose name matches the following regular expression must respect the following conditions
Property name regular expression:^.+$ DC side of the voltage source converter (VSC).
No Additional PropertiesPointer to Location object
Pointer to SwitchingAction object
Array of Terminal objects
No Additional ItemsAn AC electrical connection point to a piece of conducting equipment. Terminals are connected at physical connection points called connectivity nodes.
No Additional PropertiesThe 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.
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.
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.
Used in RAVENS Schema to identify the corresponding CIM Object Type of the JSON object.
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.
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.
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.
The name is any free human readable and possibly non unique text naming the object.
Pointer to BaseVoltage object
Array of SvStatus objects
No Additional ItemsState variable for status.
No Additional PropertiesThe 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.
The individual phase status. If the attribute is unspecified, then three phase model is assumed.
The maximum current through a valve. It is converter’s configuration data.
nan
nan
nan
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.
nan
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.
nan
Used in RAVENS Schema to identify the corresponding CIM Object Type of the JSON object.
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.
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.
nan
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.
The equipment is enabled to participate in network analysis. If unspecified, the value is assumed to be true.
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.minUdcSpecifies 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.
Kind of control of real power and/or DC voltage.
Base apparent power of the converter pole. The attribute shall be a positive value.
nan
Switching losses, relative to the base apparent power 'baseS'. Refer to poleLossP. The attribute shall be a positive value.
nan
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.
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.pReactive 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.qTarget value for DC voltage magnitude. The attribute shall be a positive value.
Same definition as ACDCConverter.minUdcVoltage target in AC grid, at point of common coupling. The attribute shall be a positive value.
Same definition as ACDCConverter.minUdcCompensation constant. Used to compensate for voltage drop when controlling voltage at a distant bus. The attribute shall be a positive value.
nan
Droop constant. The pu value is obtained as D [kV/MW] x Sb / Ubdc. The attribute shall be a positive value.
nan
Kind of reactive power control.
The maximum quotient between the AC converter voltage (Uc) and DC voltage (Ud). A factor typically less than 1. It is converter’s configuration data used in power flow.
Number of valves in the converter. Used in loss calculations.
Angle between VsConverter.uv and ACDCConverter.uc. It is converter’s state variable used in power flow. The attribute shall be a positive value or zero.
nan
Converter DC current, also called Id. It is converter’s state variable, result from power flow.
Same definition as VsConverter.maxValveCurrentValve 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.minUdcActive 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.pThe 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.minUdcPower factor target at the AC side, at point of common coupling. The attribute shall be a positive value.
Phase target at AC side, at point of common coupling. The attribute shall be a positive value.
Same definition as VsConverter.deltaMagnitude of pulse-modulation factor. The attribute shall be a positive value.
Maximum active power limit. The value is overwritten by values of VsCapabilityCurve, if present.
Same definition as ACDCConverter.pMinimum active power limit. The value is overwritten by values of VsCapabilityCurve, if present.
Same definition as ACDCConverter.pIt is converter’s configuration data used in power flow. Refer to poleLossP. The attribute shall be a positive value.
Same definition as VsConverter.droopCompensationThe 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.
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.minUdcConverter 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.minUdcLine-to-line voltage on the valve side of the converter transformer. It is converter’s state variable, result from power flow. The attribute shall be a positive value.
Same definition as ACDCConverter.minUdcThe 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.
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.
The name is any free human readable and possibly non unique text naming the object.
Hash table of CsConverter objects
No Additional PropertiesAll properties whose name matches the following regular expression must respect the following conditions
Property name regular expression:^.+$ 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.
Pointer to Location object
Pointer to SwitchingAction object
Pointer to BaseVoltage object
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.
Same definition as VsConverter.deltaExtinction 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 VsConverter.deltaMaximum firing angle. It is converter’s configuration data used in power flow. The attribute shall be a positive value.
Same definition as VsConverter.deltaMaximum extinction angle. It is converter’s configuration data used in power flow. The attribute shall be a positive value.
Same definition as VsConverter.deltaMinimum firing angle. It is converter’s configuration data used in power flow. The attribute shall be a positive value.
Same definition as VsConverter.deltaMinimum extinction angle. It is converter’s configuration data used in power flow. The attribute shall be a positive value.
Same definition as VsConverter.deltaTarget 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 VsConverter.deltaTarget 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 VsConverter.deltaDC current target value. It is converter’s control variable used in power flow. The attribute shall be a positive value.
Same definition as VsConverter.maxValveCurrentThe 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 VsConverter.maxValveCurrentIndicates whether the DC pole is operating as an inverter or as a rectifier. It is converter’s control variable used in power flow.
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.
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.
Used in RAVENS Schema to identify the corresponding CIM Object Type of the JSON object.
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.
Minimum active power limit. The value is overwritten by values of VsCapabilityCurve, if present.
Same definition as ACDCConverter.pThe 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.
The equipment is enabled to participate in network analysis. If unspecified, the value is assumed to be true.
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.minUdcSpecifies 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.
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.
Base apparent power of the converter pole. The attribute shall be a positive value.
Same definition as ACDCConverter.baseSSwitching losses, relative to the base apparent power 'baseS'. Refer to poleLossP. The attribute shall be a positive value.
Same definition as ACDCConverter.switchingLossSpecifies 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.
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.pTarget value for DC voltage magnitude. The attribute shall be a positive value.
Same definition as ACDCConverter.minUdcValve 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.minUdcNumber of valves in the converter. Used in loss calculations.
Converter DC current, also called Id. It is converter’s state variable, result from power flow.
Same definition as VsConverter.maxValveCurrentActive 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.pThe 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 VsConverter.maxValveCurrentThe 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.minUdcThe 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.minUdcThe 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.
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 VsConverter.maxValveCurrentMaximum active power limit. The value is overwritten by values of VsCapabilityCurve, if present.
Same definition as ACDCConverter.pIt is converter’s configuration data used in power flow. Refer to poleLossP. The attribute shall be a positive value.
Same definition as VsConverter.droopCompensationLine-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.minUdcConverter 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.minUdcThe 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.
Kind of active power control.
The name is any free human readable and possibly non unique text naming the object.