TwoTerminalVSCLine

mutable struct TwoTerminalVSCLine <: TwoTerminalHVDC
    name::String
    available::Bool
    arc::Arc
    active_power_flow::Float64
    rating::Float64
    active_power_limits_from::MinMax
    active_power_limits_to::MinMax
    g::Float64
    dc_current::Float64
    reactive_power_from::Float64
    dc_control_from::VSCDCControlModes
    ac_control_from::VSCACControlModes
    dc_setpoint_from::Float64
    ac_setpoint_from::Float64
    converter_loss_from::Union{LinearCurve, QuadraticCurve}
    max_dc_current_from::Float64
    rating_from::Float64
    reactive_power_limits_from::MinMax
    power_factor_weighting_fraction_from::Float64
    voltage_limits_from::MinMax
    dc_voltage_droop_from::Float64
    reactive_power_to::Float64
    dc_control_to::VSCDCControlModes
    ac_control_to::VSCACControlModes
    dc_setpoint_to::Float64
    ac_setpoint_to::Float64
    converter_loss_to::Union{LinearCurve, QuadraticCurve}
    max_dc_current_to::Float64
    rating_to::Float64
    reactive_power_limits_to::MinMax
    power_factor_weighting_fraction_to::Float64
    voltage_limits_to::MinMax
    dc_voltage_droop_to::Float64
    rated_dc_voltage::Float64
    remote_bus_control_from::Int
    remote_bus_control_to::Int
    rmpct_from::Float64
    rmpct_to::Float64
    services::Vector{Service}
    ext::Dict{String, Any}
    internal::InfrastructureSystemsInternal
end

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

Arguments

