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

ParameterUnitDescription
EskVVoltage Magnitude (L-L, RMS)magnitude, line to line RMS
F0HzFrequencyfrequency
PhdegPhasephase
MVAMVABase 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 without master: comes back empty; the Builder's px_find walks 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

ParameterUnitDefaultDescription
CtrlChoice·FIXEDSource Control:Choose how to control the source: fixed, external or automaticWritten as FIXED (Fixed), EXTERNAL (External), AUTO (Auto)
ExphChoice·RADIANSExternal Phase Input UnitExternal phase input can be entered in radians or degreesWritten as RADIANS (Radians), DEGREES (Degrees)Used when (Ctrl==2)
ImpChoice·RRL_VALUESImpedance Data Format:Impedance data can be entered as RRL values or as impedanceWritten as RRL_VALUES (RRL Values), IMPEDANCE (Impedance)
NameText·SourceSource Name
TermChoice·BEHIND_SOURCE_IMPEDANCESpecified 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·RSource Impedance Type:Choose how to represent the impedanceWritten as R, L, R_L (R//L), RR_L (R-R//L)
ViewChoice·SINGLE_LINEGraphics 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·NOZero Seq. Differs from Positive Seq. ?Specify whether Zero sequence is different from Positive Sequence ImpedanceWritten as NO (No), YES (Yes)

Source Control

ParameterUnitDefaultDescription
EsRealkV230.0Voltage Magnitude (L-L, RMS)At least 0Used when (Ctrl!=2)
FRealHz60.0Base FrequencyAt least 0.001
F0RealHz60.0FrequencyAt least 0Used when (Ctrl!=2)
MVARealMVA100.0Base MVA (3-phase)At least 0.001
PCtrlChoice·NOEnable Automatic Power Control?Phase angle could be controlled automatically to produce desired power outputWritten as NO (No), YES (Yes)Used when (Ctrl==3)
PdesRealpu1.0Desired Real Power OutUsed when (Ctrl==3)&&(PCtrl==1)
PhRealdeg0.0PhaseRange -360 to 360Used when (Ctrl!=2)
PinitRealpu0.0Initial Real PowerUsed when (Term==1)&&(Ctrl!=2)
QinitRealpu0.0Initial Reactive PowerUsed when (Term==1)&&(Ctrl!=2)
TcReals0.05Voltage Input Time ConstantAt least 0
TpcReals0.05Controller Time ConstantAt least 1E-06Used when (Ctrl==3)&&(PCtrl==1)
TpmReals0.02Measurement Time ConstantAt least 1E-06Used when (Ctrl==3)&&(PCtrl==1)
TvcReals0.05Controller Time ConstantAt least 1E-06Used when (Ctrl==3)&&(VCtrl==1)
TvmReals0.02Measurement Time ConstantAt least 1E-06Used when (Ctrl==3)&&(VCtrl==1)
VCtrlChoice·NOEnable Automatic Voltage Control?Voltage could be controlled automatically to produce desired bus voltageWritten as NO (No), YES (Yes)Used when (Ctrl==3)
VbaseRealkV230.0Measurement Voltage Base (L-L, RMS)At least 0.001Used when (Ctrl==3)&&(VCtrl==1)
VdesRealpu1.0Desired Bus VoltageAt least 0.01Used when (Ctrl==3)&&(VCtrl==1)
VmRealkV230.0Base Voltage (L-L, RMS)At least 0.001

Internal Output Variables

ParameterUnitDefaultDescription
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

ParameterUnitDefaultDescription
L0pRealH0.1Inductance (parallel)At least 0.0001Used when (Zseq==1)&&(Imp==0)&&(PS==0)
L0sRealH0.0001Inductance (series)At least 0.0001Used when (Zseq==1)&&(Imp==0)&&(PS==1)
L1pRealH0.1Inductance (parallel)At least 0.0001Used when (Type>=2)&&(Imp==0)
PSChoice·PARALLELParallel 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)
Phi0Realdeg80.0Zero Sequence Impedance Phase AngleRange 0 to 90Used when (ZSeq && Imp==1)
Phi1Realdeg80.0Positive Seq. Impedance Phase AngleRange 0.1 to 89.9Used when (Type>=3)&&(Imp==1)
R0pRealohm1.0Resistance (parallel)At least 0.001Used when (Zseq==1)&&(Imp==0)&&(PS==0)
R0sRealohm1.0Resistance (series)At least 0.001Used when (Zseq==1)&&(Imp==0)&&(PS==1)
R1pRealohm1.0Resistance (parallel)At least 0.001Used when (Type>=3)&&(Imp==0)
R1sRealohm1.0Resistance (series)At least 0.001Used when (Type==1 || Type==4)&&(Imp==0)
RNReal·2.0Harm. # where phase is same as fundamentalAt least 2Used when (Type==4)&&(Imp==1)
Z0Realohm1.0Zero Sequence ImpedanceAt least 0.001Used when (ZSeq && Imp==1)
Z1Realohm1.0Positive Seq. ImpedanceAt least 0.001Used when (Imp==1)

PowerFlow

ParameterUnitDefaultDescription
PF_QMAXRealpu1.0Maximum Reactive Power Output
PF_QMINRealpu-1.0Minimum Reactive Power Output
qsetChoice·AUTOQ SetWritten as MANUAL (Manual), AUTO (Auto)

Related

← master:src_ccin_3 Three Phase Current Source · master:source_3 Three Phase Voltage Source Model 2 →