PhaseShiftingTransformer3W

mutable struct PhaseShiftingTransformer3W <: ThreeWindingTransformer
    name::String
    available::Bool
    primary_star_arc::Arc
    secondary_star_arc::Arc
    tertiary_star_arc::Arc
    star_bus::ACBus
    active_power_flow_primary::Float64
    reactive_power_flow_primary::Float64
    active_power_flow_secondary::Float64
    reactive_power_flow_secondary::Float64
    active_power_flow_tertiary::Float64
    reactive_power_flow_tertiary::Float64
    r_primary::Float64
    x_primary::Float64
    r_secondary::Float64
    x_secondary::Float64
    r_tertiary::Float64
    x_tertiary::Float64
    rating::Union{Nothing, Float64}
    r_12::Float64
    x_12::Float64
    r_23::Float64
    x_23::Float64
    r_13::Float64
    x_13::Float64
    α_primary::Float64
    α_secondary::Float64
    α_tertiary::Float64
    base_power_12::Float64
    base_power_23::Float64
    base_power_13::Float64
    base_voltage_primary::Union{Nothing, Float64}
    base_voltage_secondary::Union{Nothing, Float64}
    base_voltage_tertiary::Union{Nothing, Float64}
    g::Float64
    b::Float64
    primary_turns_ratio::Float64
    secondary_turns_ratio::Float64
    tertiary_turns_ratio::Float64
    available_primary::Bool
    available_secondary::Bool
    available_tertiary::Bool
    rating_primary::Float64
    rating_secondary::Float64
    rating_tertiary::Float64
    phase_angle_limits::MinMax
    control_objective_primary::TransformerControlObjective
    control_objective_secondary::TransformerControlObjective
    control_objective_tertiary::TransformerControlObjective
    services::Vector{Service}
    ext::Dict{String, Any}
    internal::InfrastructureSystemsInternal
end

A 3-winding phase-shifting transformer.

