Transformer3W

mutable struct Transformer3W <: 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
    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
    primary_group_number::WindingGroupNumber
    secondary_group_number::WindingGroupNumber
    tertiary_group_number::WindingGroupNumber
    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 transformer.

The model uses an equivalent star model with a star (hidden) bus. The user must transform the data to use CW = CZ = CM = 1 and COD1 = COD2 = COD3 = 0 (no voltage control) if taken from a PSS/E 3W transformer model. Three equivalent impedances (connecting each side to the star bus) are required to define the model. Shunt conductance (iron losses) and magnetizing susceptance can be considered from the star bus to ground. The model is described in Chapter 3.6 in J.D. Glover, M.S. Sarma and T. Overbye: Power Systems Analysis and Design.

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) ACBus 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)
• 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.
• primary_group_number::WindingGroupNumber: (default: WindingGroupNumber.UNDEFINED) Vector group number ('clock number') indicating fixed phase shift (radians) between the from and to buses due to the connection group configuration
• secondary_group_number::WindingGroupNumber: (default: WindingGroupNumber.UNDEFINED) Vector group number ('clock number') indicating fixed phase shift (radians) between the from and to buses due to the connection group configuration
• tertiary_group_number::WindingGroupNumber: (default: WindingGroupNumber.UNDEFINED) Vector group number ('clock number') indicating fixed phase shift (radians) between the from and to buses due to the connection group configuration
• 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::Transformer3W) -> Bool

Get Transformer3Wavailable.

get_name(value::Transformer3W) -> String

Get Transformer3Wname.

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

Set Transformer3Wavailable.

get_active_power_flow_primary(
    value::Transformer3W
) -> Float64

Get Transformer3Wactive_power_flow_primary.

get_active_power_flow_secondary(
    value::Transformer3W
) -> Float64

Get Transformer3Wactive_power_flow_secondary.

get_active_power_flow_tertiary(
    value::Transformer3W
) -> Float64

Get Transformer3Wactive_power_flow_tertiary.

get_available_primary(value::Transformer3W) -> Bool

Get Transformer3Wavailable_primary.

get_available_secondary(value::Transformer3W) -> Bool

Get Transformer3Wavailable_secondary.

get_available_tertiary(value::Transformer3W) -> Bool

Get Transformer3Wavailable_tertiary.

get_b(value::Transformer3W) -> Float64

Get Transformer3Wb.

get_base_power_12(value::Transformer3W) -> Float64

Get Transformer3Wbase_power_12.

get_base_power_13(value::Transformer3W) -> Float64

Get Transformer3Wbase_power_13.

get_base_power_23(value::Transformer3W) -> Float64

Get Transformer3Wbase_power_23.

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

Get Transformer3Wbase_voltage_primary.

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

Get Transformer3Wbase_voltage_secondary.

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

Get Transformer3Wbase_voltage_tertiary.

get_control_objective_primary(
    value::Transformer3W
) -> TransformerControlObjective

Get Transformer3Wcontrol_objective_primary.

get_control_objective_secondary(
    value::Transformer3W
) -> TransformerControlObjective

Get Transformer3Wcontrol_objective_secondary.

get_control_objective_tertiary(
    value::Transformer3W
) -> TransformerControlObjective

Get Transformer3Wcontrol_objective_tertiary.

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

Get Transformer3Wext.

get_g(value::Transformer3W) -> Float64

Get Transformer3Wg.

get_primary_group_number(
    value::Transformer3W
) -> WindingGroupNumber

Get Transformer3Wprimary_group_number.

get_primary_star_arc(value::Transformer3W) -> Arc

Get Transformer3Wprimary_star_arc.

get_primary_turns_ratio(value::Transformer3W) -> Float64

Get Transformer3Wprimary_turns_ratio.

get_r_12(value::Transformer3W) -> Float64

Get Transformer3Wr_12.

get_r_13(value::Transformer3W) -> Float64

Get Transformer3Wr_13.

get_r_23(value::Transformer3W) -> Float64

Get Transformer3Wr_23.

get_r_primary(value::Transformer3W) -> Float64

Get Transformer3Wr_primary.

get_r_secondary(value::Transformer3W) -> Float64

Get Transformer3Wr_secondary.

get_r_tertiary(value::Transformer3W) -> Float64

Get Transformer3Wr_tertiary.

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

Get Transformer3Wrating.

get_rating_primary(value::Transformer3W) -> Float64

Get Transformer3Wrating_primary.

get_rating_secondary(value::Transformer3W) -> Float64

Get Transformer3Wrating_secondary.

