cimpy.cgmes_v2_4_15.GovCT1 module

class cimpy.cgmes_v2_4_15.GovCT1.GovCT1(aset=0.0, db=0.0, dm=0.0, ka=0.0, kdgov=0.0, kigov=0.0, kiload=0.0, kimw=0.0, kpgov=0.0, kpload=0.0, kturb=0.0, ldref=0.0, maxerr=0.0, minerr=0.0, mwbase=0.0, r=0.0, rclose=0.0, rdown=0.0, ropen=0.0, rselect=None, rup=0.0, ta=0.0, tact=0.0, tb=0.0, tc=0.0, tdgov=0.0, teng=0.0, tfload=0.0, tpelec=0.0, tsa=0.0, tsb=0.0, vmax=0.0, vmin=0.0, wfnl=0.0, wfspd=False, *args, **kw_args)

General model for any prime mover with a PID governor, used primarily for combustion turbine and combined cycle units. This model can be used to represent a variety of prime movers controlled by PID governors. It is suitable, for example, for representation of Additional information on this model is available in the 2012 IEEE report, , section 3.1.2.3 page 3-4 (GGOV1).

aset:

Acceleration limiter setpoint (Aset). Unit = PU/sec. Typical Value = 0.01. Default: 0.0

db:

Speed governor dead band in per unit speed (db). In the majority of applications, it is recommended that this value be set to zero. Typical Value = 0. Default: 0.0

dm:

Speed sensitivity coefficient (Dm). Dm can represent either the variation of the engine power with the shaft speed or the variation of maximum power capability with shaft speed. If it is positive it describes the falling slope of the engine speed verses power characteristic as speed increases. A slightly falling characteristic is typical for reciprocating engines and some aero-derivative turbines. If it is negative the engine power is assumed to be unaffected by the shaft speed, but the maximum permissible fuel flow is taken to fall with falling shaft speed. This is characteristic of single-shaft industrial turbines due to exhaust temperature limits. Typical Value = 0. Default: 0.0

ka:

Acceleration limiter gain (Ka). Typical Value = 10. Default: 0.0

kdgov:

Governor derivative gain (Kdgov). Typical Value = 0. Default: 0.0

kigov:

Governor integral gain (Kigov). Typical Value = 2. Default: 0.0

kiload:

Load limiter integral gain for PI controller (Kiload). Typical Value = 0.67. Default: 0.0

kimw:

Power controller (reset) gain (Kimw). The default value of 0.01 corresponds to a reset time of 100 seconds. A value of 0.001 corresponds to a relatively slow acting load controller. Typical Value = 0.01. Default: 0.0

kpgov:

Governor proportional gain (Kpgov). Typical Value = 10. Default: 0.0

kpload:

Load limiter proportional gain for PI controller (Kpload). Typical Value = 2. Default: 0.0

kturb:

Turbine gain (Kturb) (>0). Typical Value = 1.5. Default: 0.0

ldref:

Load limiter reference value (Ldref). Typical Value = 1. Default: 0.0

maxerr:

Maximum value for speed error signal (maxerr). Typical Value = 0.05. Default: 0.0

minerr:

Minimum value for speed error signal (minerr). Typical Value = -0.05. Default: 0.0

mwbase:

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

r:

Permanent droop (R). Typical Value = 0.04. Default: 0.0

rclose:

Minimum valve closing rate (Rclose). Unit = PU/sec. Typical Value = -0.1. Default: 0.0

rdown:

Maximum rate of load limit decrease (Rdown). Typical Value = -99. Default: 0.0

ropen:

Maximum valve opening rate (Ropen). Unit = PU/sec. Typical Value = 0.10. Default: 0.0

rselect:

Feedback signal for droop (Rselect). Typical Value = electricalPower. Default: None

rup:

Maximum rate of load limit increase (Rup). Typical Value = 99. Default: 0.0

ta:

Acceleration limiter time constant (Ta) (>0). Typical Value = 0.1. Default: 0.0

tact:

Actuator time constant (Tact). Typical Value = 0.5. Default: 0.0

tb:

Turbine lag time constant (Tb) (>0). Typical Value = 0.5. Default: 0.0

tc:

Turbine lead time constant (Tc). Typical Value = 0. Default: 0.0

tdgov:

Governor derivative controller time constant (Tdgov). Typical Value = 1. Default: 0.0

teng:

Transport time delay for diesel engine used in representing diesel engines where there is a small but measurable transport delay between a change in fuel flow setting and the development of torque (Teng). Teng should be zero in all but special cases where this transport delay is of particular concern. Typical Value = 0. Default: 0.0

tfload:

Load Limiter time constant (Tfload) (>0). Typical Value = 3. Default: 0.0

tpelec:

Electrical power transducer time constant (Tpelec) (>0). Typical Value = 1. Default: 0.0

tsa:

Temperature detection lead time constant (Tsa). Typical Value = 4. Default: 0.0

tsb:

Temperature detection lag time constant (Tsb). Typical Value = 5. Default: 0.0

vmax:

Maximum valve position limit (Vmax). Typical Value = 1. Default: 0.0

vmin:

Minimum valve position limit (Vmin). Typical Value = 0.15. Default: 0.0

wfnl:

No load fuel flow (Wfnl). Typical Value = 0.2. Default: 0.0

wfspd:

Switch for fuel source characteristic to recognize that fuel flow, for a given fuel valve stroke, can be proportional to engine speed (Wfspd). true = fuel flow proportional to speed (for some gas turbines and diesel engines with positive displacement fuel injectors) false = fuel control system keeps fuel flow independent of engine speed. Typical Value = true. Default: False

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: