Skip to content

Voltage Source (3-phase) ​

Three-phase voltage source with a configurable Thévenin impedance topology (Ideal / R resistor / R-L series / R∥L parallel / R-R∥L), optional zero-sequence neutral grounding impedance (R-L or R∥L) on Y (gnd N) AND Y (ext N) connections, optional harmonic injection (up to five terms), and optional P/Q monitoring (measured either at the terminal or at the internal EMF) with a user-configurable low-pass filter time constant. Monitored quantities carry their own unit selectors: per-phase current (A / kA), P (W / kW / MW), and Q (VAr / kVAr / MVAr). Generates a balanced fundamental sinusoid (configurable amplitude, frequency, and phase reference). The Impedance tab exposes R (series) and R (parallel) independently — the topology selector enables only the relevant one(s). Inductors accept H, pu, or X (Ω at the source's own frequency). Each impedance / zero-sequence parameter carries its own unit selector; the auto-injected Units tab carries V_base / S_base when any pu selection is in use (frequency is taken from this source's frequency parameter).

Category: Three-Phase / Sources

Ports ​

PortKindSignalNotes
busThree-phase terminal—
nElectrical terminal—Shown when Connection is Y (ext N)
magControl inputRealShown when Source control is Modulated (|V|, angle, f inputs) and Magnitude input is On
angleControl inputRealShown when Source control is Modulated (|V|, angle, f inputs) and Angle input is On
freqControl inputRealShown when Source control is Modulated (|V|, angle, f inputs) and Frequency input is On
in_aControl inputRealShown when Source control is Instantaneous (v_a, v_b, v_c inputs)
in_bControl inputRealShown when Source control is Instantaneous (v_a, v_b, v_c inputs)
in_cControl inputRealShown when Source control is Instantaneous (v_a, v_b, v_c inputs)

Parameters ​

Config ​

ParameterTypeDefaultUnitsDescriptionID
Source controlChoice: Internal / Modulated (|V|, angle, f inputs) / Instantaneous (v_a, v_b, v_c inputs)Internal—Where the EMF comes from. `Internal` = the balanced sinusoid set by the fields below. `Modulated` = the same sinusoid with its magnitude (pu of V_mag), angle offset (rad added to V_ang) and/or frequency (pu of f) taken from control inputs enabled on the Control tab — a grid simulator for voltage dips, phase jumps and frequency ramps, or the voltage behind a grid-forming converter. `Instantaneous` = the `a` / `b` / `c` control inputs ARE the phase-to-neutral EMFs in volts (average-value converter models, unbalanced or negative-sequence control). Control inputs act one time step late (the standard control-to-network delay).source_control
V_magNumber230kV (also V, pu)Fundamental line-to-line RMS voltage. Each phase is driven at V_LN_peak = V_LL_rms·√(2/3); the 120° offset is applied internally. In Modulated mode this is the 1.0 pu magnitude the `mag` input scales.voltage
fNumber60—Fundamental frequency (Hz). Drives the sinusoid generator and the pu → henries conversion when inductive elements are entered in pu.frequency
V_angNumber0deg (also rad)Phase A reference angle. B / C apply the 120° offset (sign from `sequence`). Degrees or radians via the unit dropdown. In Modulated mode the `angle` input (rad) is added to it.phase
ConnectionChoice: Y (ext N) / Y (int N) / Y (gnd N) / Δ (delta)Y (int N)—Winding connection. `Y (ext N)` exposes the star point N via the `n` port (directly, or through Z_n if set). `Y (int N)` floats N internally. `Y (gnd N)` ties N to ground (optionally via Z_n). `Δ` is delta — no neutral.connection
SequenceChoice: ABC (+) / ACB (-)ABC (+)—Phase sequence: ABC (positive) or ACB (negative).sequence
WaveformChoice: AC / HarmonicsAC—Pure sinusoidal AC, or AC + user-defined harmonics. Picking `harmonics` reveals the Harmonics tab. Internal source control only.waveform
ImpedanceChoice: Ideal / R / R-L / R∥L / R-R∥LR-L—Per-phase Thévenin impedance between EMF and bus. `Ideal` = stiff source. `R` = pure resistor (no inductance). `R-L` = series R+L. `R∥L` = parallel R+L. `R-R∥L` = pre-series R then a parallel R∥L. Fields appear on the Impedance tab; entering 0 drops that element.impedance_type
Zero-Seq ZChoice: None / R-L / R∥LNone—Neutral-grounding impedance Z_n between N and the neutral terminal (ground in `gnd N`, the `n` port in `ext N`). `None` = direct tie. `R-L` = series R+L. `R∥L` = parallel R∥L. Active for `gnd N` / `ext N`.zero_seq_type
t_rampNumber0—Voltage ramp-up time (s). Amplitude scales 0 → full linearly over `t_ramp`, then holds. Use ~1 fundamental period on HV sources to avoid t=0 inrush. 0 disables.ramp_time
Measure currentChoice: Off / OnOff—Emit per-phase source branch current as observables. Signal names are on this row.measure_current
Positive directionChoice: +ve in / +ve out+ve out—Sign convention for this current. '+ve out' (default) is positive when current flows out of the bus terminals into the network, on every phase. '+ve in' flips the sign.current_dir
Monitor P/QChoice: Off / OnOff—Emit real (P, W) and reactive (Q, VAR) power as observables. Uses the instantaneous Buchholz / Akagi form, low-pass filtered with `pq_time_constant` to reject 2ω ripple. Signal names are on this row.monitor_pq
P/Q filter τ (sec)Number2—Low-pass filter time constant for P/Q. Smaller tracks transients; larger gives a cleaner steady-state but slower response. Default 2 s rejects 50/60 Hz ripple by ~50 dB.pq_time_constant
P/Q measured atChoice: Terminal / Internal sourceTerminal—Where the P/Q monitor reads voltage. `Terminal` uses the solved bus voltage (power delivered into the network at the source's terminals). `Internal source` uses the internal EMF behind the Thévenin impedance (the total power the source generates) — the difference between the two is the I²R / I²X loss in the source impedance. With `Ideal` impedance the two coincide.pq_location

Impedance ​

ParameterTypeDefaultUnitsDescriptionID
R (parallel)Number0.001Ω (also pu)Parallel resistive element of the Thévenin impedance. Active for `R∥L` (the parallel R) and `R-R∥L` (the inner parallel R; see `R (series)` for the pre-series resistor). Set 0 to short the parallel branch (the topology then collapses to the L-only or R-pre-only case). Independent Ω / pu selector.r_parallel
LNumber0H (also Ω, pu)Inductive Thévenin element. `R-L` series L; `R∥L` parallel L; `R-R∥L` inner parallel L. Pick the unit: H (henries), Ω (reactance at this source's `frequency`), or pu (X_pu on V_base / S_base — the source's own `frequency` is used; no extra frequency input required). 0 drops the element.l_main
R (series)Number0.001Ω (also pu)Series resistive element of the Thévenin impedance. Active for `R` (the sole resistor), `R-L` (the series R between EMF and bus) and `R-R∥L` (the pre-series resistor: EMF → R(series) → R∥L → bus). Set 0 to drop the element. Independent Ω / pu selector.r_series

Zero-Sequence ​

ParameterTypeDefaultUnitsDescriptionID
R₀Number0.001Ω (also pu)Resistive element of Z_n (neutral-grounding impedance). `R-L` series R; `R∥L` parallel R. 0 drops the element. Independent Ω / pu selector.r_zero
L₀Number0H (also Ω, pu)Inductive element of Z_n. Pick the unit: H (henries), X (Ω, reactance at this source's `frequency`), or pu (X_pu on V_base / S_base — the source's own `frequency` is used). 0 drops the element.l_zero

Control ​

ParameterTypeDefaultUnitsDescriptionID
Magnitude inputChoice: Off / OnOff—Expose the `mag` input: the EMF magnitude in pu of V_mag (1.0 = nominal). Off keeps V_mag.mag_input
Angle inputChoice: Off / OnOff—Expose the `angle` input: an offset in radians added to V_ang (0 = nominal). Off keeps V_ang.angle_input
Frequency inputChoice: Off / OnOff—Expose the `freq` input: the frequency in pu of f (1.0 = nominal), integrated into the source angle so a frequency step never jumps the phase. Off keeps f.freq_input

Harmonics ​

ParameterTypeDefaultUnitsDescriptionID
Number of harmonicsChoice: None / 1 / 2 / 3 / 4 / 5None—Extra harmonic terms (1-5) added to the fundamental. Each k contributes mag·sin(kωt + angle + k·offset_i). Triplens are co-phasal; 5 rotates backward; 7 forward.num_harmonics
h1 orderInteger3—Harmonic order (integer multiple of f). Common: 3 (triplen), 5 (-), 7 (+).h1_order
h1 magnitude (% of V_mag)Number0—Magnitude as % of V_mag (5.0 = 5%).h1_magnitude
h1 angle (deg)Number0—Extra phase angle (deg), added to the per-phase 120° × order offset.h1_angle
h2 orderInteger5—h2_order
h2 magnitude (% of V_mag)Number0—h2_magnitude
h2 angle (deg)Number0—h2_angle
h3 orderInteger7—h3_order
h3 magnitude (% of V_mag)Number0—h3_magnitude
h3 angle (deg)Number0—h3_angle
h4 orderInteger11—h4_order
h4 magnitude (% of V_mag)Number0—h4_magnitude
h4 angle (deg)Number0—h4_angle
h5 orderInteger13—h5_order
h5 magnitude (% of V_mag)Number0—h5_magnitude
h5 angle (deg)Number0—h5_angle

Signal Names ​

ParameterTypeDefaultUnitsDescriptionID
Phase A current nameTextIaA (also kA)Signal name for Phase A branch current. Blank = skip this phase. Pick the unit from the dropdown; the published value is scaled to it.current_name_a
Phase B current nameTextIbA (also kA)Signal name for Phase B branch current. Blank = skip this phase. Pick the unit from the dropdown; the published value is scaled to it.current_name_b
Phase C current nameTextIcA (also kA)Signal name for Phase C branch current. Blank = skip this phase. Pick the unit from the dropdown; the published value is scaled to it.current_name_c
P signal nameTextPMW (also W, kW)Signal name for filtered real-power P. Blank = skip. Pick the unit from the dropdown; the published value is scaled to it.p_signal_name
Q signal nameTextQMVAr (also VAr, kVAr)Signal name for filtered reactive-power Q. Blank = skip. Pick the unit from the dropdown; the published value is scaled to it.q_signal_name

Power Flow ​

ParameterTypeDefaultUnitsDescriptionID
Pset (MW)Number0—Scheduled real-power setpoint (MW). PSSE GENERATOR PG column. Positive = inject. Used by the solver as the real-power schedule on a PV or PQ bus; ignored on a slack bus (the source swings to balance the system). Power-flow only — separate from the EMT settings on Config. The regulated voltage is NOT set here: it comes from the connected bus's voltage (set on the bus, by type — slack / PV).pf_p_mw
Qset (MVAr)Number0—Scheduled reactive-power setpoint (MVAr). PSSE GENERATOR QG column. Positive = inject (over-excited). Used by the solver as the reactive-power schedule on a PQ bus; on a PV bus Q is solved (this is only a starting estimate), and on a slack bus it is ignored (the source swings).pf_q_mvar
P (MW)Number0—Solved real-power output (MW) from the most recent load flow — the source's actual dispatch, written by 'Apply load-flow results'. Read-only result: overwritten on the next apply, and not exported to PSSE (the schedule lives in Pset).pf_p_solved_mw
Q (MVAr)Number0—Solved reactive-power output (MVAr) from the most recent load flow — the source's actual dispatch, written by 'Apply load-flow results'. Read-only result: overwritten on the next apply, and not exported to PSSE (the schedule lives in Qset).pf_q_solved_mvar

Units ​

ParameterTypeDefaultUnitsDescriptionID
S_base (MVA)Number100—System base apparent power in MVA. Used by `pu` impedance / admittance conversions in this component's `computations` block.S_base
V_base (kV)Number230—Base RMS line-to-line voltage in kV. Used by `pu` impedance / admittance conversions in this component's `computations` block.V_base

Observables ​

Default nameKindRecorded whenDescriptionID
set by Phase A current nameSignalMeasure current is onPhase A source branch current, scaled to the chosen current unit (A / kA). Positive out of the bus terminals into the network, on every phase for '+ve out' (default); the other direction flips the sign.branchCurrent_a
set by Phase B current nameSignalMeasure current is onPhase B source branch current, scaled to the chosen current unit (A / kA). Positive out of the bus terminals into the network, on every phase for '+ve out' (default); the other direction flips the sign.branchCurrent_b
set by Phase C current nameSignalMeasure current is onPhase C source branch current, scaled to the chosen current unit (A / kA). Positive out of the bus terminals into the network, on every phase for '+ve out' (default); the other direction flips the sign.branchCurrent_c
set by P signal nameSignalMonitor P/Q is onSource real-power output P. Sum of instantaneous v_LN·i across the three phases, low-pass filtered with τ = pq_time_constant, scaled to the chosen P unit (W / kW / MW). v_LN is the terminal bus voltage (`pq_location = terminal`) or the internal EMF behind the Thévenin impedance (`pq_location = source`).p_filtered
set by Q signal nameSignalMonitor P/Q is onSource reactive-power output Q. Buchholz / Akagi instantaneous reactive power (1/√3)·(v_bc·i_a + v_ca·i_b + v_ab·i_c), low-pass filtered with τ = pq_time_constant, scaled to the chosen Q unit (VAr / kVAr / MVAr). The v_ab/v_bc/v_ca are formed from the terminal bus voltage (`pq_location = terminal`) or the internal EMF (`pq_location = source`).q_filtered

Used in samples ​