master:fault_sw parametersPSCAD Single Phase Fault

Every parameter of the PSCAD Single Phase Fault (master:fault_sw): 7 names, with the unit, the default and the meaning PSCAD gives each one. Copy a name into parameters().

What master:fault_sw is

Single Phase Fault, a component of PSCAD's Master Library, filed under faults and switching.

Definition
master:fault_sw
PSCAD name
Single Phase Fault
Category
Faults and switching
Parameters
7, in 4 groups; 3 carry a unit
Read from
PSCAD 5.0.0, 2026-11-07

Read and write master:fault_sw 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:fault_sw"):   # the exact definition, namespace first
    params = comp.parameters()           # every parameter, as PSCAD holds it
    print(str(params["CLVL"]))           # Current Chopping Limit, in kA

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

Animation

ParameterUnitDefaultDescription
AG1Choice·NORMALAnimation StateWritten as NORMAL (Normal), FAULTED (Faulted)

Configuration

ParameterUnitDefaultDescription
CLVLRealkA0.0Current Chopping LimitFault will not clear until the current through it drops below this valueUsed when OPCUR==0
NameInteger·FaultFault NameRange 0 to 1
OpCurChoice·NOClearing Possible at any Current ?Written as NO (No), YES (Yes)

Internal Output

ParameterUnitDefaultDescription
IfltText·IFltName for Fault Current [kA]

Main Data

ParameterUnitDefaultDescription
ROffRealohm1.0E6Fault OFF ResistanceAt least 1
ROnRealohm0.01Fault ON ResistanceAt least 0

Related

← master:breaker1 Single Phase Breaker · master:statistical_breaker Statistical breaker →