cimpy.cgmes_v2_4_15.GovHydro4 module

class cimpy.cgmes_v2_4_15.GovHydro4.GovHydro4(at=0.0, bgv0=0.0, bgv1=0.0, bgv2=0.0, bgv3=0.0, bgv4=0.0, bgv5=0.0, bmax=0.0, db1=0.0, db2=0.0, dturb=0.0, eps=0.0, gmax=0.0, gmin=0.0, gv0=0.0, gv1=0.0, gv2=0.0, gv3=0.0, gv4=0.0, gv5=0.0, hdam=0.0, mwbase=0.0, pgv0=0.0, pgv1=0.0, pgv2=0.0, pgv3=0.0, pgv4=0.0, pgv5=0.0, qn1=0.0, rperm=0.0, rtemp=0.0, tblade=0.0, tg=0.0, tp=0.0, tr=0.0, tw=0.0, uc=0.0, uo=0.0, *args, **kw_args)

Hydro turbine and governor. Represents plants with straight-forward penstock configurations and hydraulic governors of traditional ‘dashpot’ type. This model can be used to represent simple, Francis, Pelton or Kaplan turbines.

at:

Turbine gain (At). Typical Value = 1.2. Default: 0.0

bgv0:

Kaplan blade servo point 0 (Bgv0). Typical Value = 0. Default: 0.0

bgv1:

Kaplan blade servo point 1 (Bgv1). Typical Value = 0. Default: 0.0

bgv2:

Kaplan blade servo point 2 (Bgv2). Typical Value = 0. Typical Value Francis = 0, Kaplan = 0.1. Default: 0.0

bgv3:

Kaplan blade servo point 3 (Bgv3). Typical Value = 0. Typical Value Francis = 0, Kaplan = 0.667. Default: 0.0

bgv4:

Kaplan blade servo point 4 (Bgv4). Typical Value = 0. Typical Value Francis = 0, Kaplan = 0.9. Default: 0.0

bgv5:

Kaplan blade servo point 5 (Bgv5). Typical Value = 0. Typical Value Francis = 0, Kaplan = 1. Default: 0.0

bmax:

Maximum blade adjustment factor (Bmax). Typical Value = 0. Typical Value Francis = 0, Kaplan = 1.1276. Default: 0.0

db1:

Intentional deadband width (db1). Unit = Hz. Typical Value = 0. Default: 0.0

db2:

Unintentional dead-band (db2). Unit = MW. Typical Value = 0. Default: 0.0

dturb:

Turbine damping factor (Dturb). Unit = delta P (PU of MWbase) / delta speed (PU). Typical Value = 0.5. Typical Value Francis = 1.1, Kaplan = 1.1. Default: 0.0

eps:

Intentional db hysteresis (eps). Unit = Hz. Typical Value = 0. Default: 0.0

gmax:

Maximum gate opening, PU of MWbase (Gmax). Typical Value = 1. Default: 0.0

gmin:

Minimum gate opening, PU of MWbase (Gmin). Typical Value = 0. Default: 0.0

gv0:

Nonlinear gain point 0, PU gv (Gv0). Typical Value = 0. Typical Value Francis = 0.1, Kaplan = 0.1. Default: 0.0

gv1:

Nonlinear gain point 1, PU gv (Gv1). Typical Value = 0. Typical Value Francis = 0.4, Kaplan = 0.4. Default: 0.0

gv2:

Nonlinear gain point 2, PU gv (Gv2). Typical Value = 0. Typical Value Francis = 0.5, Kaplan = 0.5. Default: 0.0

gv3:

Nonlinear gain point 3, PU gv (Gv3). Typical Value = 0. Typical Value Francis = 0.7, Kaplan = 0.7. Default: 0.0

gv4:

Nonlinear gain point 4, PU gv (Gv4). Typical Value = 0. Typical Value Francis = 0.8, Kaplan = 0.8. Default: 0.0

gv5:

Nonlinear gain point 5, PU gv (Gv5). Typical Value = 0. Typical Value Francis = 0.9, Kaplan = 0.9. Default: 0.0

hdam:

Head available at dam (hdam). Typical Value = 1. Default: 0.0

mwbase:

Base for power values (MWbase) (>0). Unit = MW. Default: 0.0

pgv0:

Nonlinear gain point 0, PU power (Pgv0). Typical Value = 0. Default: 0.0

pgv1:

Nonlinear gain point 1, PU power (Pgv1). Typical Value = 0. Typical Value Francis = 0.42, Kaplan = 0.35. Default: 0.0

pgv2:

Nonlinear gain point 2, PU power (Pgv2). Typical Value = 0. Typical Value Francis = 0.56, Kaplan = 0.468. Default: 0.0

pgv3:

Nonlinear gain point 3, PU power (Pgv3). Typical Value = 0. Typical Value Francis = 0.8, Kaplan = 0.796. Default: 0.0

pgv4:

Nonlinear gain point 4, PU power (Pgv4). Typical Value = 0. Typical Value Francis = 0.9, Kaplan = 0.917. Default: 0.0

pgv5:

Nonlinear gain point 5, PU power (Pgv5). Typical Value = 0. Typical Value Francis = 0.97, Kaplan = 0.99. Default: 0.0

qn1:

No-load flow at nominal head (Qnl). Typical Value = 0.08. Typical Value Francis = 0, Kaplan = 0. Default: 0.0

rperm:

Permanent droop (Rperm). Typical Value = 0.05. Default: 0.0

rtemp:

Temporary droop (Rtemp). Typical Value = 0.3. Default: 0.0

tblade:

Blade servo time constant (Tblade). Typical Value = 100. Default: 0.0

tg:

Gate servo time constant (Tg) (>0). Typical Value = 0.5. Default: 0.0

tp:

Pilot servo time constant (Tp). Typical Value = 0.1. Default: 0.0

tr:

Dashpot time constant (Tr) (>0). Typical Value = 5. Default: 0.0

tw:

Water inertia time constant (Tw) (>0). Typical Value = 1. Default: 0.0

uc:

Max gate closing velocity (Uc). Typical Value = 0.2. Default: 0.0

uo:

Max gate opening velocity (Uo). Typical Vlaue = 0.2. 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: