cimpy.cgmes_v2_4_15.ExcIEEEDC2A module

class cimpy.cgmes_v2_4_15.ExcIEEEDC2A.ExcIEEEDC2A(efd1=0.0, efd2=0.0, exclim=0.0, ka=0.0, ke=0.0, kf=0.0, seefd1=0.0, seefd2=0.0, ta=0, tb=0, tc=0, te=0, tf=0, uelin=False, vrmax=0.0, vrmin=0.0, *args, **kw_args)[source]

The class represents IEEE Std 421.5-2005 type DC2A model. This model represents represent field-controlled dc commutator exciters with continuously acting voltage regulators having supplies obtained from the generator or auxiliary bus. It differs from the Type DC1A model only in the voltage regulator output limits, which are now proportional to terminal voltage . It is representative of solid-state replacements for various forms of older mechanical and rotating amplifier regulating equipment connected to dc commutator exciters. Reference: IEEE Standard 421.5-2005 Section 5.2.

efd1

Exciter voltage at which exciter saturation is defined (E). Typical Value = 3.05. Default: 0.0

efd2

Exciter voltage at which exciter saturation is defined (E). Typical Value = 2.29. Default: 0.0

exclim

(exclim). IEEE standard is ambiguous about lower limit on exciter output. Typical Value = - 999 which means that there is no limit applied. Default: 0.0

ka

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

ke

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

kf

Excitation control system stabilizer gain (K). Typical Value = 0.1. Default: 0.0

seefd1

Exciter saturation function value at the corresponding exciter voltage, E (S[E]). Typical Value = 0.279. Default: 0.0

seefd2

Exciter saturation function value at the corresponding exciter voltage, E (S[E]). Typical Value = 0.117. Default: 0.0

ta

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

tb

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

tc

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

te

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

tf

Excitation control system stabilizer time constant (T). Typical Value = 0.675. Default: 0

uelin

UEL input (uelin). true = input is connected to the HV gate false = input connects to the error signal. Typical Value = true. Default: False

vrmax

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

vrmin

Minimum voltage regulator output (V). Typical Value = -4.9. 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 cimpy.cgmes_v2_4_15.Base.Profile

Inheritance Diagram:

Inheritance diagram of cimpy.cgmes_v2_4_15.ExcIEEEDC2A