Skip to content

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 ​

PortKindSignalNotes
busThree-phase terminal—
nElectrical terminal—Shown when Connection is Y (ext N)
in_aControl inputRealShown when Source control is Instantaneous (i_a, i_b, i_c inputs)
in_bControl inputRealShown when Source control is Instantaneous (i_a, i_b, i_c inputs)
in_cControl inputRealShown when Source control is Instantaneous (i_a, i_b, i_c inputs)

Parameters ​

Config ​

ParameterTypeDefaultUnitsDescriptionID
Source controlChoice: 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
INumber1A (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
fNumber60—Frequency of the balanced sinusoid (Hz).frequency
φNumber0deg (also rad)Phase A reference angle. B / C apply the 120° offset (sign from `sequence`). Degrees or radians via the unit dropdown.phase
SequenceChoice: ABC (+) / ACB (-)ABC (+)—Phase sequence: ABC (positive) or ACB (negative).sequence
ConnectionChoice: 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_shuntNumber0Ω (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_rampNumber0s (also ms)Current ramp-up time. The amplitude scales linearly from 0 to full over t_ramp, then holds. 0 disables.ramp_time
Measure currentChoice: Off / OnOff—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 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

Signal Names ​

ParameterTypeDefaultUnitsDescriptionID
Phase A current nameTextIaA (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 nameTextIbA (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 nameTextIcA (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 nameKindRecorded whenDescriptionID
set by Phase A current nameSignalMeasure current is onPhase 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 nameSignalMeasure current is onPhase 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 nameSignalMeasure current is onPhase 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