Appearance
Current Source (3-phase)
Three-phase current source. Drives a balanced sinusoidal current set (configurable RMS magnitude, frequency, phase and sequence) out of the bus terminals, whatever voltage that takes, or — with Source control = Instantaneous — the three phase currents commanded by the a / b / c control inputs in amps (one time step late, the standard control-to-network delay). The return is ground (Y gnd N) or the n port (Y ext N); an optional per-phase shunt resistance makes it a Norton source. Use it for average-value converter models (grid-following inverters as current sources), measured-load playback, harmonic or negative-sequence current injection. Monitors the delivered per-phase currents (A / kA). Takes no part in the load flow.
Category: Three-Phase / Sources
Ports
| Port | Kind | Signal | Notes |
|---|---|---|---|
bus | Three-phase terminal | — | |
n | Electrical terminal | — | Shown when Connection is Y (ext N) |
in_a | Control input | Real | Shown when Source control is Instantaneous (i_a, i_b, i_c inputs) |
in_b | Control input | Real | Shown when Source control is Instantaneous (i_a, i_b, i_c inputs) |
in_c | Control input | Real | Shown when Source control is Instantaneous (i_a, i_b, i_c inputs) |
Parameters
Config
| Parameter | Type | Default | Units | Description | ID |
|---|---|---|---|---|---|
| Source control | Choice: Internal / Instantaneous (i_a, i_b, i_c inputs) | Internal | — | Where the phase currents come from. `Internal` = a balanced sinusoid set by the fields below. `Instantaneous` = the `a` / `b` / `c` control inputs ARE the phase currents in amps (average-value converter models, measured-load playback, negative-sequence injection). Control inputs act one time step late (the standard control-to-network delay) and read 0 on the first step. | source_control |
| I | Number | 1 | A (also kA) | Per-phase RMS current of the balanced sinusoid. Each phase carries √2·I·sin(2πft + φ + offset); the 120° offsets follow `sequence`. Positive current leaves the bus terminal into the network. | current |
| f | Number | 60 | — | Frequency of the balanced sinusoid (Hz). | frequency |
| φ | 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. | phase |
| Sequence | Choice: ABC (+) / ACB (-) | ABC (+) | — | Phase sequence: ABC (positive) or ACB (negative). | sequence |
| Connection | Choice: Y (gnd N) / Y (ext N) | Y (gnd N) | — | Where the phase currents return. `Y (gnd N)` = each phase injects from ground into its bus terminal. `Y (ext N)` = the return is the `n` port, so the three currents must close through whatever is wired there. | connection |
| R_shunt | Number | 0 | Ω (also kΩ) | Per-phase resistance from each bus terminal to the neutral (a Norton source). 0 = ideal current source with no internal path; the network must then give every phase a path. | shunt_resistance |
| t_ramp | Number | 0 | s (also ms) | Current ramp-up time. The amplitude scales linearly from 0 to full over t_ramp, then holds. 0 disables. | ramp_time |
| Measure current | Choice: Off / On | Off | — | Emit the per-phase current delivered out of the bus terminals (the source current less the shunt 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 |
Signal Names
| Parameter | Type | Default | Units | Description | ID |
|---|---|---|---|---|---|
| Phase A current name | Text | Ia | A (also kA) | Signal name for the Phase A delivered 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 the Phase B delivered 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 the Phase C delivered current. Blank = skip this phase. Pick the unit from the dropdown; the published value is scaled to it. | current_name_c |
Observables
| Default name | Kind | Recorded when | Description | ID |
|---|---|---|---|---|
| set by Phase A current name | Signal | Measure current is on | Phase A current delivered out of the bus terminal (source current less the shunt current), scaled to the chosen 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 current delivered out of the bus terminal (source current less the shunt current), scaled to the chosen 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 current delivered out of the bus terminal (source current less the shunt current), scaled to the chosen 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 |