cimpy.cgmes_v2_4_15.GovHydroFrancis module

class cimpy.cgmes_v2_4_15.GovHydroFrancis.GovHydroFrancis(am=0.0, av0=0.0, av1=0.0, bp=0.0, db1=0.0, etamax=0.0, governorControl=None, h1=0.0, h2=0.0, hn=0.0, kc=0.0, kg=0.0, kt=0.0, qc0=0.0, qn=0.0, ta=0.0, td=0.0, ts=0.0, twnc=0.0, twng=0.0, tx=0.0, va=0.0, valvmax=0.0, valvmin=0.0, vc=0.0, waterTunnelSurgeChamberSimulation=False, zsfc=0.0, *args, **kw_args)[source]

Detailed hydro unit - Francis model. This model can be used to represent three types of governors. A schematic of the hydraulic system of detailed hydro unit models, like Francis and Pelton, is provided in the DetailedHydroModelHydraulicSystem diagram.

am:

Opening section S at the maximum efficiency (Am). Typical Value = 0.7. Default: 0.0

av0:

Area of the surge tank (A). Unit = m. Typical Value = 30. Default: 0.0

av1:

Area of the compensation tank (A). Unit = m. Typical Value = 700. Default: 0.0

bp:

Droop (Bp). Typical Value = 0.05. Default: 0.0

db1:

Intentional dead-band width (DB1). Unit = Hz. Typical Value = 0. Default: 0.0

etamax:

Maximum efficiency (EtaMax). Typical Value = 1.05. Default: 0.0

governorControl:

Governor control flag (Cflag). Typical Value = mechanicHydrolicTachoAccelerator. Default: None

h1:

Head of compensation chamber water level with respect to the level of penstock (H). Unit = m. Typical Value = 4. Default: 0.0

h2:

Head of surge tank water level with respect to the level of penstock (H). Unit = m. Typical Value = 40. Default: 0.0

hn:

Rated hydraulic head (H). Unit = m. Typical Value = 250. Default: 0.0

kc:

Penstock loss coefficient (due to friction) (Kc). Typical Value = 0.025. Default: 0.0

kg:

Water tunnel and surge chamber loss coefficient (due to friction) (Kg). Typical Value = 0.025. Default: 0.0

kt:

Washout gain (Kt). Typical Value = 0.25. Default: 0.0

qc0:

No-load turbine flow at nominal head (Qc0). Typical Value = 0.21. Default: 0.0

qn:

Rated flow (Q). Unit = m/s. Typical Value = 40. Default: 0.0

ta:

Derivative gain (Ta). Typical Value = 3. Default: 0.0

td:

Washout time constant (Td). Typical Value = 3. Default: 0.0

ts:

Gate servo time constant (Ts). Typical Value = 0.5. Default: 0.0

twnc:

Water inertia time constant (Twnc). Typical Value = 1. Default: 0.0

twng:

Water tunnel and surge chamber inertia time constant (Twng). Typical Value = 3. Default: 0.0

tx:

Derivative feedback gain (Tx). Typical Value = 1. Default: 0.0

va:

Maximum gate opening velocity (Va). Unit = PU/sec. Typical Value = 0.011. Default: 0.0

valvmax:

Maximum gate opening (ValvMax). Typical Value = 1. Default: 0.0

valvmin:

Minimum gate opening (ValvMin). Typical Value = 0. Default: 0.0

vc:

Maximum gate closing velocity (Vc). Unit = PU/sec. Typical Value = -0.011. Default: 0.0

waterTunnelSurgeChamberSimulation:

Water tunnel and surge chamber simulation (Tflag). true = enable of water tunnel and surge chamber simulation false = inhibit of water tunnel and surge chamber simulation. Typical Value = false. Default: False

zsfc:

Head of upper water level with respect to the level of penstock (Zsfc). Unit = m. Typical Value = 25. Default: 0.0

Documentation of parent class TurbineGovernorDynamics:

Turbine-governor function block whose behavior is described by reference to a standard model

AsynchronousMachineDynamics:

Asynchronous machine model with which this turbine-governor model is associated. Default: None

SynchronousMachineDynamics:

Turbine-governor model associated with this synchronous machine model. Default: “list”

TurbineLoadControllerDynamics:

Turbine load controller providing input to this turbine-governor. Default: None

Documentation of parent class DynamicsFunctionBlock:

Abstract parent class for all Dynamics function blocks.

enabled:

Function block used indicator. true = use of function block is enabled false = use of function block is disabled. Default: False

Documentation of parent class IdentifiedObject:

This is a root class to provide common identification for all classes needing identification and naming attributes.

DiagramObjects:

The domain object to which this diagram object is associated. Default: “list”

description:

The description is a free human readable text describing or naming the object. It may be non unique and may not correlate to a naming hierarchy. Default: ‘’

energyIdentCodeEic:

The attribute is used for an exchange of the EIC code (Energy identification Code). The length of the string is 16 characters as defined by the EIC code. References: Default: ‘’

mRID:

Master resource identifier issued by a model authority. The mRID is globally unique within an exchange context. Global uniqueness is easily achieved by using a UUID, as specified in RFC 4122, for the mRID. The use of UUID is strongly recommended. For CIMXML data files in RDF syntax conforming to IEC 61970-552 Edition 1, the mRID is mapped to rdf:ID or rdf:about attributes that identify CIM object elements. Default: ‘’

name:

The name is any free human readable and possibly non unique text naming the object. Default: ‘’

shortName:

The attribute is used for an exchange of a human readable short name with length of the string 12 characters maximum. Default: ‘’

Inheritance Diagram:

Inheritance diagram of cimpy.cgmes_v2_4_15.GovHydroFrancis