TwoTerminalVSCLine

Package: PowerOperationsOpenAPIModels · Source: Operations/Branch/TwoTerminalVSCLine.json

A High Voltage Voltage-Source Converter DC line, which must be connected to an ACBus on each end. This model is appropriate for operational simulations with a linearized DC power flow approximation with losses using a voltage-current model. For modeling a DC network, see TModelHVDCLine.

Properties

Property	Type	Required	Unit	Description
`id`	`integer`	yes	—	Unique integer identifier for this component.
`name`	`string`	yes	—	Name of the component. Components of the same type (e.g., `PowerLoad`) must have unique names, but components of different types (e.g., `PowerLoad` and `ACBus`) can have the same name.
`available`	`boolean`	yes	—	Indicator of whether the component is connected and online (`true`) or disconnected, offline, or down (`false`). Unavailable components are excluded during simulations.
`arc`	`integer`	yes	—	An Arc defining this line `from` a bus `to` another bus.
`active_power_flow`	`number`	yes	`MW / pu (by power_units)`	Initial condition of active power flowing from the from-bus to the to-bus in DC. Units: per power_units — NATURAL_UNITS: MW, COMPONENT_BASE: pu .
`rating`	`number`	yes	`MVA / pu (by power_units)`	Maximum output power rating of the converter. Units: per power_units — NATURAL_UNITS: MVA, COMPONENT_BASE: pu .
`active_power_limits_from`	`MinMax`	yes	`MW / pu (by power_units)`	Minimum and maximum active power flows to the FROM node. Units: per power_units — NATURAL_UNITS: MW, COMPONENT_BASE: pu .
`active_power_limits_to`	`MinMax`	yes	`MW / pu (by power_units)`	Minimum and maximum active power flows to the TO node. Units: per power_units — NATURAL_UNITS: MW, COMPONENT_BASE: pu .
`admittance_units`	`string (AdmittanceUnitBasis)`	—	—	Unit basis for the series conductance g.
`g`	`number`	—	`S / MW / pu (by admittance_units)`	Series conductance of the DC line. Units: per admittance_units — NATURAL_UNITS: S, COMPONENT_MVAR: MW, COMPONENT_BASE: pu .
`dc_current`	`number`	—	`A`	DC current on the converter flowing in the DC line, from `from` bus to `to` bus. Units: A.
`reactive_power_from`	`number`	—	`MVAr / pu (by power_units)`	Initial condition of reactive power flowing into the from-bus. Units: per power_units — NATURAL_UNITS: MVAr, COMPONENT_BASE: pu .
`dc_control_from`	`string (VSCDCControlModes)`	—	—	DC-side control mode of the `from` converter.
`ac_control_from`	`string (VSCACControlModes)`	—	—	AC-side control mode of the `from` converter.
`setpoint_voltage_units`	`string (VoltageUnitBasis)`	—	—	Unit basis for the DC_VOLTAGE/DC_VOLTAGE_DROOP/AC_VOLTAGE branches of dc_setpoint_from/to and ac_setpoint_from/to. Independent of voltage_units, which covers voltage_limits_from/to only.
`dc_setpoint_from`	`number`	—	`MW / (kV / pu by setpoint_voltage_units) / (kV / pu by setpoint_voltage_units) (by dc_control_from)`	Converter DC setpoint in the `from` bus converter. When `dc_control_from` regulates DC voltage this number is the DC voltage on the DC side of the converter; when it controls DC power this value is the power demand in MW, if positive the converter is supplying power to the AC network at the `from` bus; if negative, the converter is withdrawing power from the AC network at the `from` bus. Units: per dc_control_from — DC_POWER: MW, DC_VOLTAGE: (per setpoint_voltage_units — NATURAL_UNITS: kV, COMPONENT_BASE: pu), DC_VOLTAGE_DROOP: (per setpoint_voltage_units — NATURAL_UNITS: kV, COMPONENT_BASE: pu) .
`ac_setpoint_from`	`number`	—	`1 / (kV / pu by setpoint_voltage_units) (by ac_control_from)`	Converter AC setpoint in the `from` bus converter. When `ac_control_from` regulates AC voltage this number is the AC voltage on the AC side of the converter; when it controls reactive power this value is the power factor setpoint. Units: per ac_control_from — AC_REACTIVE_POWER: 1, AC_VOLTAGE: (per setpoint_voltage_units — NATURAL_UNITS: kV, COMPONENT_BASE: pu) .
`rated_ac_voltage_from`	`number`	—	`kV`	Rated (base) AC voltage at the `from` converter’s AC terminal in kV. Used as the AC voltage base for interpreting ac_setpoint_from when ac_control_from is AC_VOLTAGE; 0.0 means unspecified (the setpoint is taken as per-unit directly). Units: kV.
`converter_loss_from`	`LossCurve`	—	—	Loss model coefficients in the `from` bus converter. It accepts a linear model or quadratic. Same converter data is used in both ends.
`max_dc_current_from`	`number`	—	`A`	Maximum stable dc current limits. Units: A.
`rating_from`	`number`	—	`MVA / pu (by power_units)`	Converter rating in the `from` bus. Units: per power_units — NATURAL_UNITS: MVA, COMPONENT_BASE: pu .
`reactive_power_limits_from`	`MinMax`	—	`MVAr / pu (by power_units)`	Limits on the Reactive Power at the `from` side. Units: per power_units — NATURAL_UNITS: MVAr, COMPONENT_BASE: pu .
`power_factor_weighting_fraction_from`	`number`	—	`1`	Power weighting factor fraction used in reducing the active power order and either the reactive power order when the converter rating is violated. When is 0.0, only the active power is reduced; when is 1.0, only the reactive power is reduced; otherwise, a weighted reduction of both active and reactive power is applied. Units: 1.
`voltage_units`	`string (VoltageUnitBasis)`	—	—	Unit basis for the DC bus voltage limits (voltage_limits_from/to only). Independent of setpoint_voltage_units, which covers dc_setpoint_from/to and ac_setpoint_from/to.
`voltage_limits_from`	`MinMax`	—	`kV / pu (by voltage_units)`	Limits on the Voltage at the DC `from` Bus in kV. The DC base voltage is the `dc_setpoint` of the converter with `dc_voltage_control` enabled; exactly one converter must control the DC voltage. Units: kV. Units: per voltage_units — NATURAL_UNITS: kV, COMPONENT_BASE: pu .
`dc_voltage_droop_from`	`number`	—	`pu`	DC-voltage droop gain on the `from` converter, used when `dc_control_from` is `DC_VOLTAGE_DROOP`: `V_dc = dc_setpoint_from - dc_voltage_droop_from * P_c`. Units: pu.
`reactive_power_to`	`number`	—	`MVAr / pu (by power_units)`	Initial condition of reactive power flowing into the to-bus. Units: per power_units — NATURAL_UNITS: MVAr, COMPONENT_BASE: pu .
`dc_control_to`	`string (VSCDCControlModes)`	—	—	DC-side control mode of the `to` converter.
`ac_control_to`	`string (VSCACControlModes)`	—	—	AC-side control mode of the `to` converter.
`dc_setpoint_to`	`number`	—	`MW / (kV / pu by setpoint_voltage_units) / (kV / pu by setpoint_voltage_units) (by dc_control_to)`	Converter DC setpoint in the `to` bus converter. When `dc_control_to` regulates DC voltage this number is the DC voltage on the DC side of the converter; when it controls DC power this value is the power demand in MW, if positive the converter is supplying power to the AC network at the `to` bus; if negative, the converter is withdrawing power from the AC network at the `to` bus. Units: per dc_control_to — DC_POWER: MW, DC_VOLTAGE: (per setpoint_voltage_units — NATURAL_UNITS: kV, COMPONENT_BASE: pu), DC_VOLTAGE_DROOP: (per setpoint_voltage_units — NATURAL_UNITS: kV, COMPONENT_BASE: pu) .
`ac_setpoint_to`	`number`	—	`1 / (kV / pu by setpoint_voltage_units) (by ac_control_to)`	Converter AC setpoint in the `to` bus converter. When `ac_control_to` regulates AC voltage this number is the AC voltage on the AC side of the converter; when it controls reactive power this value is the power factor setpoint. Units: per ac_control_to — AC_REACTIVE_POWER: 1, AC_VOLTAGE: (per setpoint_voltage_units — NATURAL_UNITS: kV, COMPONENT_BASE: pu) .
`rated_ac_voltage_to`	`number`	—	`kV`	Rated (base) AC voltage at the `to` converter’s AC terminal in kV. Used as the AC voltage base for interpreting ac_setpoint_to when ac_control_to is AC_VOLTAGE; 0.0 means unspecified (the setpoint is taken as per-unit directly). Units: kV.
`converter_loss_to`	`LossCurve`	—	—	Loss model coefficients in the `to` bus converter. It accepts a linear model or quadratic. Same converter data is used in both ends.
`max_dc_current_to`	`number`	—	`A`	Maximum stable dc current limits. Units: A.
`rating_to`	`number`	—	`MVA / pu (by power_units)`	Converter rating in the `to` bus. Units: per power_units — NATURAL_UNITS: MVA, COMPONENT_BASE: pu .
`reactive_power_limits_to`	`MinMax`	—	`MVAr / pu (by power_units)`	Limits on the Reactive Power at the `to` side. Units: per power_units — NATURAL_UNITS: MVAr, COMPONENT_BASE: pu .
`power_factor_weighting_fraction_to`	`number`	—	`1`	Power weighting factor fraction used in reducing the active power order and either the reactive power order when the converter rating is violated. When is 0.0, only the active power is reduced; when is 1.0, only the reactive power is reduced; otherwise, a weighted reduction of both active and reactive power is applied. Units: 1.
`voltage_limits_to`	`MinMax`	—	`kV / pu (by voltage_units)`	Limits on the Voltage at the DC `to` Bus in kV. The DC base voltage is the `dc_setpoint` of the converter with `dc_voltage_control` enabled; exactly one converter must control the DC voltage. Units: kV. Units: per voltage_units — NATURAL_UNITS: kV, COMPONENT_BASE: pu .
`dc_voltage_droop_to`	`number`	—	`pu`	DC-voltage droop gain on the `to` converter, used when `dc_control_to` is `DC_VOLTAGE_DROOP`: `V_dc = dc_setpoint_to - dc_voltage_droop_to * P_c`. Units: pu.
`rated_dc_voltage`	`number`	—	`kV`	Rated (base) DC voltage of the link in kV. Used as the DC voltage base for interpreting DC-voltage setpoints; 0.0 means unspecified (DC-voltage setpoints are taken as per-unit directly). Units: kV.
`remote_bus_control_from`	`integer or null`	—	—	Number of the AC bus whose voltage the `from` converter regulates when `ac_control_from` is `AC_VOLTAGE`; null regulates its own terminal bus.
`remote_bus_control_to`	`integer or null`	—	—	Number of the AC bus whose voltage the `to` converter regulates when `ac_control_to` is `AC_VOLTAGE`; null regulates its own terminal bus.
`rmpct_from`	`number`	—	`1`	Percent of the total Mvar required to hold the voltage at the bus regulated by the `from` converter that is contributed by this converter. Units: 1.
`rmpct_to`	`number`	—	`1`	Percent of the total Mvar required to hold the voltage at the bus regulated by the `to` converter that is contributed by this converter. Units: 1.
`base_power`	`number`	yes	`MVA`	System base power for per-unitization of this component’s per-unit fields, recorded per component in lieu of a system-level table. Units: MVA.
`power_units`	`string (UnitSystem)`	yes	—	Unit basis for this component’s power-family fields (active/reactive/apparent power, ratings, limits, ramp rates). COMPONENT_BASE: per unit on this component’s own base_power. NATURAL_UNITS: the field’s physical unit.