cimpy.cgmes_v2_4_15.GovCT1 module

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

mwbase

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

r

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

rselect

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

tpelec

Electrical power transducer time constant (Tpelec) (>0). Typical Value = 1. Default: 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

kpgov

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

kigov

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

kdgov

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

tdgov

Governor derivative controller time constant (Tdgov). Typical Value = 1. Default: 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

tact

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

kturb

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

wfnl

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

tb

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

tc

Turbine lead time constant (Tc). Typical Value = 0. Default: 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

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

tfload

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

kpload

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

kiload

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

ldref

Load limiter reference value (Ldref). Typical Value = 1. 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

ropen

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

rclose

Minimum valve closing rate (Rclose). Unit = PU/sec. Typical Value = -0.1. 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

aset

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

ka

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

ta

Acceleration limiter time constant (Ta) (>0). Typical Value = 0.1. Default: 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

tsa

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

tsb

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

rup

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

rdown

Maximum rate of load limit decrease (Rdown). Typical Value = -99. 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 Profile

Inheritance Diagram: