master:xfmr-3w parametersPSCAD Single Phase 3 Winding Transformer

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

What master:xfmr-3w is

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

Definition
master:xfmr-3w
PSCAD name
Single Phase 3 Winding Transformer
Category
Transformers and reactors
Parameters
41, in 4 groups; 20 carry a unit
Read from
PSCAD 5.0.0, 2026-11-07

Read and write master:xfmr-3w 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-3w"):   # the exact definition, namespace first
    params = comp.parameters()           # every parameter, as PSCAD holds it
    print(str(params["Bnom"]))           # Nominal flux density [T], in T

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

Internal Outputs

ParameterUnitDefaultDescription
B1Text··Name for Flux Density [T]Used when (Hys==2) &&(Enab==1)
FLUXText··Name for flux linkage [kWb-N]
H1Text··Name for Magnetic Field IntensityUsed when (Hys==2) &&(Enab==1)
IL1Text··Name for winding 1 current [kA]
IL2Text··Name for winding 2 current [kA]
IL3Text··Name for winding 3 current [kA]
IMAGText··Name for magnetizing current [kA]

Magnetic Characteristics of the Material

ParameterUnitDefaultDescription
BETAReal·0.96Parameter to adjust K with MThis parameter adjusts domian pinning parameter with magnetization for better representation of shoulder areaRange 0 to 0.98
CReal·0.1Domain Flexing ParameterThis parameter represents the contribution of reversible magnetization processRange 0.001 to 0.5
F1Real·2730.0Coefficient 1 of Anhysteretic CurveAt least 0
F2Real·3209.0Coefficient 2 of Anhysteretic CurveAt least 0
F3Real·20294.0Coefficient 3 of Anhysteretic CurveAt least 0
FbReal·2.0Coefficient 4 of Anhysteretic CurveAt least 1
KRealA/m5.0e-5Domain Pinning ParameterThis parameter has a direct impact on the width of the loopAt least 1e-007
MsatRealA/m1.72e6Saturated Anhysteretic MagnetizationAt least 100000
alphaReal·1.325e-05Interdomain CouplingAt least 1e-008

Saturation

ParameterUnitDefaultDescription
BnomRealT1.7Nominal flux density [T]Enter the nominal flux density corresponding to saturation curveAt least 1e-307Used when (Hys==2)
EnabChoice·NOSaturation enabledSelect Yes or No to enable or disable the core saturation routineWritten as NO (No), YES (Yes)
FremnRealpu0.0Remanent fluxEnter the remanent flux as a per unit value of the peak flux at rated voltageRange -1.5 to 1.5Used when (Hys!=0)
HysChoice·NONEHysteresisSelect the hysteresis model from available optionsWritten as NONE (None), BASIC_MODEL (Basic model), JILES_ATHERTON (Jiles_Atherton)
Im1Real%0.4Magnetizing currentEnter the magnetizing current as a percentage of base currentRange 0.0001 to 50
LW2Real%10Loop widthEnter the loop width as a percentage of magnetizing currentRange 0 to 100Used when (Hys==1)
SatChoice·MIDDLEPlace saturation on windingSelect the winding # on which to place the magnetization branchWritten as MIDDLE (Middle), _1 (#1), _2 (#2), _3 (#3)
TdcReals0.0Inrush decay time constantFictitious damping of inrush can be enabled by using a non-zero time constantAt least 0.0Used when Hys==0
TxkReals0.0Time to release flux clippingThis could be used to reduce start-up transientsRange 0 to 1e+006Used when Hys==0
XairRealpu0.2Air core reactanceEnter the air core reactance based on transformer base impedanceRange 1e-008 to 1
XkneeRealpu1.17Knee voltageEnter the knee point voltage corresponding to saturation curveAt least 1e-307
materialChoice·DEFAULTMagnetic materialSelect the magnetic materialWritten as CUSTOM_MATERIAL (custom material), DEFAULT (default)Used when (Hys==2)

Configuration

ParameterUnitDefaultDescription
CuLRealpu0.0Copper lossesEnter the copper losses based on transformer base impedanceRange 0 to 1
IdealChoice·NOIdeal transformer modelSelect Yes or NoWritten as NO (No), YES (Yes)
NLLRealpu0.0Eddy current lossesEnter the eddy current loss portion of no load losses based on transformer rating, hysteresis loss may also be added here if hysteresis is not modelledRange 0 to 1
TapChoice·NONETap changer on windingSelect the winding number on which to place the on-line tap changerWritten as NONE (None), _1 (#1), _2 (#2), _3 (#3)
TmvaRealMVA100.0Transformer MVAEnter the apparent power rating of the transformerAt least 1e-006
V1RealkV230.0Winding #1 voltage (RMS)Enter the RMS voltage rating of winding 1At least 0.0001
V2RealkV230.0Winding #2 voltage (RMS)Enter the RMS voltage rating of winding 2At least 0.0001
V3RealkV230.0Winding #3 voltage (RMS)Enter the RMS voltage rating of winding 3At least 0.0001
ViewChoice·WINDINGSGraphics DisplaySelect the preferred view of graphics: Windings or CirclesWritten as CIRCLES (Circles), WINDINGS (Windings)
Xl12Realpu0.1Leakage reactance (#1-#2)Enter the leakge reactance based on transformer base impedanceAt least 1e-307
Xl13Realpu0.1Leakage reactance (#1-#3)Enter the leakge reactance based on transformer base impedanceAt least 1e-307
Xl23Realpu0.1Leakage reactance (#2-#3)Enter the leakge reactance based on transformer base impedanceAt least 1e-307
fRealHz60.0Base operation frequencyEnter the base frequencyAt least 0.0001

Related

← master:xfmr_3w_auto Single Phase 3 Winding Auto Transformer · master:xfmr-3w2 Single Phase 3 Winding Transformer →