get_rating_tertiary(value::Transformer3W) -> Float64

Get Transformer3Wrating_tertiary.

get_reactive_power_flow_primary(
    value::Transformer3W
) -> Float64

Get Transformer3Wreactive_power_flow_primary.

get_reactive_power_flow_secondary(
    value::Transformer3W
) -> Float64

Get Transformer3Wreactive_power_flow_secondary.

get_reactive_power_flow_tertiary(
    value::Transformer3W
) -> Float64

Get Transformer3Wreactive_power_flow_tertiary.

get_secondary_group_number(
    value::Transformer3W
) -> WindingGroupNumber

Get Transformer3Wsecondary_group_number.

get_secondary_star_arc(value::Transformer3W) -> Arc

Get Transformer3Wsecondary_star_arc.

get_secondary_turns_ratio(value::Transformer3W) -> Float64

Get Transformer3Wsecondary_turns_ratio.

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

Get Transformer3Wservices.

get_star_bus(value::Transformer3W) -> ACBus

Get Transformer3Wstar_bus.

get_tertiary_group_number(
    value::Transformer3W
) -> WindingGroupNumber

Get Transformer3Wtertiary_group_number.

get_tertiary_star_arc(value::Transformer3W) -> Arc

Get Transformer3Wtertiary_star_arc.

get_tertiary_turns_ratio(value::Transformer3W) -> Float64

Get Transformer3Wtertiary_turns_ratio.

get_x_12(value::Transformer3W) -> Float64

Get Transformer3Wx_12.

get_x_13(value::Transformer3W) -> Float64

Get Transformer3Wx_13.

get_x_23(value::Transformer3W) -> Float64

Get Transformer3Wx_23.

get_x_primary(value::Transformer3W) -> Float64

Get Transformer3Wx_primary.

get_x_secondary(value::Transformer3W) -> Float64

Get Transformer3Wx_secondary.

get_x_tertiary(value::Transformer3W) -> Float64

Get Transformer3Wx_tertiary.

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

Set Transformer3Wactive_power_flow_primary.

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

Set Transformer3Wactive_power_flow_secondary.

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

Set Transformer3Wactive_power_flow_tertiary.

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

Set Transformer3Wavailable_primary.

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

Set Transformer3Wavailable_secondary.

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

Set Transformer3Wavailable_tertiary.

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

Set Transformer3Wb.

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

Set Transformer3Wbase_power_12.

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

Set Transformer3Wbase_power_13.

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

Set Transformer3Wbase_power_23.

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

Set Transformer3Wbase_voltage_primary.

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

Set Transformer3Wbase_voltage_secondary.

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

Set Transformer3Wbase_voltage_tertiary.

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

Set Transformer3Wcontrol_objective_primary.

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

Set Transformer3Wcontrol_objective_secondary.

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

Set Transformer3Wcontrol_objective_tertiary.

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

Set Transformer3Wext.

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

Set Transformer3Wg.

set_primary_group_number!(value::Transformer3W, val) -> Any

Set Transformer3Wprimary_group_number.

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

Set Transformer3Wprimary_star_arc.

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

Set Transformer3Wprimary_turns_ratio.

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

Set Transformer3Wr_12.

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

Set Transformer3Wr_13.

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

Set Transformer3Wr_23.

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

Set Transformer3Wr_primary.

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

Set Transformer3Wr_secondary.

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

Set Transformer3Wr_tertiary.

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

Set Transformer3Wrating.

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

Set Transformer3Wrating_primary.

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

Set Transformer3Wrating_secondary.

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

Set Transformer3Wrating_tertiary.

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

Set Transformer3Wreactive_power_flow_primary.

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

Set Transformer3Wreactive_power_flow_secondary.

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

Set Transformer3Wreactive_power_flow_tertiary.

set_secondary_group_number!(
    value::Transformer3W,
    val
) -> Any

Set Transformer3Wsecondary_group_number.

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

Set Transformer3Wsecondary_star_arc.

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

Set Transformer3Wsecondary_turns_ratio.

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

Set Transformer3Wservices.

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

Set Transformer3Wstar_bus.

set_tertiary_group_number!(value::Transformer3W, val) -> Any

Set Transformer3Wtertiary_group_number.

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

Set Transformer3Wtertiary_star_arc.

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

Set Transformer3Wtertiary_turns_ratio.

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

Set Transformer3Wx_12.

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

Set Transformer3Wx_13.

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

Set Transformer3Wx_23.

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

Set Transformer3Wx_primary.

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

Set Transformer3Wx_secondary.

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

Set Transformer3Wx_tertiary.