master:source1 parametersPSCAD Single Phase Voltage Source Model 1

Every parameter of the PSCAD Single Phase Voltage Source Model 1 (master:source1): 24 names, with the unit, the default and the meaning PSCAD gives each one. Copy a name into parameters().

What master:source1 is

Single Phase Voltage Source Model 1, a component of PSCAD's Master Library, filed under sources.

Definition
master:source1
PSCAD name
Single Phase Voltage Source Model 1
Category
Sources
Parameters
24, in 4 groups; 15 carry a unit
Read from
PSCAD 5.0.0, 2026-11-07

Read and write master:source1 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:source1"):   # the exact definition, namespace first
    params = comp.parameters()           # every parameter, as PSCAD holds it
    print(str(params["Es"]))             # Initial Source Magnitude (L-G, RMS), in kV

comp = project.find_all("master:source1")[0]
comp.parameters(Es="265.581 [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
ACDCChoice·ACSource Type:Select AC or DCWritten as AC, DC
CtrlChoice·FIXEDSource Control:Select Fixed or ExternalWritten as FIXED (Fixed), EXTERNAL (External)
ExphChoice·RADIANSExternal Phase Input UnitSelect Radians or DegreesWritten as RADIANS (Radians), DEGREES (Degrees)Used when (Ctrl==2)&&(ACDC==0)
FRealHz60.0Base FrequencyAt least 0.001
ImpChoice·RRL_VALUESImpedance Data Format:Written as RRL_VALUES (RRL Values), IMPEDANCE (Impedance)
NameText·SourceSource Name
TcReals0.05Voltage Input Time ConstantAt least 0
TermChoice·BEHIND_SOURCE_IMPEDANCESpecified ParametersWritten as BEHIND_SOURCE_IMPEDANCE (Behind the Source Impedance), AT_TERMINAL (At the Terminal)Used when Ctrl!=2
TypeChoice·RR_LSource Impedance Type:Written as R, L, R_L (R//L), RR_L (R-R//L)
VmRealkV110.00Rated Volts (AC:L-G, RMS)At least 0.001

Source Initial Values

ParameterUnitDefaultDescription
EsRealkV132.79056Initial Source Magnitude (L-G, RMS)At least 0Used when (Ctrl!=2 && ACDC==0)
EsdRealkV100.0Initial Source MagnitudeUsed when (Ctrl!=2 && ACDC==1)
F0RealHz60.0Initial FrequencyAt least 0Used when (Ctrl!=2 && ACDC==0)
PacRealMW0.0Initial Real PowerUsed when Term==1
PdcRealMW0.0Initial Real PowerUsed when Term==1
PhRealdeg0.0Initial PhaseRange -360 to 360Used when (Ctrl!=2 && ACDC==0)
QacRealMVAR0.0Initial Reactive PowerUsed when Term==1

Internal Output Variables

ParameterUnitDefaultDescription
IaText··Name for Current [kA]

Internal Impedance

ParameterUnitDefaultDescription
L1pRealH0.1Inductance (parallel)At least 0.0001Used when (Type>=2)&&(Imp==0)
Phi1Realdeg80.0Impedance Phase AngleRange 0.1 to 89.9Used when (Type>=3)&&(Imp==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)
Z1Realohm1.0Impedance MagnitudeAt least 0.001Used when (Imp==1)

Related

← master:photovoltaic_source Photovoltaic source · master:source_1 Single Phase Voltage Source Model 2 →