Appearance
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
| Port | Kind | Signal | Notes |
|---|---|---|---|
bus | Three-phase terminal | — | |
n | Electrical terminal | — | Shown when Connection is Y (ext N) |
mag | Control input | Real | Shown when Source control is Modulated (|V|, angle, f inputs) and Magnitude input is On |
angle | Control input | Real | Shown when Source control is Modulated (|V|, angle, f inputs) and Angle input is On |
freq | Control input | Real | Shown when Source control is Modulated (|V|, angle, f inputs) and Frequency input is On |
in_a | Control input | Real | Shown when Source control is Instantaneous (v_a, v_b, v_c inputs) |
in_b | Control input | Real | Shown when Source control is Instantaneous (v_a, v_b, v_c inputs) |
in_c | Control input | Real | Shown when Source control is Instantaneous (v_a, v_b, v_c inputs) |
Parameters
Config
| Parameter | Type | Default | Units | Description | ID |
|---|---|---|---|---|---|
| Source control | Choice: 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_mag | Number | 230 | kV (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 |
| f | Number | 60 | — | Fundamental frequency (Hz). Drives the sinusoid generator and the pu → henries conversion when inductive elements are entered in pu. | frequency |
| V_ang | Number | 0 | deg (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 |
| Connection | Choice: 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 |
| Sequence | Choice: ABC (+) / ACB (-) | ABC (+) | — | Phase sequence: ABC (positive) or ACB (negative). | sequence |
| Waveform | Choice: AC / Harmonics | AC | — | Pure sinusoidal AC, or AC + user-defined harmonics. Picking `harmonics` reveals the Harmonics tab. Internal source control only. | waveform |
| Impedance | Choice: Ideal / R / R-L / R∥L / R-R∥L | R-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 Z | Choice: None / R-L / R∥L | None | — | 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_ramp | Number | 0 | — | 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 current | Choice: Off / On | Off | — | Emit per-phase source branch current as observables. Signal names are on this row. | measure_current |
| Positive direction | Choice: +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/Q | Choice: Off / On | Off | — | 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) | Number | 2 | — | 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 at | Choice: Terminal / Internal source | Terminal | — | 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
| Parameter | Type | Default | Units | Description | ID |
|---|---|---|---|---|---|
| R (parallel) | Number | 0.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 |
| L | Number | 0 | H (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) | Number | 0.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
| Parameter | Type | Default | Units | Description | ID |
|---|---|---|---|---|---|
| R₀ | Number | 0.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₀ | Number | 0 | H (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
| Parameter | Type | Default | Units | Description | ID |
|---|---|---|---|---|---|
| Magnitude input | Choice: Off / On | Off | — | Expose the `mag` input: the EMF magnitude in pu of V_mag (1.0 = nominal). Off keeps V_mag. | mag_input |
| Angle input | Choice: Off / On | Off | — | Expose the `angle` input: an offset in radians added to V_ang (0 = nominal). Off keeps V_ang. | angle_input |
| Frequency input | Choice: Off / On | Off | — | 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
| Parameter | Type | Default | Units | Description | ID |
|---|---|---|---|---|---|
| Number of harmonics | Choice: None / 1 / 2 / 3 / 4 / 5 | None | — | 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 order | Integer | 3 | — | Harmonic order (integer multiple of f). Common: 3 (triplen), 5 (-), 7 (+). | h1_order |
| h1 magnitude (% of V_mag) | Number | 0 | — | Magnitude as % of V_mag (5.0 = 5%). | h1_magnitude |
| h1 angle (deg) | Number | 0 | — | Extra phase angle (deg), added to the per-phase 120° × order offset. | h1_angle |
| h2 order | Integer | 5 | — | h2_order | |
| h2 magnitude (% of V_mag) | Number | 0 | — | h2_magnitude | |
| h2 angle (deg) | Number | 0 | — | h2_angle | |
| h3 order | Integer | 7 | — | h3_order | |
| h3 magnitude (% of V_mag) | Number | 0 | — | h3_magnitude | |
| h3 angle (deg) | Number | 0 | — | h3_angle | |
| h4 order | Integer | 11 | — | h4_order | |
| h4 magnitude (% of V_mag) | Number | 0 | — | h4_magnitude | |
| h4 angle (deg) | Number | 0 | — | h4_angle | |
| h5 order | Integer | 13 | — | h5_order | |
| h5 magnitude (% of V_mag) | Number | 0 | — | h5_magnitude | |
| h5 angle (deg) | Number | 0 | — | h5_angle |
Signal Names
| Parameter | Type | Default | Units | Description | ID |
|---|---|---|---|---|---|
| Phase A current name | Text | Ia | A (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 name | Text | Ib | A (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 name | Text | Ic | A (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 name | Text | P | MW (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 name | Text | Q | MVAr (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
| Parameter | Type | Default | Units | Description | ID |
|---|---|---|---|---|---|
| Pset (MW) | Number | 0 | — | 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) | Number | 0 | — | 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) | Number | 0 | — | 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) | Number | 0 | — | 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
| Parameter | Type | Default | Units | Description | ID |
|---|---|---|---|---|---|
| S_base (MVA) | Number | 100 | — | System base apparent power in MVA. Used by `pu` impedance / admittance conversions in this component's `computations` block. | S_base |
| V_base (kV) | Number | 230 | — | Base RMS line-to-line voltage in kV. Used by `pu` impedance / admittance conversions in this component's `computations` block. | V_base |
Observables
| Default name | Kind | Recorded when | Description | ID |
|---|---|---|---|---|
| set by Phase A current name | Signal | Measure current is on | Phase 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 name | Signal | Measure current is on | Phase 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 name | Signal | Measure current is on | Phase 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 name | Signal | Monitor P/Q is on | Source 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 name | Signal | Monitor P/Q is on | Source 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 |