master:tfault parametersPSCAD tfault
Every parameter of the PSCAD tfault (master:tfault): 3 names, with the unit, the default and the meaning PSCAD gives each one. Copy a name into parameters().
What master:tfault is
The older timed fault logic, with a repeat option. Like Timed Fault Logic it holds the fault's start time and duration.
- Definition
master:tfault- PSCAD name
- tfault
- Category
- Faults and switching
- Parameters
- 3, in 1 group; 2 carry a unit
- Read from
- PSCAD 5.0.0, 2026-11-07
Most used master:tfault parameters
| Parameter | Unit | Description |
|---|---|---|
TF | s | Time to Apply Faultwhen the fault is applied |
DF | s | Duration of Faulthow long it stays on |
REP | · | Repeat?repeat the fault |
Read and write master:tfault 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:tfault"): # the exact definition, namespace first
params = comp.parameters() # every parameter, as PSCAD holds it
print(str(params["TF"])) # Time to Apply Fault, in s
comp = project.find_all("master:tfault")[0]
comp.parameters(TF="2 [s]") # 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 withoutmaster:comes back empty; the Builder'spx_findwalks the pages for those.
The Builder's runtime does the same with the unit handled for you: px_get(comp, "TF") and px_set(...), which also records the old value so the case is put back at the end. Getting started shows them.
Configuration
| Parameter | Unit | Default | Description |
|---|---|---|---|
DFReal | s | 0.05 | Duration of FaultAt least 0 |
REPChoice | · | NO | Repeat?Written as NO (No), YES (Yes) |
TFReal | s | 1.0 | Time to Apply FaultAt least 0 |