master:xfmr-3p4w parametersPSCAD 3 Phase 4 Winding Transformer

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

What master:xfmr-3p4w is

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

Definition
master:xfmr-3p4w
PSCAD name
3 Phase 4 Winding Transformer
Category
Transformers and reactors
Parameters
94, in 10 groups; 26 carry a unit
Read from
PSCAD 5.0.0, 2026-11-07

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

comp = project.find_all("master:xfmr-3p4w")[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.

Monitoring of Magnetic Core:1

ParameterUnitDefaultDescription
BA1Text··Name for Flux Density Phase A [T]Used when (Hys==2) &&(Enab==1)
BB1Text··Name for Flux Density Phase B [T]Used when (Hys==2) &&(Enab==1)
BC1Text··Name for Flux Density Phase C [T]Used when (Hys==2) &&(Enab==1)
FLXAText··Name for Phase A Flux Linkage (kWb-N)
FLXBText··Name for Phase B Flux Linkage (kWb-N)
FLXCText··Name for Phase C Flux Linkage (kWb-N)
HA1Text··Name for Magnetic Field Intensity Phase AUsed when (Hys==2) &&(Enab==1)
HB1Text··Name for Magnetic Field Intensity Phase BUsed when (Hys==2) &&(Enab==1)
HC1Text··Name for Magnetic Field Intensity Phase CUsed when (Hys==2) &&(Enab==1)
IMAText··Name for Phase A Magnetizing Current [kA]
IMBText··Name for Phase B Magnetizing Current [kA]
IMCText··Name for Phase C Magnetizing Current [kA]

Monitoring of Magnetic Core:2

ParameterUnitDefaultDescription
BAB1Text··Name for Flux Density Phase A to B [T]Used when (Hys==2) &&(Enab==1)
BBC1Text··Name for Flux Density Phase B to C [T]Used when (Hys==2) &&(Enab==1)
BCA1Text··Name for Flux Density Phase C to A [T]Used when (Hys==2) &&(Enab==1)
FLXABText··Name for Phase A to B Flux Linkage (kWb-N)
FLXBCText··Name for Phase B to C Flux Linkage (kWb-N)
FLXCAText··Name for Phase C to A Flux Linkage (kWb-N)
HAB1Text··Name for Magnetic Field Intensity Phase A to BUsed when (Hys==2) &&(Enab==1)
HBC1Text··Name for Magnetic Field Intensity Phase B to CUsed when (Hys==2) &&(Enab==1)
HCA1Text··Name for Magnetic Field Intensity Phase C to AUsed when (Hys==2) &&(Enab==1)
IMABText··Name for Phase A to B Magnetizing Current [kA]
IMBCText··Name for Phase B to C Magnetizing Current [kA]
IMCAText··Name for Phase C to A Magnetizing Current [kA]

Magnetic Characteristic 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 densityEnter 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)
Fremn1Realpu0.0Remanent flux core 1Enter the remanent flux as a per unit value of the peak flux at rated voltageRange -1.5 to 1.5Used when (Hys!=0)
Fremn2Realpu0.0Remanent flux core 2Enter the remanent flux as a per unit value of the peak flux at rated voltageRange -1.5 to 1.5Used when (Hys!=0)
Fremn3Realpu0.0Remanent flux core 3Enter the remanent flux as a per unit value of the peak flux at rated voltageRange -1.5 to 1.5Used when (Hys!=0)
HysChoice·NONEHysteresisWritten 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), _4 (#4)
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 0.001 to 10
XkneeRealpu1.17Knee voltageEnter the knee point voltage corresponding to saturation curveAt least 1e-307Used when (Hys!=2)
materialChoice·DEFAULTMagnetic 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)
LeadChoice·LAGSDelta lags or leads YSelect whether Delta connected winding is leading or lagging the Y connected windingWritten as LAGS (Lags), LEADS (Leads)Used when !((YD1+YD2+YD3+YD4==0)||(YD1+YD2+YD3+YD4==4))
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
NameText·T34Transformer NameEnter an optional name for easy identification
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), _4 (#4)
TmvaRealMVA100.03 Phase Transformer MVAEnter the apparent power rating of the transformerAt least 1e-006
ViewChoice·CIRCLESGraphics DisplaySelect the preferred view of graphicsWritten as 3_PHASE_VIEW (3 phase view), CIRCLES (Single line (circles)), WINDINGS (Single line (windings))
Xl12Realpu0.1Positive sequence leakage reactance (#1-#2)Enter the leakge reactance based on transformer base impedanceAt least 1e-307
Xl13Realpu0.1Positive sequence leakage reactance (#1-#3)Enter the leakge reactance based on transformer base impedanceAt least 1e-307
Xl14Realpu0.1Positive sequence leakage reactance (#1-#4)Enter the leakge reactance based on transformer base impedanceAt least 1e-307
Xl23Realpu0.1Positive sequence leakage reactance (#2-#3)Enter the leakge reactance based on transformer base impedanceAt least 1e-307
Xl24Realpu0.1Positive sequence leakage reactance (#2-#4)Enter the leakge reactance based on transformer base impedanceAt least 1e-307
Xl34Realpu0.1Positive sequence leakage reactance (#3-#4)Enter the leakge reactance based on transformer base impedanceAt least 1e-307
YD1Choice·YWinding #1 TypeSelect whether winding type is Y or DeltaWritten as Y, DELTA (Delta)
YD2Choice·DELTAWinding #2 TypeSelect whether winding type is Y or DeltaWritten as Y, DELTA (Delta)
YD3Choice·YWinding #3 TypeSelect whether winding type is Y or DeltaWritten as Y, DELTA (Delta)
YD4Choice·YWinding #4 TypeSelect whether winding type is Y or DeltaWritten as Y, DELTA (Delta)
fRealHz60.0Base operation frequencyEnter the base frequencyAt least 0.0001

Winding 1 Currents

ParameterUnitDefaultDescription
IAB1Text··Name for A to B Winding Current [kA]Used when (YD1)
IBC1Text··Name for B to C Winding Current [kA]Used when (YD1)
ICA1Text··Name for C to A Winding Current [kA]Used when (YD1)
ILA1Text··Name for Phase A Current (+in)[kA]
ILB1Text··Name for Phase B Current (+in)[kA]
ILC1Text··Name for Phase C Current (+in)[kA]

Winding 2 Currents

ParameterUnitDefaultDescription
IAB2Text··Name for A to B Winding Current [kA]Used when (YD2)
IBC2Text··Name for B to C Winding Current [kA]Used when (YD2)
ICA2Text··Name for C to A Winding Current [kA]Used when (YD2)
ILA2Text··Name for Phase A Current (+in)[kA]
ILB2Text··Name for Phase B Current (+in)[kA]
ILC2Text··Name for Phase C Current (+in)[kA]

Winding 3 Currents

ParameterUnitDefaultDescription
IAB3Text··Name for A to B Winding Current [kA]Used when (YD3)
IBC3Text··Name for B to C Winding Current [kA]Used when (YD3)
ICA3Text··Name for C to A Winding Current [kA]Used when (YD3)
ILA3Text··Name for Phase A Current (+in)[kA]
ILB3Text··Name for Phase B Current (+in)[kA]
ILC3Text··Name for Phase C Current (+in)[kA]

Winding 4 Currents

ParameterUnitDefaultDescription
IAB4Text··Name for A to B Winding Current [kA]Used when (YD4)
IBC4Text··Name for B to C Winding Current [kA]Used when (YD4)
ICA4Text··Name for C to A Winding Current [kA]Used when (YD4)
ILA4Text··Name for Phase A Current (+in)[kA]
ILB4Text··Name for Phase B Current (+in)[kA]
ILC4Text··Name for Phase C Current (+in)[kA]

Winding Voltages

ParameterUnitDefaultDescription
V1RealkV230.0Winding 1 Line to Line voltage (RMS)Enter the RMS voltage rating of winding 1At least 0.0001
V2RealkV230.0Winding 2 Line to Line voltage (RMS)Enter the RMS voltage rating of winding 2At least 0.0001
V3RealkV230.0Winding 3 Line to Line voltage (RMS)Enter the RMS voltage rating of winding 3At least 0.0001
V4RealkV230.0Winding 4 Line to Line voltage (RMS)Enter the RMS voltage rating of winding 4At least 0.0001

Related

← master:xfmr-3p3w2 3 Phase 3 Winding Transformer · master:xfmr-3p4w2 3 Phase 4 Winding Transformer →