Skip to content

Transformer (3-phase, 2-winding) ​

Three-phase two-winding (HV / LV) mutually-coupled transformer. Leakage plus a magnetizing branch that is linear by default and can take an optional core-saturation curve (exponential, SE datasheet points, or a two-slope air-core knee for inrush studies); no hysteresis or residual flux. Fixed 3-leg core (shared magnetic circuit blocks zero-sequence flux). Vector-clock phase shift on HV→LV. Optional tap on a user-selectable host winding: a fixed off-nominal ratio, or a variable tap changer (first-order lag toward a tap_cmd named input). Carries a load-flow PSSE 2-winding record; the column values are derived from the EMT parameters via the schema's computations block (no separate load-flow tab). Same parameter shape as the 3-winding sibling (transformer_3w_3ph) with the TV side dropped.

Category: Transformers

Ports ​

PortKindSignalNotes
HVThree-phase terminal—
LVThree-phase terminal—
HV_nElectrical terminal—Shown when HV connection is YN (wye + neutral) and HV neutral is Neutral exposed (HV_n port)
LV_nElectrical terminal—Shown when LV connection is yn (wye + neutral) and LV neutral is Neutral exposed (LV_n port)

Parameters ​

Config ​

ParameterTypeDefaultUnitsDescriptionID
S ratedNumber100MVA (also VA, kVA)Three-phase apparent-power rating. The unit selector beside this field lets you enter the value in VA, kVA, or MVA — at netlist-export time the schema's `computations` block converts the selection to canonical VA, which is what the EMT model and load-flow extractor read. Sets the transformer's per-unit base (Z_base_pu = V_LL² / S_rated) and the load-flow R / X system-base conversion (R_pu_sys = R_pu_tx · 100 MVA / S_rated_canonical).s_rated
f ratedNumber60—Rated electrical frequency, in hertz. Drives every per-unit-to-henries conversion (X_pu → L = X_pu · Z_base / (2πf)) on the EMT side; the load-flow extractor uses the system base frequency (60 Hz) for its own conversions, so f_rated_hz is EMT-only.f_rated_hz
V HV rated (LL)Number230000V (also kV)HV-winding rated line-to-line RMS voltage. The unit selector beside this field lets you enter the value in V or kV — at netlist-export time the schema's `computations` block converts the selection to canonical volts, which is what the EMT model and load-flow extractor read. Drives the HV-side per-unit base and the HV:LV turns ratio (per-winding rated voltage: V_LL/√3 for Y, V_LL for Δ). Surfaces as load-flow NOMV1 (converted to kV at extract time).v_hv_rated_v
V LV rated (LL)Number115000V (also kV)LV-winding rated line-to-line RMS voltage. Pick V or kV in the unit selector; the computations block converts to canonical volts at netlist export. Sets the LV-side per-unit base. Surfaces as load-flow NOMV2.v_lv_rated_v
HV connectionChoice: Y (floating N) / YN (wye + neutral) / Δ deltaYN (wye + neutral)—HV winding connection. `Y` = wye with a floating (isolated) neutral — no zero-sequence path. `YN` = wye with an accessible neutral; the `HV neutral` selector below decides whether it is grounded internally or brought out to the HV_n port. `D` = delta.hv_connection
HV neutralChoice: Neutral exposed (HV_n port) / Grounded internallyGrounded internally—How the HV wye star point is handled (only applies to the YN connection). `Exposed`: the neutral is brought out to the HV_n port wired directly to the star point — ground it externally with a `gnd` cell or leave it floating. `Grounded`: the neutral is tied to ground inside the transformer (no HV_n port); pick solid or Rn+jXn impedance grounding on the Grounding tab.hv_neutral
LV connectionChoice: y (floating n) / yn (wye + neutral) / d (delta)yn (wye + neutral)—LV winding connection. `y` = wye with a floating (isolated) neutral. `yn` = wye with an accessible neutral; the `LV neutral` selector below decides whether it is grounded internally or brought out to the LV_n port. `d` = delta.lv_connection
LV neutralChoice: Neutral exposed (LV_n port) / Grounded internallyGrounded internally—How the LV wye star point is handled (only applies to the yn connection). `Exposed`: the neutral is brought out to the LV_n port wired directly to the star point. `Grounded`: the neutral is tied to ground inside the transformer (no LV_n port); pick solid or Rn+jXn impedance grounding on the Grounding tab.lv_neutral
HV→LV vector clockChoice: 0 (in phase) / 1 (−30°) / 5 (−150°) / 6 (180°) / 7 (+150°) / 11 (+30°)0 (in phase)—Phase shift of LV relative to HV, in 30° clock units (0 = in-phase, 1 = LV lags HV 30°, 11 = LV leads 30°, 6 = 180°). Maps directly to PSSE ANG2 = −30° × clock.hv_lv_vector_clock
R HV-LV (pu)Number0.005—HV-LV pair series resistance, per-unit on the transformer's own base (S_rated, V_HV-rated). Measured by short-circuiting LV and energising HV at rated current. Typical 0.002 – 0.01. Split evenly between the HV and LV winding leakages (R_HV_pu = R_LV_pu = R_HV-LV_pu / 2) when stamped on the EMT side.r_hv_lv_pu
X HV-LV (pu)Number0.1—HV-LV pair leakage reactance, per-unit on the transformer's own base. Typical 0.08 – 0.12. Split evenly between the two windings (X_HV_pu = X_LV_pu = X_HV-LV_pu / 2). Surfaces as PSSE column R / X (after a 100 MVA / S_rated rebase).x_hv_lv_pu
I_mag HV (%)Number1—No-load magnetizing current on the HV side at rated voltage, in percent of HV rated current (= 100 × I_mag / I_HV_rated). Sets the linear magnetizing inductance referred to the HV winding (the model uses HV as the magnetisation reference).i_mag_hv_pct
I_mag LV (%)Number1—No-load magnetizing current on the LV side at rated voltage, in percent of LV rated current. Informational in v1 — the LV magnetisation contribution is implied by the per-pair leakages and the HV-side L_m. Round to the same value as i_mag_hv_pct if you have no separate measurement.i_mag_lv_pct
No-load loss (pu)Number0—No-load (iron) loss, per-unit on S_rated. Lumps hysteresis + eddy at f_rated. The `No-load loss topology` parameter below picks where the resulting conductance is stamped. Set to 0 to disable.no_load_loss_pu
No-load loss topologyChoice: Across HV winding / Line-to-ground per phaseAcross HV winding—Where the no-load-loss conductance is stamped. `winding`: in parallel with the HV magnetising branch (across the per-leg HV winding). `line_ground`: as a shunt from each HV line terminal to ground (3-phase Y of conductors, common for surge / lightning models).no_load_loss_topology
Magnetic saturationChoice: Off (linear) / OnOff (linear)—Enable the exponential open-circuit core-saturation curve acting on the per-leg magnetizing inductance L_m (the same shared saturation model used by the synchronous machine). When on, the magnetizing branch draws extra current above the knee flux ψT1. Define the curve directly (Asat/Bsat) or via the SE(1.0)/SE(1.2) datasheet points on the Saturation tab. Off = linear core (the v1 default).saturation
Tap changerChoice: Off / Fixed / VariableOff—`Off`: the host winding runs at its rated turns ratio. `Fixed`: the host winding is held at the off-nominal ratio set on the Tap Changer tab for the whole run (a de-energised tap setting, or a PSSE WINDV other than 1.0); no signal is involved. `Variable`: the ratio starts there and tracks the `tap_cmd` named input through a first-order lag with time constant `tap_time_constant_s`. Fixed and Variable both seed the host winding's load-flow WINDV column.enable_tap_changer
Measure HV currentChoice: Off / Line current / Winding currentOff—Emit HV per-phase currents. `off`: do not emit. `line`: per-phase line current (current into the HV port — coincides with winding current for Y connection). `winding`: per-phase winding current (line current rotated into the Δ winding for D connection; same as line for Y).measure_hv_current
HV positive directionChoice: +ve in / +ve out+ve in—Sign convention for this current. '+ve in' (default) is positive when current flows into the HV terminal. '+ve out' flips the sign.hv_current_dir
Measure LV currentChoice: Off / Line current / Winding currentOff—Emit LV per-phase currents. Same options as `Measure HV current`.measure_lv_current
LV positive directionChoice: +ve in / +ve out+ve in—Sign convention for this current. '+ve in' (default) is positive when current flows into the LV terminal. '+ve out' flips the sign.lv_current_dir
Measure mag currentChoice: Off / OnOff—Emit per-leg magnetizing current i_mag_a/b/c (A) through the linear magnetising branch.measure_mag_current
Mag positive directionChoice: +ve in / +ve out+ve in—Sign convention for this current. '+ve in' (default) is positive when current flows into the magnetizing branch (the model's native sign). '+ve out' flips the sign.mag_current_dir
Measure core fluxChoice: Off / OnOff—Emit per-leg magnetizing flux linkage psi_a/b/c in per-unit of the peak HV-winding flux base (1.0 pu = the flux a rated sinusoidal winding voltage produces at f_rated). This is the state that drives saturation, so it is the signal that explains a magnetizing-current waveform: compare it against the saturation threshold to see when the core goes over. Available whether or not saturation is enabled.measure_flux

Tap Changer ​

ParameterTypeDefaultUnitsDescriptionID
Host windingChoice: HV / LVHV—Which winding's turns ratio the tap sets. Only that winding's WINDV column in the load-flow record deviates from 1.0; the other stays at nominal.tap_host_winding
Tap ratio (pu)Number1—The host winding's turns ratio in pu of its rated voltage (1.0 = nominal turns). Fixed: held for the whole run. Variable: the value at t = 0, before `tap_cmd` takes over. Also seeds the load-flow WINDV column on the host winding.tap_init_pu
Time constant (s)Number1—First-order time constant (seconds) used to ramp the host winding's effective ratio toward `tap_cmd` after each step. The EMT model applies the lag exp(-h/τ) per step.tap_time_constant_s
Tap signal nameTexttap—Name of the published signal that drives the tap command (in pu of nominal). The named input is always 1-step delayed — no algebraic-loop risk even when the source transitively depends on this transformer's voltage. Leave empty to disable the binding (the lag still runs from the initial value).tap_cmd_signal_name

Grounding ​

ParameterTypeDefaultUnitsDescriptionID
HV neutral groundingChoice: Solidly grounded / Grounded via Rn + jXnSolidly grounded—Grounding of the HV wye neutral when `HV neutral` = Grounded. `Solid`: the star point is bonded directly to ground (no neutral impedance). `Impedance`: grounded through a neutral resistor / reactor Rn + jXn — the terminal zero-sequence impedance gains 3·(Rn + jXn).hv_grounding
HV Rn (pu)Number0—HV neutral-grounding resistance, per-unit on the HV-winding base (Z_base_HV = V_HV_winding² / (S_rated / 3)). Adds 3·Rn to the terminal zero-sequence impedance.hv_rn_pu
HV Xn (pu)Number0—HV neutral-grounding reactance, per-unit on the HV-winding base. Adds 3·Xn to the terminal zero-sequence impedance.hv_xn_pu
LV neutral groundingChoice: Solidly grounded / Grounded via Rn + jXnSolidly grounded—Grounding of the LV wye neutral when `LV neutral` = Grounded. `Solid`: bonded directly to ground. `Impedance`: grounded through Rn + jXn referred to the LV-winding base.lv_grounding
LV Rn (pu)Number0—LV neutral-grounding resistance, per-unit on the LV-winding base (Z_base_LV = V_LV_winding² / (S_rated / 3)).lv_rn_pu
LV Xn (pu)Number0—LV neutral-grounding reactance, per-unit on the LV-winding base.lv_xn_pu

Saturation ​

ParameterTypeDefaultUnitsDescriptionID
DefinitionChoice: Exponential (Asat/Bsat) / SE points (SE1.0/SE1.2) / Two-slope (air-core)Exponential (Asat/Bsat)—How the core-saturation curve is specified. `Exponential` enters the coefficients Asat / Bsat directly. `SE points` enters the two datasheet saturation factors SE(1.0) and SE(1.2); the exponential is fit through them — both end up as the same Ssat(ψ) = Asat·exp(Bsat·(ψ − ψT1)) curve internally. `Two-slope (air-core)` instead uses the piecewise-linear λ–i characteristic: unsaturated L_m below the knee ψT1, air-core L_air above it. Pick the exponential form for steady-state over-excitation near 1.0–1.2 pu (that is the range it is fitted over); pick two-slope for energization / inrush studies, where the flux swings to nearly 2 pu and the answer is governed by how close the saturated inductance gets to air-core — a regime the exponential does not extrapolate into sensibly.sat_definition
AsatNumber0.03—Exponential saturation coefficient A: the saturation function is Ssat(ψ) = Asat·exp(Bsat·(ψ − ψT1)) for per-unit magnetizing flux ψ above the knee ψT1, else 0. The saturated magnetizing inductance is L_m = L_m,unsat / (1 + Ssat). 0 disables saturation.Asat
BsatNumber7—Exponential saturation coefficient B (1/pu-flux): controls how sharply saturation increases with magnetizing flux above ψT1.Bsat
SE(1.0)Number0.1—Open-circuit saturation factor at 1.0 pu flux: the fractional extra magnetizing current (vs. the air-gap line) needed to reach 1.0 pu. Typical 0.05–0.15.SE10
SE(1.2)Number0.3—Open-circuit saturation factor at 1.2 pu flux. Must exceed SE(1.0). Typical 0.2–0.5. With SE(1.0) it fixes Bsat = ln(SE12/SE10)/0.2 and Asat = SE10/exp(Bsat·(1.0 − ψT1)).SE12
L air-core (pu)Number0.2—Saturated (air-core) inductance in per-unit on the transformer base — the slope of the λ–i characteristic once the core is over the knee. Physically the winding's inductance with the iron gone, so it is set by winding geometry and lands near the leakage reactance: typical values are 1–4 × x_hv_lv_pu, i.e. roughly 0.1–0.5 pu. This single number governs the peak inrush current, because above the knee the energization loop is just the source impedance plus leakage plus L_air.l_air_pu
ψ knee (pu)Number1.2—Flux linkage (pu) at which the λ–i characteristic breaks from L_m to the air-core slope. Unlike the exponential form's ψT1 — a curve-fitting threshold that can sit below rated flux because the exponential is still negligible there — this is a hard break, so it MUST be above the transformer's normal operating flux or the unit saturates every cycle in ordinary service. Real cores knee over at 1.1–1.25 pu; values below 1.0 are almost certainly a mistake.psi_knee_pu
ψT1 (pu)Number0.8—Magnetizing-flux threshold (pu) below which the exponential curve is clamped to Ssat = 0. This is the fitting origin of the exponential, not a physical knee — the standard 0.8 sits below rated flux and is harmless there because Ssat(0.8) = 0 and grows smoothly.psiT1

Monitoring ​

ParameterTypeDefaultUnitsDescriptionID
HV name ATextI_HVa—Signal name for the HV-side Phase A current. Blank skips this phase.i_hv_name_a
HV name BTextI_HVb—Signal name for the HV-side Phase B current.i_hv_name_b
HV name CTextI_HVc—Signal name for the HV-side Phase C current.i_hv_name_c
LV name ATextI_LVa—Signal name for the LV-side Phase A current.i_lv_name_a
LV name BTextI_LVb—Signal name for the LV-side Phase B current.i_lv_name_b
LV name CTextI_LVc—Signal name for the LV-side Phase C current.i_lv_name_c
Mag name ATextImagA—Signal name for the Phase A magnetising current.i_mag_name_a
Mag name BTextImagB—Signal name for the Phase B magnetising current.i_mag_name_b
Mag name CTextImagC—Signal name for the Phase C magnetising current.i_mag_name_c
Flux name ATextPsiA—Signal name for the Phase A core flux linkage (pu). Blank skips this phase.flux_name_a
Flux name BTextPsiB—Signal name for the Phase B core flux linkage (pu).flux_name_b
Flux name CTextPsiC—Signal name for the Phase C core flux linkage (pu).flux_name_c

Observables ​

Default nameKindRecorded whenDescriptionID
set by HV name ASignalMeasure HV current is onHV-side Phase A current (A). `line` mode reports the current into the HV_a port; `winding` mode reports the current through the HV winding (rotated to the Δ winding loop for D connection). Positive into the HV terminal for '+ve in' (default); the other direction flips the sign.i_HV_a
set by HV name BSignalMeasure HV current is oni_HV_b
set by HV name CSignalMeasure HV current is oni_HV_c
set by LV name ASignalMeasure LV current is oni_LV_a
set by LV name BSignalMeasure LV current is oni_LV_b
set by LV name CSignalMeasure LV current is oni_LV_c
set by Mag name ASignalMeasure mag current is oni_mag_a
set by Mag name BSignalMeasure mag current is oni_mag_b
set by Mag name CSignalMeasure mag current is oni_mag_c
set by Flux name ASignalMeasure core flux is onPhase A core (magnetizing) flux linkage, in pu of the peak HV-winding flux base. 1.0 pu is the peak flux a rated sinusoidal winding voltage sustains at f_rated, so the knee ψT1 and this signal are directly comparable.psi_mag_a
set by Flux name BSignalMeasure core flux is onpsi_mag_b
set by Flux name CSignalMeasure core flux is onpsi_mag_c

Used in samples ​