master:xfmr_2w_auto parametersPSCAD Single Phase Auto Transformer

Every parameter of the PSCAD Single Phase Auto Transformer (master:xfmr_2w_auto): 21 names, with the unit, the default and the meaning PSCAD gives each one. Copy a name into parameters().

What master:xfmr_2w_auto is

Single Phase Auto Transformer, a component of PSCAD's Master Library, filed under transformers and reactors.

Definition
master:xfmr_2w_auto
PSCAD name
Single Phase Auto Transformer
Category
Transformers and reactors
Parameters
21, in 4 groups; 12 carry a unit
Read from
PSCAD 5.0.0, 2026-11-07

Read and write master:xfmr_2w_auto 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:xfmr_2w_auto"):   # the exact definition, namespace first
    params = comp.parameters()           # every parameter, as PSCAD holds it
    print(str(params["CuL"]))            # Copper Losses, in pu

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

Configuration

ParameterUnitDefaultDescription
CuLRealpu0.0Copper LossesRange 0 to 1
IdealChoice·NOIdeal Transformer ModelWritten as NO (No), YES (Yes)
NLLRealpu0.0No Load LossesRange 0 to 1
NameText··Name for IdentificationEnter a name for identification
TapChoice·NOOn Load Tap ChangerWritten as YES (Yes), NO (No)
TmvaRealMVA100.0Transformer MVAAt least 1E-06
XlautoRealpu0.10Leakage ReactanceAt least 1E-307
fRealHz60.0Base Operation FrequencyAt least 0.0001

Saturation

ParameterUnitDefaultDescription
EnabChoice·NOSaturation EnabledWritten as NO (No), YES (Yes)
Im1Real%0.4Magnetizing CurrentRange 0.0001 to 50
TdcReals0.0Inrush Decay Time ConstantAt least 0
TxkReals0.0Time to Release Flux ClippingRange 0 to 1000000
XairRealpu0.2Air Core ReactanceRange 0.001 to 10
XkneeRealpu1.17Knee VoltageAt least 1E-307

Monitoring of Currents and Flux

ParameterUnitDefaultDescription
FLUXText··Name for Flux Linkage [pu]
IL1Text··Name for HV Winding Current [kA]
IL2Text··Name for LV Winding Current [kA]
IL3Text··Name for LV Side Current [kA]
IMAGText··Name for Magnetizing Current [pu]

Winding Voltage Ratings

ParameterUnitDefaultDescription
VhighRealkV230.0HV Winding Voltage (RMS)At least 0.0001
VlowRealkV115.0LV Winding Voltage (RMS)At least 0.0001

Related

← master:umec-xfmr-4w Single Phase 4 Winding UMEC Transformer · master:xfmr_Nw Single Phase N Winding Transformer →