cimpy.cgmes_v2_4_15.ExcSK module

class cimpy.cgmes_v2_4_15.ExcSK.ExcSK(efdmax=0.0, efdmin=0.0, emax=0.0, emin=0.0, k=0.0, k1=0.0, k2=0.0, kc=0.0, kce=0.0, kd=0.0, kgob=0.0, kp=0.0, kqi=0.0, kqob=0.0, kqp=0.0, nq=0.0, qconoff=False, qz=0.0, remote=False, sbase=0.0, tc=0, te=0, ti=0, tp=0, tr=0, uimax=0.0, uimin=0.0, urmax=0.0, urmin=0.0, vtmax=0.0, vtmin=0.0, yp=0.0, *args, **kw_args)[source]

Slovakian Excitation System Model. UEL and secondary voltage control are included in this model. When this model is used, there cannot be a separate underexcitation limiter or VAr controller model.

efdmax

Field voltage clipping limit (Efdmax). Default: 0.0

efdmin

Field voltage clipping limit (Efdmin). Default: 0.0

emax

Maximum field voltage output (Emax). Typical Value = 20. Default: 0.0

emin

Minimum field voltage output (Emin). Typical Value = -20. Default: 0.0

k

Gain (K). Typical Value = 1. Default: 0.0

k1

Parameter of underexcitation limit (K1). Typical Value = 0.1364. Default: 0.0

k2

Parameter of underexcitation limit (K2). Typical Value = -0.3861. Default: 0.0

kc

PI controller gain (Kc). Typical Value = 70. Default: 0.0

kce

Rectifier regulation factor (Kce). Typical Value = 0. Default: 0.0

kd

Exciter internal reactance (Kd). Typical Value = 0. Default: 0.0

kgob

P controller gain (Kgob). Typical Value = 10. Default: 0.0

kp

PI controller gain (Kp). Typical Value = 1. Default: 0.0

kqi

PI controller gain of integral component (Kqi). Typical Value = 0. Default: 0.0

kqob

Rate of rise of the reactive power (Kqob). Default: 0.0

kqp

PI controller gain (Kqp). Typical Value = 0. Default: 0.0

nq

Dead band of reactive power (nq). Determines the range of sensitivity. Typical Value = 0.001. Default: 0.0

qconoff

Secondary voltage control state (Qc_on_off). true = secondary voltage control is ON false = secondary voltage control is OFF. Typical Value = false. Default: False

qz

Desired value (setpoint) of reactive power, manual setting (Qz). Default: 0.0

remote

Selector to apply automatic calculation in secondary controller model. true = automatic calculation is activated false = manual set is active; the use of desired value of reactive power (Qz) is required. Typical Value = true. Default: False

sbase

Apparent power of the unit (Sbase). Unit = MVA. Typical Value = 259. Default: 0.0

tc

PI controller phase lead time constant (Tc). Typical Value = 8. Default: 0

te

Time constant of gain block (Te). Typical Value = 0.1. Default: 0

ti

PI controller phase lead time constant (Ti). Typical Value = 2. Default: 0

tp

Time constant (Tp). Typical Value = 0.1. Default: 0

tr

Voltage transducer time constant (Tr). Typical Value = 0.01. Default: 0

uimax

Maximum error (Uimax). Typical Value = 10. Default: 0.0

uimin

Minimum error (UImin). Typical Value = -10. Default: 0.0

urmax

Maximum controller output (URmax). Typical Value = 10. Default: 0.0

urmin

Minimum controller output (URmin). Typical Value = -10. Default: 0.0

vtmax

Maximum terminal voltage input (Vtmax). Determines the range of voltage dead band. Typical Value = 1.05. Default: 0.0

vtmin

Minimum terminal voltage input (Vtmin). Determines the range of voltage dead band. Typical Value = 0.95. Default: 0.0

yp

Maximum output (Yp). Minimum output = 0. Typical Value = 1. Default: 0.0

Documentation of parent class ExcitationSystemDynamics:

Excitation system function block whose behavior is described by reference to a standard model

SynchronousMachineDynamics

Synchronous machine model with which this excitation system model is associated. Default: None

PowerSystemStabilizerDynamics

Power system stabilizer model associated with this excitation system model. Default: None

PFVArControllerType1Dynamics

Power Factor or VAr controller Type I model associated with this excitation system model. Default: None

VoltageCompensatorDynamics

Voltage compensator model associated with this excitation system model. Default: None

DiscontinuousExcitationControlDynamics

Discontinuous excitation control model associated with this excitation system model. Default: None

UnderexcitationLimiterDynamics

Undrexcitation limiter model associated with this excitation system model. Default: None

PFVArControllerType2Dynamics

Power Factor or VAr controller Type II model associated with this excitation system model. Default: None

OverexcitationLimiterDynamics

Overexcitation limiter model associated with this excitation system model. 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:

Inheritance diagram of cimpy.cgmes_v2_4_15.ExcSK