master:Line_FrePhase_Options parametersPSCAD Frequency Dependent (Phase) Model
Every parameter of the PSCAD Frequency Dependent (Phase) Model (master:Line_FrePhase_Options): 26 names, with the unit, the default and the meaning PSCAD gives each one. Copy a name into parameters().
What master:Line_FrePhase_Options is
Frequency Dependent (Phase) Model, a component of PSCAD's Master Library, filed under lines, cables and towers.
- Definition
master:Line_FrePhase_Options- PSCAD name
- Frequency Dependent (Phase) Model
- Category
- Lines, cables and towers
- Parameters
- 26, in 4 groups; 7 carry a unit
- Read from
- PSCAD 5.0.0, 2026-11-07
Read and write master:Line_FrePhase_Options 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:Line_FrePhase_Options"): # the exact definition, namespace first
params = comp.parameters() # every parameter, as PSCAD holds it
print(str(params["AMaxE"])) # Maximum Final Fitting Error, in %
comp = project.find_all("master:Line_FrePhase_Options")[0]
comp.parameters(AMaxE="0.4 [%]") # 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, "AMaxE") and px_set(...), which also records the old value so the case is put back at the end. Getting started shows them.
Curve Fitting
| Parameter | Unit | Default | Description |
|---|---|---|---|
AMaxEReal | % | 0.2 | Maximum Final Fitting ErrorRange 1E-05 to 100000000 |
AMaxPInteger | · | 20 | Maximum Poles per Delay GroupRange 5 to 50 |
FEReal | Hz | 1.0E6 | Upper LimitRange 1E-08 to 100000000 |
FSReal | Hz | 0.01 | Lower LimitRange 1E-08 to 100000000 |
MaxRPtolReal | · | 2000000.0 | Maximum Residue/Pole Ratio ToleranceAt least 1 |
NumfChoice | · | 100 | Total Solution IncrementsWritten as 100, 200, 500, 1000 |
W1Real | · | 1.0 | 0 to F0Range 1 to 100000000 |
W2Real | · | 1.0 | F0Range 1 to 100000000 |
W3Real | · | 1.0 | F0 to FmaxRange 1 to 100000000 |
YMaxEReal | % | 0.2 | Maximum Final Fitting ErrorRange 1E-05 to 100000000 |
YMaxPInteger | · | 20 | Maximum Poles per ColumnRange 5 to 50 |
Passivity Enforcement
| Parameter | Unit | Default | Description |
|---|---|---|---|
CPASSChoice | · | DISABLE | Passivity Scan/EnforcementWritten as DISABLE (Disable), SCAN_ONLY (Scan only), ENFORCEMENT (Enforcement) |
ET_PEReal | · | 1e-10 | Eigenvalue TolerenceUsed when CPASS == 2 |
FDISChoice | · | LOG_LINEAR | DistributionDistribution of frequency samplesWritten as LOG (Log), LINEAR (Linear), LOG_LINEAR (Log + Linear)Used when CPASS != 0 |
FEPReal | Hz | 1E6 | Upper Frequency LimitUpper frequency limit for passivity checking.Range 1E-06 to 100000000Used when CPASS != 0 |
FSPReal | Hz | 0.001 | Lower Frequency LimitLower frequency limit for passivity checking.Range 1E-06 to 100000000Used when CPASS != 0 |
MER_PEReal | · | 2.0 | Maximum Percentage ErrorRange 1E-10 to 100Used when CPASS == 2 |
MIT_PEInteger | · | 5 | Maximum Number of IterationsRange 1 to 20Used when CPASS == 2 |
NFPChoice | · | 1000 | Total Frequency SamplesChoose the number of frequency samples between the specified lower and upper limits. These samples are exclusive from those used in the actual curve fitting of the results.Written as 100, 500, 1000, 2000, 5000Used when CPASS != 0 |
DC Correction
| Parameter | Unit | Default | Description |
|---|---|---|---|
DCCORChoice | · | FUNCTIONAL_FORM | Correction MethodSelect Functional Form or Add Pole/Residue. See EMTDC | Transmission Lines and Cables | DC Correction for details.Written as FUNCTIONAL_FORM (Functional Form), ADD_POLE_RESIDUE (Add Pole/Residue)Used when DCenab == 1 |
DCenabChoice | · | DISABLED | DC Correction isThe goal of the DC Correction procedure is to guarantee the exact fitting of the rational function at zero hertz, hence giving the correct DC response for the line. However, take care to monitor the log file for problems with fitting.Written as DISABLED (Disabled), ENABLED (Enabled) |
enablfChoice | · | YES | Use Loss Tangent for Cable Dielectric Losses (recommended)Written as YES (Yes), NO (No)Used when DCenab == 1 |
shntcabReal | mho/m | 1.0E-9 | Cable Shunt Conductance (obsolete)This value is important in order to obtain a stable time domain simulation (i.e. it improves passivity at low frequencies) and also helps to improve the behaviour of the rational function at low frequencies. The shunt conductance should be a very small value and will not affect the high frequency behaviour of time domain simulations. Typical shunt conductance values should remain in the order of 1e-9 or 1e-10. This input is ignored for overhead lines, as it is entered within the tower component.Range 1E-100 to 100000000Used when DCenab == 1 |
Configuration
| Parameter | Unit | Default | Description |
|---|---|---|---|
InflenChoice | · | NO | Do You Want This to be a Reflectionless Line?reflectionless line corresponds to a line with infinite length. Suitable for high frequency studies of short durations e.g. lightning studiesWritten as NO (No), YES (Yes) |
Interp1Choice | · | YES | Interpolate Travel Times?Written as NO (No), YES (Yes) |
OutputChoice | · | NO | Create Detailed Output Files?Written as NO (No), YES (Yes) |
Related
← master:Line_FreDep_Options Frequency Dependent (Mode) Model · master:Line_Out_Disp LCP Additional Options →