master:source_1 parametersPSCAD Single Phase Voltage Source Model 2

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

What master:source_1 is

The single phase voltage source, model 2: an AC or DC source behind an impedance, set by magnitude, phase and frequency or by the power it delivers.

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

Most used master:source_1 parameters

ParameterUnitDescription
VmkVMag. (AC:L-G,RMS DC:Pk)magnitude
fHzFrequencyfrequency
PhdegInitial Phaseinitial phase
Type·Source Impedancewhat the source impedance is
TcsRamp up Timethe ramp up time at the start of the run

Read and write master:source_1 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:source_1"):   # the exact definition, namespace first
    params = comp.parameters()           # every parameter, as PSCAD holds it
    print(str(params["Vm"]))             # Mag. (AC:L-G,RMS DC:Pk), in kV

comp = project.find_all("master:source_1")[0]
comp.parameters(Vm="265.58 [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, "Vm") and px_set(...), which also records the old value so the case is put back at the end. Getting started shows them.

Configuration

ParameterUnitDefaultDescription
ACChoice·ACSource TypeWritten as AC, DC
CntrlChoice·INTERNALInput MethodWritten as INTERNAL (Internal), EXTERNAL (External)Used when Spec==0
GrndChoice·YESIs This Source Grounded?Written as NO (No), YES (Yes)
NameText·SourceSource Name
SpecChoice·BEHIND_SOURCE_IMPEDANCESpecified ParametersWritten as BEHIND_SOURCE_IMPEDANCE (Behind the Source Impedance), AT_TERMINAL (At the Terminal)
TypeChoice·RESISTIVESource ImpedanceWritten as RESISTIVE (Resistive), RR_L (R-R//L), SERIES_RLC (Series RLC), INDUCTIVE (Inductive), CAPACITIVE (Capacitive), IDEAL (Ideal)

Impedance

ParameterUnitDefaultDescription
CRealuF1.0CapacitanceAt least 0Used when (Type==3)
C_RealuF1.0CapacitanceAt least 0Used when (Type==5)
LRealH0.1InductanceAt least 0Used when (Type==3)
L_RealH0.1InductanceAt least 0Used when (Type==4)
LpRealH0.1Inductance (parallel)At least 0.0001Used when (Type==2)
RRealohm1.0ResistanceAt least 0Used when (Type==1)
R_Realohm1.0ResistanceAt least 0Used when (Type==3)
RpRealohm1.0Resistance (parallel)At least 0.001Used when (Type==2)
RsRealohm1.0Resistance (series)At least 0Used when (Type==2)

Monitoring

ParameterUnitDefaultDescription
CURText··Name for Source current [kA]

Signal Parameters

ParameterUnitDefaultDescription
PRealMW0.0Terminal Real PowerUsed when Spec==1
PhRealdeg0.0Initial PhaseRange -360 to 360Used when (AC==1)
QRealMVAR0.0Terminal Reactive PowerUsed when (Spec==1)&&(AC==1)
TcReals0.05Ramp up TimeAt least 0
VmRealkV132.79Mag. (AC:L-G,RMS DC:Pk)At least 0Used when ((Cntrl==0)&&(Spec==0))||(Spec==1)
fRealHz60.0FrequencyAt least 0Used when (((Cntrl==0)&&(Spec==0))||(Spec==1))&&(AC==1)

Related

← master:source1 Single Phase Voltage Source Model 1 · master:src_ccin_3 Three Phase Current Source →