master:umec-xfmr-2w parametersPSCAD Single Phase 2 Winding UMEC Transformer

Every parameter of the PSCAD Single Phase 2 Winding UMEC Transformer (master:umec-xfmr-2w): 43 names, with the unit, the default and the meaning PSCAD gives each one. Copy a name into parameters().

What master:umec-xfmr-2w is

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

Definition
master:umec-xfmr-2w
PSCAD name
Single Phase 2 Winding UMEC Transformer
Category
Transformers and reactors
Parameters
43, in 6 groups; 28 carry a unit
Read from
PSCAD 5.0.0, 2026-11-07

Read and write master:umec-xfmr-2w 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:umec-xfmr-2w"):   # 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:umec-xfmr-2w")[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
NLLRealpu0.0No Load LossesRange 0 to 1
NameText·T1Transformer Name
SatChoice·NOModel Saturation?Written as NO (No), YES (Yes)
TapChoice·NONETap Changer WindingWritten as NONE (None), _1 (#1), _2 (#2)
TmvaRealMVA100.0Transformer MVAAt least 1E-06
V1RealkV230.0Primary Voltage (RMS)At least 0.0001
V2RealkV230.0Secondary Voltage (RMS)At least 0.0001
ViewChoice·WINDINGSGraphics DisplayWritten as CIRCLES (Circles), WINDINGS (Windings)
XlRealpu0.10Leakage ReactanceAt least 1E-307
fRealHz60.0Base Operation FrequencyAt least 0.0001

Saturation Curve

ParameterUnitDefaultDescription
EnabInteger·0Enable SaturationRange 0 to 1Used when (Sat==1)
Im1Real%2.0Magnetizing Current at Rated VoltageRange 0.0001 to 50Used when (Sat==0)
X10EReal%124.388Point 10 - Current as a PercentageRange 0 to 1000Used when (Sat==1)
X1EReal%0.0Point 1 - Current as a PercentageRange 0 to 1000Used when (Sat==1)
X2EReal%.1774Point 2 - Current as a PercentageRange 0 to 1000Used when (Sat==1)
X3EReal%.487637Point 3 - Current as a PercentageRange 0 to 1000Used when (Sat==1)
X4EReal%.980856Point 4 - Current as a PercentageRange 0 to 1000Used when (Sat==1)
X5EReal%2Point 5 - Current as a PercentageRange 0 to 1000Used when (Sat==1)
X6EReal%3.09543Point 6 - Current as a PercentageRange 0 to 1000Used when (Sat==1)
X7EReal%6.52348Point 7 - Current as a PercentageRange 0 to 1000Used when (Sat==1)
X8EReal%20.357Point 8 - Current as a PercentageRange 0 to 1000Used when (Sat==1)
X9EReal%60.215Point 9 - Current as a PercentageRange 0 to 1000Used when (Sat==1)
Y10ERealpu1.49469Point 10 - Voltage in puRange 0 to 1000Used when (Sat==1)
Y1ERealpu0.0Point 1 - Voltage in puRange 0 to 1000Used when (Sat==1)
Y2ERealpu.324129Point 2 - Voltage in puRange 0 to 1000Used when (Sat==1)
Y3ERealpu.61284Point 3 - Voltage in puRange 0 to 1000Used when (Sat==1)
Y4ERealpu.825118Point 4 - Voltage in puRange 0 to 1000Used when (Sat==1)
Y5ERealpu1.0Point 5 - Voltage in puRange 0 to 1000Used when (Sat==1)
Y6ERealpu1.08024Point 6 - Voltage in puRange 0 to 1000Used when (Sat==1)
Y7ERealpu1.17334Point 7 - Voltage in puRange 0 to 1000Used when (Sat==1)
Y8ERealpu1.26115Point 8 - Voltage in puRange 0 to 1000Used when (Sat==1)
Y9ERealpu1.36094Point 9 - Voltage in puRange 0 to 1000Used when (Sat==1)

Monitoring of Winding Currents

ParameterUnitDefaultDescription
IL1Text··Name for Winding 1 Current [kA]
IL2Text··Name for Winding 2 Current [kA]

Tap Setting

ParameterUnitDefaultDescription
aReal·1.0Tap SettingRange 0.1 to 1.9Used when (Tap > 0)

Transformer Flux [pu]

ParameterUnitDefaultDescription
pwlbText··Winding 1 Flux
pwlkText··Winding 1 Leakage Flux
swlbText··Winding 2 Flux
swlkText··Winding 2 Leakage Flux
yokeText··Yoke Flux

Core Aspect Ratios

ParameterUnitDefaultDescription
raReal·1.0Ratio Yoke/Winding-limb Area
rlReal·2.0Ratio Yoke/Winding-limb Length

Related

← master:xfmr-2w Single Phase 2 Winding Transfomer · master:xfmr_3w_auto Single Phase 3 Winding Auto Transformer →