master:source3 parametersPSCAD Three Phase Voltage Source Model 1
Every parameter of the PSCAD Three Phase Voltage Source Model 1 (master:source3): 50 names, with the unit, the default and the meaning PSCAD gives each one. Copy a name into parameters().
What master:source3 is
The three phase voltage source, model 1, the usual Thevenin equivalent of a grid in a PSCAD case.
- Definition
master:source3- PSCAD name
- Three Phase Voltage Source Model 1
- Category
- Sources
- Parameters
- 50, in 5 groups; 29 carry a unit
- Read from
- PSCAD 5.0.0, 2026-11-07
Most used master:source3 parameters
| Parameter | Unit | Description |
|---|---|---|
Es | kV | Voltage Magnitude (L-L, RMS)magnitude, line to line RMS |
F0 | Hz | Frequencyfrequency |
Ph | deg | Phasephase |
MVA | MVA | Base MVA (3-phase)base MVA |
Ctrl | · | Source Control:fixed, or controlled from signals |
Read and write master:source3 in Python
import mhi.pscad
pscad = mhi.pscad.connect() # the PSCAD that is open; launch() starts one
project = pscad.project("my_case") # a case loaded in the workspace
for comp in project.find_all("master:source3"): # the exact definition, namespace first
params = comp.parameters() # every parameter, as PSCAD holds it
print(str(params["Es"])) # Voltage Magnitude (L-L, RMS), in kV
comp = project.find_all("master:source3")[0]
comp.parameters(Es="460 [kV]") # a value that carries a unit is written with it
- A parameter is named exactly as in the table, letter case included:
parameters()gives every one of them in a dictionary, and a name the component does not have is refused. - A value that carries a unit comes back as a number whose unit is only in its text, so read it as text first (
str(...)) or the unit is lost. PSCAD keeps a written unit as it is given:"2500 [mohm]"stays in mohm. - A Choice is read and written as its symbol (the capitals in "Written as"), not as the words PSCAD shows in the dialog.
find_all()takes the exact definition only. A wildcard or a bare name withoutmaster:comes back empty; the Builder'spx_findwalks the pages for those.
The Builder's runtime does the same with the unit handled for you: px_get(comp, "Es") and px_set(...), which also records the old value so the case is put back at the end. Getting started shows them.
Configuration
| Parameter | Unit | Default | Description |
|---|---|---|---|
CtrlChoice | · | FIXED | Source Control:Choose how to control the source: fixed, external or automaticWritten as FIXED (Fixed), EXTERNAL (External), AUTO (Auto) |
ExphChoice | · | RADIANS | External Phase Input UnitExternal phase input can be entered in radians or degreesWritten as RADIANS (Radians), DEGREES (Degrees)Used when (Ctrl==2) |
ImpChoice | · | RRL_VALUES | Impedance Data Format:Impedance data can be entered as RRL values or as impedanceWritten as RRL_VALUES (RRL Values), IMPEDANCE (Impedance) |
NameText | · | Source | Source Name |
TermChoice | · | BEHIND_SOURCE_IMPEDANCE | Specified ParametersParameters could be entred as in terminal or as in behind the source impedanceWritten as BEHIND_SOURCE_IMPEDANCE (Behind the Source Impedance), AT_TERMINAL (At the Terminal)Used when Ctrl!=2 |
TypeChoice | · | R | Source Impedance Type:Choose how to represent the impedanceWritten as R, L, R_L (R//L), RR_L (R-R//L) |
ViewChoice | · | SINGLE_LINE | Graphics DisplayGraphics could be displayed in either single line view or three phase viewWritten as 3_PHASE (3 phase view), SINGLE_LINE (Single line view) |
ZSeqChoice | · | NO | Zero Seq. Differs from Positive Seq. ?Specify whether Zero sequence is different from Positive Sequence ImpedanceWritten as NO (No), YES (Yes) |
Source Control
| Parameter | Unit | Default | Description |
|---|---|---|---|
EsReal | kV | 230.0 | Voltage Magnitude (L-L, RMS)At least 0Used when (Ctrl!=2) |
FReal | Hz | 60.0 | Base FrequencyAt least 0.001 |
F0Real | Hz | 60.0 | FrequencyAt least 0Used when (Ctrl!=2) |
MVAReal | MVA | 100.0 | Base MVA (3-phase)At least 0.001 |
PCtrlChoice | · | NO | Enable Automatic Power Control?Phase angle could be controlled automatically to produce desired power outputWritten as NO (No), YES (Yes)Used when (Ctrl==3) |
PdesReal | pu | 1.0 | Desired Real Power OutUsed when (Ctrl==3)&&(PCtrl==1) |
PhReal | deg | 0.0 | PhaseRange -360 to 360Used when (Ctrl!=2) |
PinitReal | pu | 0.0 | Initial Real PowerUsed when (Term==1)&&(Ctrl!=2) |
QinitReal | pu | 0.0 | Initial Reactive PowerUsed when (Term==1)&&(Ctrl!=2) |
TcReal | s | 0.05 | Voltage Input Time ConstantAt least 0 |
TpcReal | s | 0.05 | Controller Time ConstantAt least 1E-06Used when (Ctrl==3)&&(PCtrl==1) |
TpmReal | s | 0.02 | Measurement Time ConstantAt least 1E-06Used when (Ctrl==3)&&(PCtrl==1) |
TvcReal | s | 0.05 | Controller Time ConstantAt least 1E-06Used when (Ctrl==3)&&(VCtrl==1) |
TvmReal | s | 0.02 | Measurement Time ConstantAt least 1E-06Used when (Ctrl==3)&&(VCtrl==1) |
VCtrlChoice | · | NO | Enable Automatic Voltage Control?Voltage could be controlled automatically to produce desired bus voltageWritten as NO (No), YES (Yes)Used when (Ctrl==3) |
VbaseReal | kV | 230.0 | Measurement Voltage Base (L-L, RMS)At least 0.001Used when (Ctrl==3)&&(VCtrl==1) |
VdesReal | pu | 1.0 | Desired Bus VoltageAt least 0.01Used when (Ctrl==3)&&(VCtrl==1) |
VmReal | kV | 230.0 | Base Voltage (L-L, RMS)At least 0.001 |
Internal Output Variables
| Parameter | Unit | Default | Description |
|---|---|---|---|
IaText | · | · | Name for Phase A Current [kA] |
IabcText | · | · | Name for 3 Phase Current [kA] |
IbText | · | · | Name for Phase B Current [kA] |
IcText | · | · | Name for Phase C Current [kA] |
PText | · | · | Name for PU Real Power (+Out) |
QText | · | · | Name for PU Reactive Power (+Out) |
ThetaText | · | · | Name for Source Angle [deg] |
VText | · | · | Name for PU RMS Source Volts |
Internal Impedance
| Parameter | Unit | Default | Description |
|---|---|---|---|
L0pReal | H | 0.1 | Inductance (parallel)At least 0.0001Used when (Zseq==1)&&(Imp==0)&&(PS==0) |
L0sReal | H | 0.0001 | Inductance (series)At least 0.0001Used when (Zseq==1)&&(Imp==0)&&(PS==1) |
L1pReal | H | 0.1 | Inductance (parallel)At least 0.0001Used when (Type>=2)&&(Imp==0) |
PSChoice | · | PARALLEL | Parallel or SeriesParameters could be entred as parallel or series values. However it will be modelled as equivalent parallel branches at specified conditions.Written as PARALLEL (Parallel), SERIES (Series) |
Phi0Real | deg | 80.0 | Zero Sequence Impedance Phase AngleRange 0 to 90Used when (ZSeq && Imp==1) |
Phi1Real | deg | 80.0 | Positive Seq. Impedance Phase AngleRange 0.1 to 89.9Used when (Type>=3)&&(Imp==1) |
R0pReal | ohm | 1.0 | Resistance (parallel)At least 0.001Used when (Zseq==1)&&(Imp==0)&&(PS==0) |
R0sReal | ohm | 1.0 | Resistance (series)At least 0.001Used when (Zseq==1)&&(Imp==0)&&(PS==1) |
R1pReal | ohm | 1.0 | Resistance (parallel)At least 0.001Used when (Type>=3)&&(Imp==0) |
R1sReal | ohm | 1.0 | Resistance (series)At least 0.001Used when (Type==1 || Type==4)&&(Imp==0) |
RNReal | · | 2.0 | Harm. # where phase is same as fundamentalAt least 2Used when (Type==4)&&(Imp==1) |
Z0Real | ohm | 1.0 | Zero Sequence ImpedanceAt least 0.001Used when (ZSeq && Imp==1) |
Z1Real | ohm | 1.0 | Positive Seq. ImpedanceAt least 0.001Used when (Imp==1) |
PowerFlow
| Parameter | Unit | Default | Description |
|---|---|---|---|
PF_QMAXReal | pu | 1.0 | Maximum Reactive Power Output |
PF_QMINReal | pu | -1.0 | Minimum Reactive Power Output |
qsetChoice | · | AUTO | Q SetWritten as MANUAL (Manual), AUTO (Auto) |
Related
- All 345 definitions in the component reference
- Sweep a PSCAD parameter with Python
- PSCAD automation with Python: getting started
← master:src_ccin_3 Three Phase Current Source · master:source_3 Three Phase Voltage Source Model 2 →