. Phase shifts are specified in radians for primary, secondary, and tertiary windings.

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
• primary_star_arc::Arc: An Arc defining this transformer from a primary bus to the star bus
• secondary_star_arc::Arc: An Arc defining this transformer from a secondary bus to the star bus
• tertiary_star_arc::Arc: An Arc defining this transformer from a tertiary bus to the star bus
• star_bus::ACBus: Star (hidden) Bus that this component (equivalent model) is connected to
• active_power_flow_primary::Float64: Initial condition of active power flow through the transformer primary side to star (hidden) bus (MW)
• reactive_power_flow_primary::Float64: Initial condition of reactive power flow through the transformer primary side to star (hidden) bus (MW)
• active_power_flow_secondary::Float64: Initial condition of active power flow through the transformer secondary side to star (hidden) bus (MW)
• reactive_power_flow_secondary::Float64: Initial condition of reactive power flow through the transformer secondary side to star (hidden) bus (MW)
• active_power_flow_tertiary::Float64: Initial condition of active power flow through the transformer tertiary side to star (hidden) bus (MW)
• reactive_power_flow_tertiary::Float64: Initial condition of reactive power flow through the transformer tertiary side to star (hidden) bus (MW)
• r_primary::Float64: Equivalent resistance in pu (SYSTEM_BASE) from primary to star (hidden) bus., validation range: (-2, 4)
• x_primary::Float64: Equivalent reactance in pu (SYSTEM_BASE) from primary to star (hidden) bus., validation range: (-2, 4)
• r_secondary::Float64: Equivalent resistance in pu (SYSTEM_BASE) from secondary to star (hidden) bus., validation range: (-2, 4)
• x_secondary::Float64: Equivalent reactance in pu (SYSTEM_BASE) from secondary to star (hidden) bus., validation range: (-2, 4)
• r_tertiary::Float64: Equivalent resistance in pu (SYSTEM_BASE) from tertiary to star (hidden) bus., validation range: (-2, 4)
• x_tertiary::Float64: Equivalent reactance in pu (SYSTEM_BASE) from tertiary to star (hidden) bus., validation range: (-2, 4)
• rating::Union{Nothing, Float64}: Thermal rating (MVA). Flow through the transformer must be between -rating and rating. When defining a transformer before it is attached to a System, rating must be in pu (SYSTEM_BASE) using the base power of the System it will be attached to, validation range: (0, nothing)
• r_12::Float64: Measured resistance in pu (SYSTEM_BASE) from primary to secondary windings (R1-2 with CZ = 1 in PSS/E)., validation range: (0, 4)
• x_12::Float64: Measured reactance in pu (SYSTEM_BASE) from primary to secondary windings (X1-2 with CZ = 1 in PSS/E)., validation range: (0, 4)
• r_23::Float64: Measured resistance in pu (SYSTEM_BASE) from secondary to tertiary windings (R2-3 with CZ = 1 in PSS/E)., validation range: (0, 4)
• x_23::Float64: Measured reactance in pu (SYSTEM_BASE) from secondary to tertiary windings (X2-3 with CZ = 1 in PSS/E)., validation range: (0, 4)
• r_13::Float64: Measured resistance in pu (SYSTEM_BASE) from primary to tertiary windings (R1-3 with CZ = 1 in PSS/E)., validation range: (0, 4)
• x_13::Float64: Measured reactance in pu (SYSTEM_BASE) from primary to tertiary windings (X1-3 with CZ = 1 in PSS/E)., validation range: (0, 4)
• α_primary::Float64: Initial condition of primary phase shift (radians) between the from and to buses , validation range: (-1.571, 1.571)
• α_secondary::Float64: Initial condition of secondary phase shift (radians) between the from and to buses , validation range: (-1.571, 1.571)
• α_tertiary::Float64: Initial condition of tertiary phase shift (radians) between the from and to buses , validation range: (-1.571, 1.571)
• base_power_12::Float64: Base power (MVA) for per unitization for primary-secondary windings., validation range: (0, nothing)
• base_power_23::Float64: Base power (MVA) for per unitization for secondary-tertiary windings., validation range: (0, nothing)
• base_power_13::Float64: Base power (MVA) for per unitization for primary-tertiary windings., validation range: (0, nothing)
• base_voltage_primary::Union{Nothing, Float64}: (default: get_base_voltage(get_from(primary_star_arc))) Primary base voltage in kV, validation range: (0, nothing)
• base_voltage_secondary::Union{Nothing, Float64}: (default: get_base_voltage(get_from(secondary_star_arc))) Secondary base voltage in kV, validation range: (0, nothing)
• base_voltage_tertiary::Union{Nothing, Float64}: (default: get_base_voltage(get_from(tertiary_star_arc))) Tertiary base voltage in kV, validation range: (0, nothing)
• g::Float64: (default: 0.0) Shunt conductance in pu (SYSTEM_BASE) from star (hidden) bus to ground (MAG1 in PSS/E).
• b::Float64: (default: 0.0) Shunt susceptance in pu (SYSTEM_BASE) from star (hidden) bus to ground (MAG2 in PSS/E).
• primary_turns_ratio::Float64: (default: 1.0) Primary side off-nominal turns ratio in p.u. with respect to connected primary bus (WINDV1 with CW = 1 in PSS/E).
• secondary_turns_ratio::Float64: (default: 1.0) Secondary side off-nominal turns ratio in p.u. with respect to connected secondary bus (WINDV2 with CW = 1 in PSS/E).
• tertiary_turns_ratio::Float64: (default: 1.0) Tertiary side off-nominal turns ratio in p.u. with respect to connected tertiary bus (WINDV3 with CW = 1 in PSS/E).
• available_primary::Bool: (default: true) Status if primary winding is available or not.
• available_secondary::Bool: (default: true) Status if primary winding is available or not.
• available_tertiary::Bool: (default: true) Status if primary winding is available or not.
• rating_primary::Float64: (default: 0.0) Rating (in MVA) for primary winding.
• rating_secondary::Float64: (default: 0.0) Rating (in MVA) for secondary winding.
• rating_tertiary::Float64: (default: 0.0) Rating (in MVA) for tertiary winding.
• phase_angle_limits::MinMax: (default: (min=-3.1416, max=3.1416)) Minimum and maximum phase angle limits (radians)
• control_objective_primary::TransformerControlObjective: (default: TransformerControlObjective.UNDEFINED) Control objective for the tap changer for winding 1. See TransformerControlObjective
• control_objective_secondary::TransformerControlObjective: (default: TransformerControlObjective.UNDEFINED) Control objective for the tap changer for winding 2. See TransformerControlObjective
• control_objective_tertiary::TransformerControlObjective: (default: TransformerControlObjective.UNDEFINED) Control objective for the tap changer for winding 3. See TransformerControlObjective
• 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::PhaseShiftingTransformer3W) -> Bool

