master:peswitch parametersPSCAD Power Electronic Switch

Every parameter of the PSCAD Power Electronic Switch (master:peswitch): 21 names, with the unit, the default and the meaning PSCAD gives each one. Copy a name into parameters().

What master:peswitch is

Power Electronic Switch (Power electronic switch), a component of PSCAD's Master Library, filed under faults and switching.

Definition
master:peswitch
PSCAD name
Power Electronic Switch
Category
Faults and switching
Parameters
21, in 3 groups; 8 carry a unit
Read from
PSCAD 5.0.0, 2026-11-07

Read and write master:peswitch 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:peswitch"):   # the exact definition, namespace first
    params = comp.parameters()           # every parameter, as PSCAD holds it
    print(str(params["CD"]))             # Snubber Capacitance, in uF

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

Internal Output Variables

ParameterUnitDefaultDescription
AlphaText··Alpha in Seconds
GammaText··Gamma in Seconds
IText··Current in Device (snubber excluded)
ItText··Total Current in Device
ToffText··Time of Last Turn off
TonText··Time of Last Turn on
VText··Voltage Across the Device

Main Data

ParameterUnitDefaultDescription
CDRealuF0.05Snubber CapacitanceAt least 0.001Used when (SNUB==1)
EBORealkV1.0E5Forward Breakover VoltageAt least 1
EFVDRealkV0.0Forward Voltage DropRange 0 to 10
ErwRealkV1.0E5Reverse Withstand VoltageAt least 1
PFBChoice·NOProtected against Forward Breakover?If protected, the device will turn on before the breakdown protecting it from permanent failureWritten as NO (No), YES (Yes)
RDRealohm5000.0Snubber ResistanceAt least 0.001Used when (SNUB==1)
ROFFRealohm1.0E6Thyristor OFF ResistanceAt least 1
RONRealohm0.01Thyristor ON ResistanceAt least 0
TEXTRealus0.0Minimum Extinction TimeRange 0 to 1000

Configuration

ParameterUnitDefaultDescription
INTRChoice·YESInterpolated Pulse?Select Yes if the input pulses contain interpolation informationWritten as NO (No), YES (Yes)Used when Type != 0
LText·TDevice Label (optional)Optional label
NameText··Name for IdentificationEnter a name for identification
SNUBChoice·YESEnable Snubber Circuit?Select Yes or No to enable/disable snubber circuitWritten as YES (Yes), NO (No)
TypeChoice·THYRISTORDevice TypeSelect the type of power electronic deviceWritten as DIODE (Diode), THYRISTOR (Thyristor), GTO, IGBT, TRANSISTOR (Transistor)

Related

← master:switch Isolation Switch · master:var_pot Rotary Switch →