master:hy_tur parametersPSCAD Hydro Turbine

Every parameter of the PSCAD Hydro Turbine (master:hy_tur): 47 names, with the unit, the default and the meaning PSCAD gives each one. Copy a name into parameters().

What master:hy_tur is

Hydro Turbine, a component of PSCAD's Master Library, filed under machines, exciters and governors.

Definition
master:hy_tur
PSCAD name
Hydro Turbine
Category
Machines, exciters and governors
Parameters
47, in 9 groups; 29 carry a unit
Read from
PSCAD 5.0.0, 2026-11-07

Read and write master:hy_tur 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:hy_tur"):   # the exact definition, namespace first
    params = comp.parameters()           # every parameter, as PSCAD holds it
    print(str(params["D_1"]))            # Turbine Damping Constant (D), in pu

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

Tur1: Non-Elastic Water Column and No Surge Tank

ParameterUnitDefaultDescription
D_1Realpu0.5Turbine Damping Constant (D)At least 0
FP_1Realpu0.02Penstock Head Loss Coefficient (fp)At least 0
TW_1Reals2.0Water Starting Time (TW)At least 0

Tur2: Elastic Water Column and No Surge Tank

ParameterUnitDefaultDescription
D_2Realpu0.5Turbine Damping Constant (D)At least 0
FP_2Realpu0.02Penstock Head Loss Coefficient ( fp )At least 0
TE_2Reals2.0Penstock Elastic Time (Te)At least 0
TW_2Reals2.0Water Starting Time (TW)At least 0

Tur3: Non-Elastic Water Column With Surge Tank

ParameterUnitDefaultDescription
D_3Realpu0.5Turbine Damping Constant (D)At least 0
FO_3Realpu0.02Orifice Head Loss Coefficient (f0)At least 0
FP1_3Realpu0.02Penstock Head Loss Coefficient (fp1)At least 0
FP2_3Realpu0.02Tunnel Head Loss Coefficient (fp2)At least 0
TS_3Reals100.0Surge Tank Riser Time ( Cs )At least 0
TW1_3Reals2.0Penstock Water Starting Time (TW1)At least 0
TW2_3Reals2.0Tunnel Water Starting Time (TW2)At least 0

Tur4: Elastic Water Column With Surge Tank

ParameterUnitDefaultDescription
D_4Realpu0.5Turbine Damping Constant (D)At least 0
FO_4Realpu0.02Orifice Head Loss Coefficient (f0)At least 0
FP1_4Realpu0.02Penstock Head Loss Coefficient (fp1)At least 0
FP2_4Realpu0.02Tunnel Head Loss Coefficient (fp2)At least 0
TE_4Reals2.0Penstock Elastic Time (Tep)At least 0
TS_4Reals100.0Surge Tank Riser Time ( Cs )At least 0
TW1_4Reals2.0Penstock Water Starting Time (TW1)At least 0
TW2_4Reals2.0Tunnel Water Starting Time (TW2)At least 0

Internal Output Variables 1

ParameterUnitDefaultDescription
FLOWText··Name for Flow Before Reduction [pu]
HEADText··Name for Turbine Head [pu]
P_INText··Power Input to the Turbine
P_OUTText··Power Output of the Turbine
Q_DEFText··Output name for Jet Deflector Flow [pu]Used when (JD==1)
Q_NTText··Name for Net Turbine Flow [pu]
Q_RLFText··Name for Relief Valve Flow [pu]Used when (RV==1)

Initial Conditions

ParameterUnitDefaultDescription
HIRealpu1.0Initial Operating HeadRange 0 to 2
PM0Realpu1.0Initial Output PowerRange 0 to 2

Rated Conditions

ParameterUnitDefaultDescription
HRRealpu1.0Head at Rated ConditionsRange 0.01 to 2
PRRealpu1.0Output Power at Rated ConditionsRange 0.01 to 2
QGChoice·FLOWRated No-Load ConditionsWritten as FLOW (Flow), GATE (Gate)Used when (WC+ST==0)
QNLRealpu0.05Rated No-load FlowRange 0 to 1Used when ( !(WC+ST==0) || (QG==0))
ZNLRealpu0.05Rated No-Load GateRange 0 to 1Used when ((QG==1) && (WC+ST==0))
ZRRealpu1.0Gate Position at Rated ConditionsRange 0.01 to 1

Configuration

ParameterUnitDefaultDescription
INITInteger·1Turbine Status: 0-Initialize;1-NormalRange -2147483648 to 2147483647
JDChoice·NOInput Signal for Jet Deflecter Required?Written as NO (No), YES (Yes)
NameText··Name for IdentificationEnter a name for identification
RVChoice·NOInput Signal for Relief Valve Required?Written as NO (No), YES (Yes)
STChoice·NOSurge TankWritten as NO (No), YES (Yes)
WCChoice·NOElastic Water ColumnWritten as NO (No), YES (Yes)

Internal Output Variables 2

ParameterUnitDefaultDescription
P_FLOWText··Name for Penstock Flow Rate [pu]
P_HEADText··Name for Penstock Head [pu]
S_FLOWText··Name for Surge Tank Flow Rate [pu]
S_HEADText··Name for Surge Tank Head [pu]

Related

← master:hydro_gov Hydro Governor/Turbine · master:macdefn macdefn →