cimpy.cgmes_v2_4_15.ExcIEEEAC8B module

class cimpy.cgmes_v2_4_15.ExcIEEEAC8B.ExcIEEEAC8B(ka=0.0, kc=0.0, kd=0.0, kdr=0.0, ke=0.0, kir=0.0, kpr=0.0, seve1=0.0, seve2=0.0, ta=0.0, tdr=0.0, te=0.0, ve1=0.0, ve2=0.0, vemin=0.0, vfemax=0.0, vrmax=0.0, vrmin=0.0, *args, **kw_args)

The class represents IEEE Std 421.5-2005 type AC8B model. This model represents a PID voltage regulator with either a brushless exciter or dc exciter. The AVR in this model consists of PID control, with separate constants for the proportional (), integral (), and derivative () gains. The representation of the brushless exciter (, , , , ) is similar to the model Type AC2A. The Type AC8B model can be used to represent static voltage regulators applied to brushless excitation systems. Digitally based voltage regulators feeding dc rotating main exciters can be represented with the AC Type AC8B model with the parameters and set to 0. For thyristor power stages fed from the generator terminals, the limits and should be a function of terminal voltage: * and * . Reference: IEEE Standard 421.5-2005 Section 6.8.

ka:

Voltage regulator gain (K). Typical Value = 1. Default: 0.0

kc:

Rectifier loading factor proportional to commutating reactance (K). Typical Value = 0.55. Default: 0.0

kd:

Demagnetizing factor, a function of exciter alternator reactances (K). Typical Value = 1.1. Default: 0.0

kdr:

Voltage regulator derivative gain (K). Typical Value = 10. Default: 0.0

ke:

Exciter constant related to self-excited field (K). Typical Value = 1. Default: 0.0

kir:

Voltage regulator integral gain (K). Typical Value = 5. Default: 0.0

kpr:

Voltage regulator proportional gain (K). Typical Value = 80. Default: 0.0

seve1:

Exciter saturation function value at the corresponding exciter voltage, V, back of commutating reactance (S[V]). Typical Value = 0.3. Default: 0.0

seve2:

Exciter saturation function value at the corresponding exciter voltage, V, back of commutating reactance (S[V]). Typical Value = 3. Default: 0.0

ta:

Voltage regulator time constant (T). Typical Value = 0. Default: 0.0

tdr:

Lag time constant (T). Typical Value = 0.1. Default: 0.0

te:

Exciter time constant, integration rate associated with exciter control (T). Typical Value = 1.2. Default: 0.0

ve1:

Exciter alternator output voltages back of commutating reactance at which saturation is defined (V) equals V (V). Typical Value = 6.5. Default: 0.0

ve2:

Exciter alternator output voltages back of commutating reactance at which saturation is defined (V). Typical Value = 9. Default: 0.0

vemin:

Minimum exciter voltage output (V). Typical Value = 0. Default: 0.0

vfemax:

Exciter field current limit reference (V). Typical Value = 6. Default: 0.0

vrmax:

Maximum voltage regulator output (V). Typical Value = 35. Default: 0.0

vrmin:

Minimum voltage regulator output (V). Typical Value = 0. Default: 0.0

Documentation of parent class ExcitationSystemDynamics:

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

DiscontinuousExcitationControlDynamics:

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

OverexcitationLimiterDynamics:

Overexcitation limiter 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

PFVArControllerType2Dynamics:

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

PowerSystemStabilizerDynamics:

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

SynchronousMachineDynamics:

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

UnderexcitationLimiterDynamics:

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

VoltageCompensatorDynamics:

Voltage compensator 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”

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: