Appearance
PQ Load (3-phase)
Three-phase static load carrying both an EMT voltage-dependent model AND a load-flow PL/QL row. The load_type selects how the drawn P and Q vary with the terminal voltage V around the nominal V_nom: Constant Power (P,Q held), Constant Current (P,Q ∝ V), Constant Impedance (P,Q ∝ V²), or ZIP (a polynomial blend P = P₀·[Zp·u² + Ip·u + Pp], u = V/V_nom, six independent fractions for P and Q). The EMT side is modelled as a per-phase parallel conductance G(V) and inductance L(V) to ground; the per-step terminal RMS voltage is tracked over a 1/f window and the non-impedance terms are re-injected as a Norton correction each step. A low-voltage cutoff reverts the constant-power / constant-current terms to constant-impedance below v_cutoff_pu so the draw stays finite during faults. The load-flow side stays a textbook constant-power PL/QL model; the two converge exactly when the solved bus voltage equals v_nom_v. Optional per-phase current monitoring and a low-pass-filtered P/Q monitor (Akagi instantaneous power, user-selectable units) publish observables. An optional in-line breaker (a ganged 3-pole switch) can disconnect the load from the bus, driven either by a list of toggle times or by a named command signal; its initial state is drawn on the canvas.
Category: Three-Phase / Passive
Ports
| Port | Kind | Signal | Notes |
|---|---|---|---|
bus | Three-phase terminal | — |
Parameters
Config
| Parameter | Type | Default | Units | Description | ID |
|---|---|---|---|---|---|
| P | Number | 10 | MW (also W, kW) | 3-phase real-power demand at V_nom. Pick a unit from the dropdown (stored canonically in watts). Drives the load-flow PL column and the EMT model's nominal real draw. Positive = drawn from the bus. | p_w |
| Q | Number | 3 | MVAr (also VAr, kVAr) | 3-phase reactive-power demand at V_nom. Pick a unit from the dropdown (stored canonically in vars). Positive = inductive (L > 0); negative = capacitive (v1 EMT collapses |Q| to inductive with a warning). Drives QL and the EMT susceptance. | q_var |
| V nom (LL) | Number | 13800 | V (also kV, pu) | Line-to-line RMS voltage at which (P, Q) are specified. Pick a unit from the dropdown (stored canonically in volts); pu multiplies by V_base from the Units tab. The EMT voltage-dependence ratio is u = |V| / V_nom; EMT and PF match exactly when |V| = V_nom. | v_nom_v |
| f rated | Number | 60 | — | System frequency (Hz). Sizes the equivalent inductance (L = X / 2πf) and the 1/f window used to track the terminal RMS voltage for the voltage-dependence. | f_rated_hz |
| Load type | Choice: Constant Power (P) / Constant Current (I) / Constant Impedance (Z) / ZIP | Constant Impedance (Z) | — | How the drawn P and Q vary with terminal voltage V (u = V/V_nom). Constant Power: P,Q held flat (∝ u⁰). Constant Current: P,Q ∝ u. Constant Impedance: P,Q ∝ u² (fixed admittance — the legacy model). ZIP: polynomial blend P₀·[Zp·u² + Ip·u + Pp] with six independent Z/I/P fractions on the ZIP tab. | load_type |
| Low-V cutoff (pu) | Number | 0.7 | — | Below this voltage (per-unit on V_nom) the constant-power and constant-current terms revert to constant impedance so the current draw stays finite during deep sags / faults (I ∝ 1/V would otherwise diverge as V→0). Constant-impedance loads ignore this. Typical 0.6–0.8. | v_cutoff_pu |
| Measure current | Choice: Off / On | Off | — | Emit per-phase load currents (positive = into the load) as observables. Signal names are on this row; blank skips a phase. | measure_current |
| Positive direction | Choice: +ve in / +ve out | +ve in | — | Sign convention for this current. '+ve in' (default) is positive when current flows into the load from the bus, on every phase. '+ve out' flips the sign. | current_dir |
| Monitor P/Q | Choice: Off / On | Off | — | Emit measured real (P) and reactive (Q) power drawn by the load as observables. Uses the instantaneous Akagi form, low-pass filtered with the time constant on the Power Monitoring tab to reject 2ω ripple. Names and units on the Power Monitoring tab. | monitor_pq |
| Breaker | Choice: None / Time Triggered / Signal Triggered | None | — | Optional in-line breaker between the bus terminal and the load (a ganged 3-pole switch — all three phases open/close together). None: the load is permanently connected. Time Triggered: the breaker toggles open↔closed at each time listed on the Breaker tab. Signal Triggered: a named signal commands the breaker (> 0 = closed, ≤ 0 = open). While the breaker is open the load is disconnected from the bus (draws ~0 current); load-flow P/Q is unaffected by the breaker. | breaker |
| Initial state | Choice: Open / Closed | Closed | — | Breaker state at t = 0, and the symbol drawn on the canvas (Closed = arm bridges the contacts, load connected; Open = arm lifted, load disconnected). For Time Triggered this is the state before the first trigger time; for Signal Triggered it holds for the first step until the command signal is read. | breaker_initial_state |
Breaker
| Parameter | Type | Default | Units | Description | ID |
|---|---|---|---|---|---|
| Trigger time(s) | Text | (empty) | — | Comma-separated trigger times in seconds, e.g. `2` or `2,4,6`. The breaker toggles state (open↔closed) at each time, starting from the Initial state. Blank = never toggles (the breaker stays at the Initial state for the whole run). | breaker_times |
| Trigger signal | Text | (empty) | — | Name of a published signal that commands the breaker: > 0 = closed, ≤ 0 = open. Resolved by name the same way as a GoTo output, a labelled wire, or another component's observable, and read 1-step delayed. Blank holds the breaker at the Initial state. | breaker_signal_name |
| Breaker state name | Text | (empty) | — | Optional. Name for an observable reporting the breaker state (1 = closed, 0 = open) so it can be plotted. Blank = not published. | breaker_state_name |
ZIP
| Parameter | Type | Default | Units | Description | ID |
|---|---|---|---|---|---|
| Zp (real, ∝V²) | Number | 1 | — | Constant-impedance fraction of the REAL power. The three real fractions Zp + Ip + Pp are normalised to sum to 1 internally. | zp_frac |
| Ip (real, ∝V) | Number | 0 | — | Constant-current fraction of the REAL power. | ip_frac |
| Pp (real, ∝V⁰) | Number | 0 | — | Constant-power fraction of the REAL power. | pp_frac |
| Zq (react, ∝V²) | Number | 1 | — | Constant-impedance fraction of the REACTIVE power. The three reactive fractions Zq + Iq + Pq are normalised to sum to 1 internally. | zq_frac |
| Iq (react, ∝V) | Number | 0 | — | Constant-current fraction of the REACTIVE power. | iq_frac |
| Pq (react, ∝V⁰) | Number | 0 | — | Constant-power fraction of the REACTIVE power. | pq_frac |
Current Monitoring
| Parameter | Type | Default | Units | Description | ID |
|---|---|---|---|---|---|
| Current name A | Text | Ia | — | Signal name for Phase A load current. | i_name_a |
| Current name B | Text | Ib | — | Signal name for Phase B load current. | i_name_b |
| Current name C | Text | Ic | — | Signal name for Phase C load current. | i_name_c |
Power Monitoring
| Parameter | Type | Default | Units | Description | ID |
|---|---|---|---|---|---|
| P/Q filter τ (sec) | Number | 2 | — | Low-pass filter time constant for the measured P and Q. Smaller tracks transients; larger gives a cleaner steady-state but slower response. Default 2 s rejects 50/60 Hz ripple strongly. Set 0 for the raw instantaneous values. | pq_time_constant |
| P signal name | Text | P | — | Signal name for the filtered real power P drawn by the load. Blank = skip. | p_signal_name |
| P unit | Choice: W / kW / MW | MW | — | Unit the published P observable is scaled to. | p_monitor_unit |
| Q signal name | Text | Q | — | Signal name for the filtered reactive power Q drawn by the load. Blank = skip. | q_signal_name |
| Q unit | Choice: VAr / kVAr / MVAr | MVAr | — | Unit the published Q observable is scaled to. | q_monitor_unit |
Units
| Parameter | Type | Default | Units | Description | ID |
|---|---|---|---|---|---|
| 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 Current name A | Signal | Measure current is on | Phase A load current (A). Positive = current drawn from the bus into the load. The direction switch keeps this sign by default and flips it the other way. | branchCurrent_a |
| set by Current name B | Signal | Measure current is on | Phase B load current (A). Positive into the load from the bus, on every phase for '+ve in' (default); the other direction flips the sign. | branchCurrent_b |
| set by Current name C | Signal | Measure current is on | Phase C load current (A). Positive into the load from the bus, on every phase for '+ve in' (default); the other direction flips the sign. | branchCurrent_c |
| set by P signal name | Signal | Monitor P/Q is on | Measured real power P drawn by the load. Sum of instantaneous v·i across the three phases, low-pass filtered with τ = pq_time_constant, scaled to the chosen P unit (W / kW / MW). | p_filtered |
| set by Q signal name | Signal | Monitor P/Q is on | Measured reactive power Q drawn by the load. 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). Positive = inductive. | q_filtered |
| set by Breaker state name | Signal | Breaker is on | Breaker state: 1 = closed (load connected), 0 = open (load disconnected). Only meaningful when a breaker is enabled. | breaker_state |