Get PhaseShiftingTransformer3W available.

get_name(value::PhaseShiftingTransformer3W) -> String

Get PhaseShiftingTransformer3W name.

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

Set PhaseShiftingTransformer3W available.

get_active_power_flow_primary(
    value::PhaseShiftingTransformer3W
) -> Float64

Get PhaseShiftingTransformer3W active_power_flow_primary.

get_active_power_flow_secondary(
    value::PhaseShiftingTransformer3W
) -> Float64

Get PhaseShiftingTransformer3W active_power_flow_secondary.

get_active_power_flow_tertiary(
    value::PhaseShiftingTransformer3W
) -> Float64

Get PhaseShiftingTransformer3W active_power_flow_tertiary.

get_available_primary(
    value::PhaseShiftingTransformer3W
) -> Bool

Get PhaseShiftingTransformer3W available_primary.

get_available_secondary(
    value::PhaseShiftingTransformer3W
) -> Bool

Get PhaseShiftingTransformer3W available_secondary.

get_available_tertiary(
    value::PhaseShiftingTransformer3W
) -> Bool

Get PhaseShiftingTransformer3W available_tertiary.

get_b(value::PhaseShiftingTransformer3W) -> Float64

Get PhaseShiftingTransformer3W b.

get_base_power_12(
    value::PhaseShiftingTransformer3W
) -> Float64

Get PhaseShiftingTransformer3W base_power_12.

get_base_power_13(
    value::PhaseShiftingTransformer3W
) -> Float64

Get PhaseShiftingTransformer3W base_power_13.

get_base_power_23(
    value::PhaseShiftingTransformer3W
) -> Float64

Get PhaseShiftingTransformer3W base_power_23.

get_base_voltage_primary(
    value::PhaseShiftingTransformer3W
) -> Union{Nothing, Float64}

Get PhaseShiftingTransformer3W base_voltage_primary.

get_base_voltage_secondary(
    value::PhaseShiftingTransformer3W
) -> Union{Nothing, Float64}

Get PhaseShiftingTransformer3W base_voltage_secondary.

get_base_voltage_tertiary(
    value::PhaseShiftingTransformer3W
) -> Union{Nothing, Float64}

Get PhaseShiftingTransformer3W base_voltage_tertiary.

get_control_objective_primary(
    value::PhaseShiftingTransformer3W
) -> PowerSystems.TransformerControlObjectiveModule.TransformerControlObjective

Get PhaseShiftingTransformer3W control_objective_primary.

get_control_objective_secondary(
    value::PhaseShiftingTransformer3W
) -> PowerSystems.TransformerControlObjectiveModule.TransformerControlObjective

Get PhaseShiftingTransformer3W control_objective_secondary.

get_control_objective_tertiary(
    value::PhaseShiftingTransformer3W
) -> PowerSystems.TransformerControlObjectiveModule.TransformerControlObjective

Get PhaseShiftingTransformer3W control_objective_tertiary.

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

Get PhaseShiftingTransformer3W ext.

get_g(value::PhaseShiftingTransformer3W) -> Float64

Get PhaseShiftingTransformer3W g.

