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. Impedance, voltage, and voltage-droop fields are natural units only: there is no conventional DC base voltage from which to per-unitize them.

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)	Transfer rating of the DC line, independent of the converter ratings at each end. Units: per power_units — NATURAL_UNITS: MVA, COMPONENT_BASE: pu .
g	number	—	S	Series conductance of the DC line. Units: S.
dc_current	number	—	kA	DC current on the converter flowing in the DC line, from from bus to to bus. Units: kA.
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. No default: an in-service converter always controls something on each side, so the mode is supplied explicitly.
ac_control_from	string (VSCACControlModes)	—	—	AC-side control mode of the from converter. No default: an in-service converter always controls something on each side, so the mode is supplied explicitly.
dc_power_setpoint_from	number or null	—	MW / pu (by power_units)	Active-power order of the from bus converter, used when dc_control_from is DC_POWER; null otherwise. Positive means the converter supplies power to the AC network; negative means it withdraws power from it. Units: per power_units — NATURAL_UNITS: MW, COMPONENT_BASE: pu .
dc_voltage_setpoint_from	number or null	—	kV	DC-side voltage target of the from bus converter, used when dc_control_from is DC_VOLTAGE or DC_VOLTAGE_DROOP; null otherwise. Units: kV.
power_factor_setpoint_from	number or null	—	1	Power-factor setpoint of the from bus converter, used when ac_control_from is AC_REACTIVE_POWER; null otherwise. Units: 1.
ac_voltage_setpoint_from	number or null	—	kV	AC-side voltage magnitude target of the from bus converter, used when ac_control_from is AC_VOLTAGE; null otherwise. Units: kV.
rated_ac_voltage_from	number	—	kV	Rated AC voltage at the from converter’s AC terminal; 0.0 means unspecified. 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	—	kA	Maximum stable dc current limits. 9999 means no limit. Units: kA.
rating_from	number	—	MVA / pu (by power_units)	Converter rating in the from bus. Absent means the converter imposes no limit beyond rating. 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_limits_from	MinMax	—	kV	Minimum and maximum voltage at the DC from bus. Units: kV.
dc_voltage_droop_from	number	—	kV/MW	DC-voltage droop gain on the from converter, used when dc_control_from is DC_VOLTAGE_DROOP: V_dc = dc_voltage_setpoint_from - dc_voltage_droop_from * P_c, with V_dc in kV and P_c in MW regardless of power_units. A value of 0.0 disables droop. Units: kV/MW.
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. No default: an in-service converter always controls something on each side, so the mode is supplied explicitly.
ac_control_to	string (VSCACControlModes)	—	—	AC-side control mode of the to converter. No default: an in-service converter always controls something on each side, so the mode is supplied explicitly.
dc_power_setpoint_to	number or null	—	MW / pu (by power_units)	Active-power order of the to bus converter, used when dc_control_to is DC_POWER; null otherwise. Positive means the converter supplies power to the AC network; negative means it withdraws power from it. Units: per power_units — NATURAL_UNITS: MW, COMPONENT_BASE: pu .
dc_voltage_setpoint_to	number or null	—	kV	DC-side voltage target of the to bus converter, used when dc_control_to is DC_VOLTAGE or DC_VOLTAGE_DROOP; null otherwise. Units: kV.
power_factor_setpoint_to	number or null	—	1	Power-factor setpoint of the to bus converter, used when ac_control_to is AC_REACTIVE_POWER; null otherwise. Units: 1.
ac_voltage_setpoint_to	number or null	—	kV	AC-side voltage magnitude target of the to bus converter, used when ac_control_to is AC_VOLTAGE; null otherwise. Units: kV.
rated_ac_voltage_to	number	—	kV	Rated AC voltage at the to converter’s AC terminal; 0.0 means unspecified. 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	—	kA	Maximum stable dc current limits. 9999 means no limit. Units: kA.
rating_to	number	—	MVA / pu (by power_units)	Converter rating in the to bus. Absent means the converter imposes no limit beyond rating. Units: per power_units — NATURAL_UNITS: MVA, COMPONENT_BASE: pu .
operational_flow_limit	OperationalFlowLimit	—	MW / pu (by power_units)	Operator-set minimum and maximum flow in each direction, applied in addition to rating. Absent means no operational limit. Units: per power_units — NATURAL_UNITS: MW, 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	Minimum and maximum voltage at the DC to bus. Units: kV.
dc_voltage_droop_to	number	—	kV/MW	DC-voltage droop gain on the to converter, used when dc_control_to is DC_VOLTAGE_DROOP: V_dc = dc_voltage_setpoint_to - dc_voltage_droop_to * P_c, with V_dc in kV and P_c in MW regardless of power_units. A value of 0.0 disables droop. Units: kV/MW.
rated_dc_voltage	number	—	kV	Rated DC voltage of the link; 0.0 means unspecified. 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.
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.