cimpy.cgmes_v2_4_15.GovHydroPID module

class cimpy.cgmes_v2_4_15.GovHydroPID.GovHydroPID(mwbase=0.0, pmax=0.0, pmin=0.0, r=0.0, td=0, tf=0, tp=0, velop=0.0, velcl=0.0, kd=0.0, kp=0.0, ki=0.0, kg=0.0, tturb=0, aturb=0.0, bturb=0.0, tt=0, db1=0.0, inputSignal=False, eps=0.0, db2=0.0, gv1=0.0, pgv1=0.0, gv2=0.0, pgv2=0.0, gv3=0.0, pgv3=0.0, gv4=0.0, pgv4=0.0, gv5=0.0, pgv5=0.0, gv6=0.0, pgv6=0.0, *args, **kw_args)

PID governor and turbine.

mwbase

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

pmax

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

pmin

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

r

Steady state droop (R). Typical Value = 0.05. Default: 0.0

td

Input filter time constant (Td). Typical Value = 0. Default: 0

tf

Washout time constant (Tf). Typical Value = 0.1. Default: 0

tp

Gate servo time constant (Tp). Typical Value = 0.35. Default: 0

velop

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

velcl

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

kd

Derivative gain (Kd). Typical Value = 1.11. Default: 0.0

kp

Proportional gain (Kp). Typical Value = 0.1. Default: 0.0

ki

Integral gain (Ki). Typical Value = 0.36. Default: 0.0

kg

Gate servo gain (Kg). Typical Value = 2.5. Default: 0.0

tturb

Turbine time constant (Tturb) (note 3). Typical Value = 0.8. Default: 0

aturb

Turbine numerator multiplier (Aturb) (note 3). Typical Value -1. Default: 0.0

bturb

Turbine denominator multiplier (Bturb) (note 3). Typical Value = 0.5. Default: 0.0

tt

Power feedback time constant (Tt). Typical Value = 0.02. Default: 0

db1

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

inputSignal

Input signal switch (Flag). true = Pe input is used false = feedback is received from CV. Flag is normally dependent on Tt. If Tf is zero, Flag is set to false. If Tf is not zero, Flag is set to true. Typical Value = true. Default: False

eps

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

db2

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

gv1

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

pgv1

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

gv2

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

pgv2

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

gv3

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

pgv3

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

gv4

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

pgv4

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

gv5

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

pgv5

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

gv6

Nonlinear gain point 6, PU gv (Gv6). Typical Value = 0. Default: 0.0

pgv6

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

Documentation of parent class TurbineGovernorDynamics:

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

SynchronousMachineDynamics

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

AsynchronousMachineDynamics

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

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”

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: ‘’

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: ‘’

shortName

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

cgmesProfile

alias of cimpy.cgmes_v2_4_15.Base.Profile

Inheritance Diagram: