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 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, "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
| Parameter | Unit | Default | Description |
|---|---|---|---|
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
| Parameter | Unit | Default | Description |
|---|---|---|---|
BETAReal | · | 0.96 | Parameter to adjust K with MThis parameter adjusts domian pinning parameter with magnetization for better representation of shoulder areaRange 0 to 0.98 |
CReal | · | 0.1 | Domain Flexing ParameterThis parameter represents the contribution of reversible magnetization processRange 0.001 to 0.5 |
F1Real | · | 2730.0 | Coefficient 1 of Anhysteretic CurveAt least 0 |
F2Real | · | 3209.0 | Coefficient 2 of Anhysteretic CurveAt least 0 |
F3Real | · | 20294.0 | Coefficient 3 of Anhysteretic CurveAt least 0 |
FbReal | · | 2.0 | Coefficient 4 of Anhysteretic CurveAt least 1 |
KReal | A/m | 5.0e-5 | Domain Pinning ParameterThis parameter has a direct impact on the width of the loopAt least 1e-007 |
MsatReal | A/m | 1.72e6 | Saturated Anhysteretic MagnetizationAt least 100000 |
alphaReal | · | 1.325e-05 | Interdomain CouplingAt least 1e-008 |
Saturation
| Parameter | Unit | Default | Description |
|---|---|---|---|
BnomReal | T | 1.7 | Nominal flux density [T]Enter the nominal flux density corresponding to saturation curveAt least 1e-307Used when (Hys==2) |
EnabChoice | · | NO | Saturation enabledSelect Yes or No to enable or disable the core saturation routineWritten as NO (No), YES (Yes) |
FremnReal | pu | 0.0 | Remanent 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 | · | NONE | HysteresisSelect the hysteresis model from available optionsWritten as NONE (None), BASIC_MODEL (Basic model), JILES_ATHERTON (Jiles_Atherton) |
Im1Real | % | 0.4 | Magnetizing currentEnter the magnetizing current as a percentage of base currentRange 0.0001 to 50 |
LW2Real | % | 10 | Loop widthEnter the loop width as a percentage of magnetizing currentRange 0 to 100Used when (Hys==1) |
SatChoice | · | MIDDLE | Place saturation on windingSelect the winding # on which to place the magnetization branchWritten as MIDDLE (Middle), _1 (#1), _2 (#2), _3 (#3) |
TdcReal | s | 0.0 | Inrush decay time constantFictitious damping of inrush can be enabled by using a non-zero time constantAt least 0.0Used when Hys==0 |
TxkReal | s | 0.0 | Time to release flux clippingThis could be used to reduce start-up transientsRange 0 to 1e+006Used when Hys==0 |
XairReal | pu | 0.2 | Air core reactanceEnter the air core reactance based on transformer base impedanceRange 1e-008 to 1 |
XkneeReal | pu | 1.17 | Knee voltageEnter the knee point voltage corresponding to saturation curveAt least 1e-307 |
materialChoice | · | DEFAULT | Magnetic materialSelect the magnetic materialWritten as CUSTOM_MATERIAL (custom material), DEFAULT (default)Used when (Hys==2) |
Configuration
| Parameter | Unit | Default | Description |
|---|---|---|---|
CuLReal | pu | 0.0 | Copper lossesEnter the copper losses based on transformer base impedanceRange 0 to 1 |
IdealChoice | · | NO | Ideal transformer modelSelect Yes or NoWritten as NO (No), YES (Yes) |
NLLReal | pu | 0.0 | Eddy 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 | · | NONE | Tap changer on windingSelect the winding number on which to place the on-line tap changerWritten as NONE (None), _1 (#1), _2 (#2), _3 (#3) |
TmvaReal | MVA | 100.0 | Transformer MVAEnter the apparent power rating of the transformerAt least 1e-006 |
V1Real | kV | 230.0 | Winding #1 voltage (RMS)Enter the RMS voltage rating of winding 1At least 0.0001 |
V2Real | kV | 230.0 | Winding #2 voltage (RMS)Enter the RMS voltage rating of winding 2At least 0.0001 |
V3Real | kV | 230.0 | Winding #3 voltage (RMS)Enter the RMS voltage rating of winding 3At least 0.0001 |
ViewChoice | · | WINDINGS | Graphics DisplaySelect the preferred view of graphics: Windings or CirclesWritten as CIRCLES (Circles), WINDINGS (Windings) |
Xl12Real | pu | 0.1 | Leakage reactance (#1-#2)Enter the leakge reactance based on transformer base impedanceAt least 1e-307 |
Xl13Real | pu | 0.1 | Leakage reactance (#1-#3)Enter the leakge reactance based on transformer base impedanceAt least 1e-307 |
Xl23Real | pu | 0.1 | Leakage reactance (#2-#3)Enter the leakge reactance based on transformer base impedanceAt least 1e-307 |
fReal | Hz | 60.0 | Base 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 →