• name::String: 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::Bool: Indicator of whether the component is connected and online (true) or disconnected, offline, or down (false). Unavailable components are excluded during simulations
• arc::Arc: An Arc defining this line from a bus to another bus
• active_power_flow::Float64: Initial condition of active power flowing from the from-bus to the to-bus in DC.
• rating::Float64: Maximum output power rating of the converter (MVA), validation range: (0, nothing)
• active_power_limits_from::MinMax: Minimum and maximum active power flows to the FROM node (MW)
• active_power_limits_to::MinMax: Minimum and maximum active power flows to the TO node (MW)
• g::Float64: (default: 0.0) Series conductance of the DC line in pu (SYSTEM_BASE)
• dc_current::Float64: (default: 0.0) DC current (A) on the converter flowing in the DC line, from from bus to to bus.
• reactive_power_from::Float64: (default: 0.0) Initial condition of reactive power flowing into the from-bus.
• dc_control_from::VSCDCControlModes: (default: VSCDCControlModes.DC_VOLTAGE) DC-side control mode of the from converter; see VSCDCControlModes.
• ac_control_from::VSCACControlModes: (default: VSCACControlModes.AC_VOLTAGE) AC-side control mode of the from converter; see VSCACControlModes.
• dc_setpoint_from::Float64: (default: 0.0) Converter DC setpoint on the from bus converter, in per-unit. For a DC-voltage-controlling mode (dc_control_from is DC_VOLTAGE or DC_VOLTAGE_DROOP) this is the DC-side voltage in per-unit of rated_dc_voltage. For DC_POWER this is the active-power demand in per-unit (SYSTEM_BASE); positive means the converter supplies power to the AC network at the from bus, negative means it withdraws.
• ac_setpoint_from::Float64: (default: 1.0) Converter AC setpoint in the from bus converter. If voltage_control_from = true this number is the AC voltage on the AC side of the converter, entered in per unit. If voltage_control_from = false, this value is the power factor setpoint.
• converter_loss_from::Union{LinearCurve, QuadraticCurve}: (default: LinearCurve(0.0)) 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::Float64: (default: 1e8) Maximum stable dc current limits (A).
• rating_from::Float64: (default: 1e8) Converter rating in MVA in the from bus.
• reactive_power_limits_from::MinMax: (default: (min=0.0, max=0.0)) Limits on the Reactive Power at the from side.
• power_factor_weighting_fraction_from::Float64: (default: 1.0) 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., validation range: (0, 1)
• voltage_limits_from::MinMax: (default: (min=0.0, max=999.9)) Limits on the Voltage at the DC from Bus in [per unit](@ref per_unit.
• dc_voltage_droop_from::Float64: (default: 0.0) 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 (with P_c the converter's AC-side active-power injection).
• reactive_power_to::Float64: (default: 0.0) Initial condition of reactive power flowing into the to-bus.
• dc_control_to::VSCDCControlModes: (default: VSCDCControlModes.DC_VOLTAGE) DC-side control mode of the to converter; see VSCDCControlModes.
• ac_control_to::VSCACControlModes: (default: VSCACControlModes.AC_VOLTAGE) AC-side control mode of the to converter; see VSCACControlModes.
• dc_setpoint_to::Float64: (default: 0.0) Converter DC setpoint on the to bus converter, in per-unit. For a DC-voltage-controlling mode (dc_control_to is DC_VOLTAGE or DC_VOLTAGE_DROOP) this is the DC-side voltage in per-unit of rated_dc_voltage. For DC_POWER this is the active-power demand in per-unit (SYSTEM_BASE); positive means the converter supplies power to the AC network at the to bus, negative means it withdraws.
• ac_setpoint_to::Float64: (default: 1.0) Converter AC setpoint in the to bus converter. If voltage_control_to = true this number is the AC voltage on the AC side of the converter, entered in per unit. If voltage_control_to = false, this value is the power factor setpoint.
• converter_loss_to::Union{LinearCurve, QuadraticCurve}: (default: LinearCurve(0.0)) 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::Float64: (default: 1e8) Maximum stable dc current limits (A).
• rating_to::Float64: (default: 1e8) Converter rating in MVA in the to bus.
• reactive_power_limits_to::MinMax: (default: (min=0.0, max=0.0)) Limits on the Reactive Power at the to side.
• power_factor_weighting_fraction_to::Float64: (default: 1.0) 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., validation range: (0, 1)
• voltage_limits_to::MinMax: (default: (min=0.0, max=999.9)) Limits on the Voltage at the DC to Bus.
• dc_voltage_droop_to::Float64: (default: 0.0) 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 (with P_c the converter's AC-side active-power injection).
• rated_dc_voltage::Float64: (default: 0.0) Rated (base) DC voltage of the link in kV. Used as the DC voltage base for interpreting DC-voltage setpoints and for PSS/E export of DCSET/RDC/BLOSS; 0.0 means unspecified (DC-voltage setpoints are taken as per-unit directly).
• remote_bus_control_from::Int: (default: 0) Number of the AC bus whose voltage the from converter regulates when ac_control_from is AC_VOLTAGE (0 regulates its own terminal bus).
• remote_bus_control_to::Int: (default: 0) Number of the AC bus whose voltage the to converter regulates when ac_control_to is AC_VOLTAGE (0 regulates its own terminal bus).
• rmpct_from::Float64: (default: 100.0) Percent of the total Mvar required to hold the voltage at the bus regulated by the from converter that is contributed by this converter.
• rmpct_to::Float64: (default: 100.0) Percent of the total Mvar required to hold the voltage at the bus regulated by the to converter that is contributed by this converter.
• services::Vector{Service}: (default: Device[]) Services that this device contributes to
• ext::Dict{String, Any}: (default: Dict{String, Any}()) An extra dictionary for users to add metadata that are not used in simulation.
• internal::InfrastructureSystemsInternal: (Do not modify.) PowerSystems.jl internal reference

get_available(value::TwoTerminalVSCLine) -> Bool

Get TwoTerminalVSCLine available.

get_name(value::TwoTerminalVSCLine) -> String

Get TwoTerminalVSCLine name.

set_available!(value::TwoTerminalVSCLine, val) -> Any

Set TwoTerminalVSCLine available.

get_ac_control_from(
    value::TwoTerminalVSCLine
) -> VSCACControlModes

Get TwoTerminalVSCLine ac_control_from.

get_ac_control_to(
    value::TwoTerminalVSCLine
) -> VSCACControlModes

Get TwoTerminalVSCLine ac_control_to.

get_ac_setpoint_from(value::TwoTerminalVSCLine) -> Float64

Get TwoTerminalVSCLine ac_setpoint_from.

get_ac_setpoint_to(value::TwoTerminalVSCLine) -> Float64

Get TwoTerminalVSCLine ac_setpoint_to.

get_active_power_flow(value::TwoTerminalVSCLine) -> Float64

Get TwoTerminalVSCLine active_power_flow.

get_active_power_limits_from(
    value::TwoTerminalVSCLine
) -> @NamedTuple{min::Float64, max::Float64}

Get TwoTerminalVSCLine active_power_limits_from.

get_active_power_limits_to(
    value::TwoTerminalVSCLine
) -> @NamedTuple{min::Float64, max::Float64}

Get TwoTerminalVSCLine active_power_limits_to.

get_arc(value::TwoTerminalVSCLine) -> Arc

Get TwoTerminalVSCLine arc.

get_converter_loss_from(
    value::TwoTerminalVSCLine
) -> Union{LinearCurve, QuadraticCurve}

Get TwoTerminalVSCLine converter_loss_from.

get_converter_loss_to(
    value::TwoTerminalVSCLine
) -> Union{LinearCurve, QuadraticCurve}

Get TwoTerminalVSCLine converter_loss_to.

get_dc_control_from(
    value::TwoTerminalVSCLine
) -> VSCDCControlModes

Get TwoTerminalVSCLine dc_control_from.

get_dc_control_to(
    value::TwoTerminalVSCLine
) -> VSCDCControlModes

Get TwoTerminalVSCLine dc_control_to.

get_dc_current(value::TwoTerminalVSCLine) -> Float64

Get TwoTerminalVSCLine dc_current.

get_dc_setpoint_from(value::TwoTerminalVSCLine) -> Float64

Get TwoTerminalVSCLine dc_setpoint_from.

get_dc_setpoint_to(value::TwoTerminalVSCLine) -> Float64

Get TwoTerminalVSCLine dc_setpoint_to.

get_dc_voltage_droop_from(
    value::TwoTerminalVSCLine
) -> Float64

Get TwoTerminalVSCLine dc_voltage_droop_from.

get_dc_voltage_droop_to(
    value::TwoTerminalVSCLine
) -> Float64

Get TwoTerminalVSCLine dc_voltage_droop_to.

get_ext(value::TwoTerminalVSCLine) -> Dict{String, Any}

Get TwoTerminalVSCLine ext.

get_g(value::TwoTerminalVSCLine) -> Float64

Get TwoTerminalVSCLine g.

get_max_dc_current_from(
    value::TwoTerminalVSCLine
) -> Float64

Get TwoTerminalVSCLine max_dc_current_from.

get_max_dc_current_to(value::TwoTerminalVSCLine) -> Float64

Get TwoTerminalVSCLine max_dc_current_to.

get_power_factor_weighting_fraction_from(
    value::TwoTerminalVSCLine
) -> Float64

Get TwoTerminalVSCLine power_factor_weighting_fraction_from.

get_power_factor_weighting_fraction_to(
    value::TwoTerminalVSCLine
) -> Float64

Get TwoTerminalVSCLine power_factor_weighting_fraction_to.

get_rated_dc_voltage(value::TwoTerminalVSCLine) -> Float64

Get TwoTerminalVSCLine rated_dc_voltage.

get_rating(value::TwoTerminalVSCLine) -> Float64

Get TwoTerminalVSCLine rating.

get_rating_from(value::TwoTerminalVSCLine) -> Float64

Get TwoTerminalVSCLine rating_from.

get_rating_to(value::TwoTerminalVSCLine) -> Float64

Get TwoTerminalVSCLine rating_to.

get_reactive_power_from(
    value::TwoTerminalVSCLine
) -> Float64

Get TwoTerminalVSCLine reactive_power_from.

get_reactive_power_limits_from(
    value::TwoTerminalVSCLine
) -> @NamedTuple{min::Float64, max::Float64}

Get TwoTerminalVSCLine reactive_power_limits_from.

get_reactive_power_limits_to(
    value::TwoTerminalVSCLine
) -> @NamedTuple{min::Float64, max::Float64}

Get TwoTerminalVSCLine reactive_power_limits_to.

get_reactive_power_to(value::TwoTerminalVSCLine) -> Float64

Get TwoTerminalVSCLine reactive_power_to.

get_remote_bus_control_from(
    value::TwoTerminalVSCLine
) -> Int64

Get TwoTerminalVSCLine remote_bus_control_from.

get_remote_bus_control_to(
    value::TwoTerminalVSCLine
) -> Int64

Get TwoTerminalVSCLine remote_bus_control_to.

get_rmpct_from(value::TwoTerminalVSCLine) -> Float64

Get TwoTerminalVSCLine rmpct_from.

get_rmpct_to(value::TwoTerminalVSCLine) -> Float64

Get TwoTerminalVSCLine rmpct_to.

get_services(value::TwoTerminalVSCLine) -> Vector{Service}

Get TwoTerminalVSCLine services.

get_voltage_limits_from(
    value::TwoTerminalVSCLine
) -> @NamedTuple{min::Float64, max::Float64}

Get TwoTerminalVSCLine voltage_limits_from.

get_voltage_limits_to(
    value::TwoTerminalVSCLine
) -> @NamedTuple{min::Float64, max::Float64}

Get TwoTerminalVSCLine voltage_limits_to.

set_ac_control_from!(value::TwoTerminalVSCLine, val) -> Any

Set TwoTerminalVSCLine ac_control_from.

set_ac_control_to!(value::TwoTerminalVSCLine, val) -> Any

Set TwoTerminalVSCLine ac_control_to.

set_ac_setpoint_from!(value::TwoTerminalVSCLine, val) -> Any

Set TwoTerminalVSCLine ac_setpoint_from.

set_ac_setpoint_to!(value::TwoTerminalVSCLine, val) -> Any

Set TwoTerminalVSCLine ac_setpoint_to.

set_active_power_flow!(
    value::TwoTerminalVSCLine,
    val
) -> Any

Set TwoTerminalVSCLine active_power_flow.

set_active_power_limits_from!(
    value::TwoTerminalVSCLine,
    val
) -> Any

Set TwoTerminalVSCLine active_power_limits_from.

set_active_power_limits_to!(
    value::TwoTerminalVSCLine,
    val
) -> Any

Set TwoTerminalVSCLine active_power_limits_to.

set_arc!(value::TwoTerminalVSCLine, val) -> Any

Set TwoTerminalVSCLine arc.

set_converter_loss_from!(
    value::TwoTerminalVSCLine,
    val
) -> Any

Set TwoTerminalVSCLine converter_loss_from.

set_converter_loss_to!(
    value::TwoTerminalVSCLine,
    val
) -> Any

Set TwoTerminalVSCLine converter_loss_to.

set_dc_control_from!(value::TwoTerminalVSCLine, val) -> Any

Set TwoTerminalVSCLine dc_control_from.

set_dc_control_to!(value::TwoTerminalVSCLine, val) -> Any

Set TwoTerminalVSCLine dc_control_to.

set_dc_current!(value::TwoTerminalVSCLine, val) -> Any

Set TwoTerminalVSCLine dc_current.

set_dc_setpoint_from!(value::TwoTerminalVSCLine, val) -> Any

Set TwoTerminalVSCLine dc_setpoint_from.

set_dc_setpoint_to!(value::TwoTerminalVSCLine, val) -> Any

Set TwoTerminalVSCLine dc_setpoint_to.

set_dc_voltage_droop_from!(
    value::TwoTerminalVSCLine,
    val
) -> Any

Set TwoTerminalVSCLine dc_voltage_droop_from.

set_dc_voltage_droop_to!(
    value::TwoTerminalVSCLine,
    val
) -> Any

Set TwoTerminalVSCLine dc_voltage_droop_to.

set_ext!(value::TwoTerminalVSCLine, val) -> Any

Set TwoTerminalVSCLine ext.

set_g!(value::TwoTerminalVSCLine, val) -> Any

Set TwoTerminalVSCLine g.

set_max_dc_current_from!(
    value::TwoTerminalVSCLine,
    val
) -> Any

Set TwoTerminalVSCLine max_dc_current_from.

set_max_dc_current_to!(
    value::TwoTerminalVSCLine,
    val
) -> Any

Set TwoTerminalVSCLine max_dc_current_to.

set_power_factor_weighting_fraction_from!(
    value::TwoTerminalVSCLine,
    val
) -> Any

Set TwoTerminalVSCLine power_factor_weighting_fraction_from.

set_power_factor_weighting_fraction_to!(
    value::TwoTerminalVSCLine,
    val
) -> Any

Set TwoTerminalVSCLine power_factor_weighting_fraction_to.

set_rated_dc_voltage!(value::TwoTerminalVSCLine, val) -> Any

Set TwoTerminalVSCLine rated_dc_voltage.

set_rating!(value::TwoTerminalVSCLine, val) -> Any

Set TwoTerminalVSCLine rating.

set_rating_from!(value::TwoTerminalVSCLine, val) -> Any

Set TwoTerminalVSCLine rating_from.

set_rating_to!(value::TwoTerminalVSCLine, val) -> Any

Set TwoTerminalVSCLine rating_to.

set_reactive_power_from!(
    value::TwoTerminalVSCLine,
    val
) -> Any

Set TwoTerminalVSCLine reactive_power_from.

set_reactive_power_limits_from!(
    value::TwoTerminalVSCLine,
    val
) -> Any

Set TwoTerminalVSCLine reactive_power_limits_from.

set_reactive_power_limits_to!(
    value::TwoTerminalVSCLine,
    val
) -> Any

Set TwoTerminalVSCLine reactive_power_limits_to.

set_reactive_power_to!(
    value::TwoTerminalVSCLine,
    val
) -> Any

Set TwoTerminalVSCLine reactive_power_to.

set_remote_bus_control_from!(
    value::TwoTerminalVSCLine,
    val
) -> Any

Set TwoTerminalVSCLine remote_bus_control_from.

set_remote_bus_control_to!(
    value::TwoTerminalVSCLine,
    val
) -> Any

Set TwoTerminalVSCLine remote_bus_control_to.

set_rmpct_from!(value::TwoTerminalVSCLine, val) -> Any

Set TwoTerminalVSCLine rmpct_from.

set_rmpct_to!(value::TwoTerminalVSCLine, val) -> Any

Set TwoTerminalVSCLine rmpct_to.

set_services!(value::TwoTerminalVSCLine, val) -> Any

Set TwoTerminalVSCLine services.

set_voltage_limits_from!(
    value::TwoTerminalVSCLine,
    val
) -> Any

Set TwoTerminalVSCLine voltage_limits_from.

set_voltage_limits_to!(
    value::TwoTerminalVSCLine,
    val
) -> Any

Set TwoTerminalVSCLine voltage_limits_to.