master:hy_gov parametersPSCAD Hydro Governor

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

What master:hy_gov is

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

Definition
master:hy_gov
PSCAD name
Hydro Governor
Category
Machines, exciters and governors
Parameters
33, in 7 groups; 28 carry a unit
Read from
PSCAD 5.0.0, 2026-11-07

Read and write master:hy_gov 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_gov"):   # the exact definition, namespace first
    params = comp.parameters()           # every parameter, as PSCAD holds it
    print(str(params["DB"]))             # Dead Band Value, in pu

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

Common

ParameterUnitDefaultDescription
DBRealpu0.0Dead Band ValueAt least 0
GMAXRealpu1.0Maximum Gate Position (Gmax)Range 0 to 1
GMINRealpu0.0Minimum Gate Position (Gmin)Range 0 to 1
MGCRRealpu/s0.16Maximum Gate closing Rate (MXGTCR)Range 0 to 1
MGORRealpu/s0.16Maximum Gate Opening Rate (MXGTOR)Range 0 to 1
RPRealpu0.04Permanent Droop (Rp)At least 0

Configuration

ParameterUnitDefaultDescription
H_GOVChoice·GOV_1Hydro Governor ModelWritten as GOV_1 (Gov 1), GOV_2 (Gov 2), GOV_3 (Gov 3)
INITInteger·1Governor/Turbine Status: 0-Initialize;1-NormalRange -2147483648 to 2147483647
NameText··Name for IdentificationEnter a name for identification

Gov3: Enhanced Governor

ParameterUnitDefaultDescription
JET_DChoice·NOIs Jet deflector in Operation?Written as NO (No), YES (Yes)
RELFChoice·NOIs Relief Valve in Operation?Written as NO (No), YES (Yes)
RT_3Realpu0.45Temporary Droop (Rt)At least 0.0001
TG_3Reals0.5Main Servo Time Constant (Tg)At least 0.0001
TP_3Reals0.02Pilot Valve Time Constant (Tp)At least 0
TR_3Reals8.0Reset or Dashpot Time Constant (TR)At least 0

Gov2: Electro-Hydraulic (Pid) Governor

ParameterUnitDefaultDescription
KD_2Realpu0.5Derivative Gain ( Kd )At least 0
KI_2Realpu0.7Integral Gain ( Ki )At least 0
KP_2Realpu3.0Proportional Gain ( Kp)At least 0
TA_2Reals0.05Pilot Servomotor Time Constant (TA)At least 0
TC_2Reals0.2Gate Servo Time Constant (TC)At least 0
TD_2Reals0.2Gate Servomotor Time Constant (TD)At least 0

Gov3: Jet Deflector Details

ParameterUnitDefaultDescription
MBCR_3Realpu/s0.1Maximum Buffer closing Rate (MXBGCR)Range 0 to 1
MBOR_3Realpu/s0.1Maximum Buffer Opening Rate (MXBGOR)Range 0 to 1
MJCR_3Realpu/s0.1Maximum Deflector Closing Rate (MXJDCR)Range 0 to 1
MJOR_3Realpu/s0.1Maximum Deflector Opening Rate (MXJDOR)Range 0 to 1
Z_CUTRealpu0.0Gate Buffer Cut-in Value (Z_CUT)Range 0 to 1

Gov1: Mechanical-Hydraulic Governor

ParameterUnitDefaultDescription
Q_1Realpu5.0Servo Gain ( Q )At least 0
RT_1Realpu0.40Temporary Droop (Rt)At least 0
TG_1Reals0.2Main Servo Time Constant (Tg)At least 0
TP_1Reals0.05Pilot Valve and Servomotor Time Constant (Tp)At least 0
TR_1Reals5.0Reset or Dashpot Time Constant (TR)At least 0

Gov3: Relief Valve Details

ParameterUnitDefaultDescription
RVCR_3Realpu0.1Relief Valve Closing Rate (RVLVCR)Range 0 to 1
RVMX_3Realpu1.0Maximum Relief Valve Position (RVLMAX)Range 0 to 1

Related

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