master:newpi parametersPSCAD Coupled PI Section

Every parameter of the PSCAD Coupled PI Section (master:newpi): 44 names, with the unit, the default and the meaning PSCAD gives each one. Copy a name into parameters().

What master:newpi is

The coupled PI section: a short line from its sequence data, entered per metre.

Definition
master:newpi
PSCAD name
Coupled PI Section
Category
Lines, cables and towers
Parameters
44, in 7 groups; 36 carry a unit
Read from
PSCAD 5.0.0, 2026-11-07

Most used master:newpi parameters

ParameterUnitDescription
Rpohm/mPositive Sequence Resistancepositive sequence resistance
LpH/mPositive Sequence Inductancepositive sequence inductance
CpuF/mPositive Sequence Capacitancepositive sequence capacitance
FHzLine Rated Frequencyrated frequency

Read and write master:newpi 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:newpi"):   # the exact definition, namespace first
    params = comp.parameters()           # every parameter, as PSCAD holds it
    print(str(params["Rp"]))             # Positive Sequence Resistance, in ohm/m

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

R,X,B Data [pu]

ParameterUnitDefaultDescription
BPUP2Realpu/m1.933869E-6Positive Sequence Capacitive SusceptanceAt least 1E-307
BPUZ2Realpu/m1.277271E-6Zero Sequence Capacitive SusceptanceAt least 1E-307Used when Estim==0
MVA2RealMVA100.0MVA for All PhasesBase 3 phase MVA of per unit quantitiesAt least 1E-307
RPUP2Realpu/m.336786E-7Positive Sequence ResistanceAt least 1E-307
RPUZ2Realpu/m.558072E-6Zero Sequence ResistanceAt least 1E-307Used when Estim==0
VR2RealkV230.0Rated Voltage L-LLine-Line rated voltageAt least 1E-307
XLPUP2Realpu/m.593346E-6Positive Sequence Inductive ReactanceAt least 1E-307
XLPUZ2Realpu/m.196578E-5Zero Sequence Inductive ReactanceAt least 1E-307Used when Estim==0

R, Xl, Xc Data [ohm]

ParameterUnitDefaultDescription
BpRealMohm*m273.5448Positive Sequence Capacitive ReactanceAt least 1E-307
BzRealMohm*m414.1642Zero Sequence Capacitive ReactanceAt least 1E-307Used when Estim==0
RpRealohm/m.1781598E-4Positive Sequence ResistanceAt least 1E-307
RzRealohm/m.2952201E-3Zero Sequence ResistanceAt least 1E-307Used when Estim==0
XpRealohm/m.31388E-3Positive Sequence Inductive ReactanceAt least 1E-307
XzRealohm/m.1039898E-2Zero Sequence Inductive ReactanceAt least 1E-307Used when Estim==0

Main Configuration

ParameterUnitDefaultDescription
ConfigChoice·COUPLEDNominal PI or Coupled PI Model:Select Coupled PI or Nominal, Coupled PI is recommended.Written as NOMINAL (Nominal), COUPLED (Coupled)
EstimChoice·ENTEREnter 0 Sequence Data, or Estimate:Zero sequence data: specify or estimateWritten as ENTER (Enter), ESTIMATE (Estimate)
FRealHz60.0Line Rated FrequencyEnter the rated frequencyAt least 1E-307
NameText·LineT-LINE NAMEEnter a name for identificationRange 0 to 0
PUChoice·R_XL_XC_OHMEnter Impedance,Admittance Data in:Select the form of data from available optionsWritten as R_XL_XC_PU (R,Xl,Xc [pu]), R_XL_XC_OHM (R,Xl,Xc [ohm]), ZSURGE_TAU (Zsurge,Tau..), R_X_B_PU (R,X,B [pu]), R_L_C_OHM_H_UF (R,L,C [ohm,H,uF])
ViewChoice·SUPER_COMPACTGraphics DisplaySelect the form of graphical representationWritten as 3_PHASE (3 phase view), SINGLE_LINE (Single line view), COMPACT_SINGLE_LINE (Compact single line view), SUPER_COMPACT (Super compact view)
lenRealm1.0E5Line LengthEnter the line lengthAt least 1E-307

R, L, C Data [ohm,H,uF]

ParameterUnitDefaultDescription
CpRealuF/m9.697067E-6Positive Sequence CapacitanceAt least 1E-307
CzRealuF/m6.4046636E-6Zero Sequence CapacitanceAt least 1E-307Used when Estim==0
LpRealH/m8.3259256E-7Positive Sequence InductanceAt least 1E-307
LzRealH/m2.758415E-6Zero Sequence InductanceAt least 1E-307Used when Estim==0
Rp2Realohm/m1.781598E-5Positive Sequence ResistanceAt least 1E-307
Rz2Realohm/m2.952201E-4Zero Sequence ResistanceAt least 1E-307Used when Estim==0

R,Xl,Xc Data [pu]

ParameterUnitDefaultDescription
MVARealMVA100.0MVA for All PhasesBase 3 phase MVA of per unit quantitiesAt least 1E-307
RPUPRealpu/m.336786E-7Positive Sequence ResistanceAt least 1E-307
RPUZRealpu/m.558072E-6Zero Sequence ResistanceAt least 1E-307Used when Estim==0
VRRealkV230.0Rated Voltage L-LLine-Line rated voltageAt least 1E-307
XCPUPRealpu*m.517098E6Positive Sequence Capacitive ReactanceAt least 1E-307
XCPUZRealpu*m.782919E6Zero Sequence Capacitive ReactanceAt least 1E-307Used when Estim==0
XLPUPRealpu/m.593346E-6Positive Sequence Inductive ReactanceAt least 1E-307
XLPUZRealpu/m.196578E-5Zero Sequence Inductive ReactanceAt least 1E-307Used when Estim==0

Zero Sequence Estimation Parameters

ParameterUnitDefaultDescription
REstReal·1.50 Sequence R / +ve Sequence RRatio of zero sequence resistance divided by positive sequence resistanceAt least 1
TEstReal·1.50 Seq. Travel Time / +ve Seq. Travel TimeRatio of zero sequence travel time divided by positive sequence travel timeAt least 1
ZEstReal·1.50 Sequence Z / +ve Sequence ZRatio of zero sequence reactance divided by positive sequence reactanceAt least 1

Surge Impedance,Travel Time Data [ohm,s]

ParameterUnitDefaultDescription
RTPRealohm/m.1781598E-4Positive Sequence ResistanceAt least 1E-307Used when PU==2
RTZRealohm/m.2952201E-3Zero Sequence ResistanceAt least 1E-307Used when Estim==0
TTPRealms.2841427Positive Sequence Travel TimeAt least 1E-307Used when PU==2
TTZRealms.4203179Zero Sequence Travel TimeAt least 1E-307Used when Estim==0
ZTPRealohm293.0192Positive Sequence Surge ImpedanceAt least 1E-307Used when PU==2
ZTZRealohm656.2685Zero Sequence Surge ImpedanceAt least 1E-307Used when Estim==0

Related

← master:Cable_Coax Coax Cable Cross-Section · master:pi_double_cct Double Circuit Pi section →