get_phase_angle_limits(
    value::PhaseShiftingTransformer3W
) -> @NamedTuple{min::Float64, max::Float64}

Get PhaseShiftingTransformer3W phase_angle_limits.

get_primary_star_arc(
    value::PhaseShiftingTransformer3W
) -> Arc

Get PhaseShiftingTransformer3W primary_star_arc.

get_primary_turns_ratio(
    value::PhaseShiftingTransformer3W
) -> Float64

Get PhaseShiftingTransformer3W primary_turns_ratio.

get_r_12(value::PhaseShiftingTransformer3W) -> Float64

Get PhaseShiftingTransformer3W r_12.

get_r_13(value::PhaseShiftingTransformer3W) -> Float64

Get PhaseShiftingTransformer3W r_13.

get_r_23(value::PhaseShiftingTransformer3W) -> Float64

Get PhaseShiftingTransformer3W r_23.

get_r_primary(value::PhaseShiftingTransformer3W) -> Float64

Get PhaseShiftingTransformer3W r_primary.

get_r_secondary(
    value::PhaseShiftingTransformer3W
) -> Float64

Get PhaseShiftingTransformer3W r_secondary.

get_r_tertiary(value::PhaseShiftingTransformer3W) -> Float64

Get PhaseShiftingTransformer3W r_tertiary.

get_rating(
    value::PhaseShiftingTransformer3W
) -> Union{Nothing, Float64}

Get PhaseShiftingTransformer3W rating.

get_rating_primary(
    value::PhaseShiftingTransformer3W
) -> Float64

Get PhaseShiftingTransformer3W rating_primary.

get_rating_secondary(
    value::PhaseShiftingTransformer3W
) -> Float64

Get PhaseShiftingTransformer3W rating_secondary.

get_rating_tertiary(
    value::PhaseShiftingTransformer3W
) -> Float64

Get PhaseShiftingTransformer3W rating_tertiary.

get_reactive_power_flow_primary(
    value::PhaseShiftingTransformer3W
) -> Float64

Get PhaseShiftingTransformer3W reactive_power_flow_primary.

get_reactive_power_flow_secondary(
    value::PhaseShiftingTransformer3W
) -> Float64

Get PhaseShiftingTransformer3W reactive_power_flow_secondary.

get_reactive_power_flow_tertiary(
    value::PhaseShiftingTransformer3W
) -> Float64

Get PhaseShiftingTransformer3W reactive_power_flow_tertiary.

get_secondary_star_arc(
    value::PhaseShiftingTransformer3W
) -> Arc

Get PhaseShiftingTransformer3W secondary_star_arc.

get_secondary_turns_ratio(
    value::PhaseShiftingTransformer3W
) -> Float64

Get PhaseShiftingTransformer3W secondary_turns_ratio.

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

Get PhaseShiftingTransformer3W services.

get_star_bus(value::PhaseShiftingTransformer3W) -> ACBus

Get PhaseShiftingTransformer3W star_bus.

get_tertiary_star_arc(
    value::PhaseShiftingTransformer3W
) -> Arc

Get PhaseShiftingTransformer3W tertiary_star_arc.

get_tertiary_turns_ratio(
    value::PhaseShiftingTransformer3W
) -> Float64

Get PhaseShiftingTransformer3W tertiary_turns_ratio.

get_x_12(value::PhaseShiftingTransformer3W) -> Float64

Get PhaseShiftingTransformer3W x_12.

get_x_13(value::PhaseShiftingTransformer3W) -> Float64

Get PhaseShiftingTransformer3W x_13.

get_x_23(value::PhaseShiftingTransformer3W) -> Float64

Get PhaseShiftingTransformer3W x_23.

get_x_primary(value::PhaseShiftingTransformer3W) -> Float64

Get PhaseShiftingTransformer3W x_primary.

get_x_secondary(
    value::PhaseShiftingTransformer3W
) -> Float64

Get PhaseShiftingTransformer3W x_secondary.

get_x_tertiary(value::PhaseShiftingTransformer3W) -> Float64

Get PhaseShiftingTransformer3W x_tertiary.

get_α_primary(value::PhaseShiftingTransformer3W) -> Float64

Get PhaseShiftingTransformer3W α_primary.

get_α_secondary(
    value::PhaseShiftingTransformer3W
) -> Float64

Get PhaseShiftingTransformer3W α_secondary.

get_α_tertiary(value::PhaseShiftingTransformer3W) -> Float64

Get PhaseShiftingTransformer3W α_tertiary.

set_active_power_flow_primary!(
    value::PhaseShiftingTransformer3W,
    val
) -> Any

Set PhaseShiftingTransformer3W active_power_flow_primary.

set_active_power_flow_secondary!(
    value::PhaseShiftingTransformer3W,
    val
) -> Any

Set PhaseShiftingTransformer3W active_power_flow_secondary.

set_active_power_flow_tertiary!(
    value::PhaseShiftingTransformer3W,
    val
) -> Any

Set PhaseShiftingTransformer3W active_power_flow_tertiary.

set_available_primary!(
    value::PhaseShiftingTransformer3W,
    val
) -> Any

Set PhaseShiftingTransformer3W available_primary.

set_available_secondary!(
    value::PhaseShiftingTransformer3W,
    val
) -> Any

Set PhaseShiftingTransformer3W available_secondary.

set_available_tertiary!(
    value::PhaseShiftingTransformer3W,
    val
) -> Any

Set PhaseShiftingTransformer3W available_tertiary.

set_b!(value::PhaseShiftingTransformer3W, val) -> Any

Set PhaseShiftingTransformer3W b.

set_base_power_12!(
    value::PhaseShiftingTransformer3W,
    val
) -> Any

Set PhaseShiftingTransformer3W base_power_12.

set_base_power_13!(
    value::PhaseShiftingTransformer3W,
    val
) -> Any

Set PhaseShiftingTransformer3W base_power_13.

set_base_power_23!(
    value::PhaseShiftingTransformer3W,
    val
) -> Any

Set PhaseShiftingTransformer3W base_power_23.

set_base_voltage_primary!(
    value::PhaseShiftingTransformer3W,
    val
) -> Any

Set PhaseShiftingTransformer3W base_voltage_primary.

set_base_voltage_secondary!(
    value::PhaseShiftingTransformer3W,
    val
) -> Any

Set PhaseShiftingTransformer3W base_voltage_secondary.

set_base_voltage_tertiary!(
    value::PhaseShiftingTransformer3W,
    val
) -> Any

Set PhaseShiftingTransformer3W base_voltage_tertiary.

set_control_objective_primary!(
    value::PhaseShiftingTransformer3W,
    val
) -> Any

Set PhaseShiftingTransformer3W control_objective_primary.

set_control_objective_secondary!(
    value::PhaseShiftingTransformer3W,
    val
) -> Any

Set PhaseShiftingTransformer3W control_objective_secondary.

set_control_objective_tertiary!(
    value::PhaseShiftingTransformer3W,
    val
) -> Any

Set PhaseShiftingTransformer3W control_objective_tertiary.

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

Set PhaseShiftingTransformer3W ext.

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

Set PhaseShiftingTransformer3W g.

set_phase_angle_limits!(
    value::PhaseShiftingTransformer3W,
    val
) -> Any

Set PhaseShiftingTransformer3W phase_angle_limits.

set_primary_star_arc!(
    value::PhaseShiftingTransformer3W,
    val
) -> Any

Set PhaseShiftingTransformer3W primary_star_arc.

set_primary_turns_ratio!(
    value::PhaseShiftingTransformer3W,
    val
) -> Any

Set PhaseShiftingTransformer3W primary_turns_ratio.

set_r_12!(value::PhaseShiftingTransformer3W, val) -> Any

Set PhaseShiftingTransformer3W r_12.

set_r_13!(value::PhaseShiftingTransformer3W, val) -> Any

Set PhaseShiftingTransformer3W r_13.

set_r_23!(value::PhaseShiftingTransformer3W, val) -> Any

Set PhaseShiftingTransformer3W r_23.

set_r_primary!(
    value::PhaseShiftingTransformer3W,
    val
) -> Any

Set PhaseShiftingTransformer3W r_primary.

set_r_secondary!(
    value::PhaseShiftingTransformer3W,
    val
) -> Any

Set PhaseShiftingTransformer3W r_secondary.

set_r_tertiary!(
    value::PhaseShiftingTransformer3W,
    val
) -> Any

Set PhaseShiftingTransformer3W r_tertiary.

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

Set PhaseShiftingTransformer3W rating.

set_rating_primary!(
    value::PhaseShiftingTransformer3W,
    val
) -> Any

Set PhaseShiftingTransformer3W rating_primary.

set_rating_secondary!(
    value::PhaseShiftingTransformer3W,
    val
) -> Any

Set PhaseShiftingTransformer3W rating_secondary.

set_rating_tertiary!(
    value::PhaseShiftingTransformer3W,
    val
) -> Any

Set PhaseShiftingTransformer3W rating_tertiary.

set_reactive_power_flow_primary!(
    value::PhaseShiftingTransformer3W,
    val
) -> Any

Set PhaseShiftingTransformer3W reactive_power_flow_primary.

set_reactive_power_flow_secondary!(
    value::PhaseShiftingTransformer3W,
    val
) -> Any

Set PhaseShiftingTransformer3W reactive_power_flow_secondary.

set_reactive_power_flow_tertiary!(
    value::PhaseShiftingTransformer3W,
    val
) -> Any

Set PhaseShiftingTransformer3W reactive_power_flow_tertiary.

set_secondary_star_arc!(
    value::PhaseShiftingTransformer3W,
    val
) -> Any

Set PhaseShiftingTransformer3W secondary_star_arc.

set_secondary_turns_ratio!(
    value::PhaseShiftingTransformer3W,
    val
) -> Any

Set PhaseShiftingTransformer3W secondary_turns_ratio.

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

Set PhaseShiftingTransformer3W services.

set_star_bus!(value::PhaseShiftingTransformer3W, val) -> Any

Set PhaseShiftingTransformer3W star_bus.

set_tertiary_star_arc!(
    value::PhaseShiftingTransformer3W,
    val
) -> Any

Set PhaseShiftingTransformer3W tertiary_star_arc.

set_tertiary_turns_ratio!(
    value::PhaseShiftingTransformer3W,
    val
) -> Any

Set PhaseShiftingTransformer3W tertiary_turns_ratio.

set_x_12!(value::PhaseShiftingTransformer3W, val) -> Any

Set PhaseShiftingTransformer3W x_12.

set_x_13!(value::PhaseShiftingTransformer3W, val) -> Any

Set PhaseShiftingTransformer3W x_13.

set_x_23!(value::PhaseShiftingTransformer3W, val) -> Any

Set PhaseShiftingTransformer3W x_23.

set_x_primary!(
    value::PhaseShiftingTransformer3W,
    val
) -> Any

Set PhaseShiftingTransformer3W x_primary.

set_x_secondary!(
    value::PhaseShiftingTransformer3W,
    val
) -> Any

Set PhaseShiftingTransformer3W x_secondary.

set_x_tertiary!(
    value::PhaseShiftingTransformer3W,
    val
) -> Any

Set PhaseShiftingTransformer3W x_tertiary.

set_α_primary!(
    value::PhaseShiftingTransformer3W,
    val
) -> Any

Set PhaseShiftingTransformer3W α_primary.

set_α_secondary!(
    value::PhaseShiftingTransformer3W,
    val
) -> Any

Set PhaseShiftingTransformer3W α_secondary.

set_α_tertiary!(
    value::PhaseShiftingTransformer3W,
    val
) -> Any

Set PhaseShiftingTransformer3W α_tertiary.