cimpy.cgmes_v2_4_15.ExcDC3A module

class cimpy.cgmes_v2_4_15.ExcDC3A.ExcDC3A(trh=0, ks=0.0, kr=0.0, kv=0.0, vrmax=0.0, vrmin=0.0, te=0, ke=0.0, efd1=0.0, seefd1=0.0, efd2=0.0, seefd2=0.0, exclim=False, edfmax=0.0, efdmin=0.0, efdlim=False, *args, **kw_args)[source]

This is modified IEEE DC3A direct current commutator exciters with speed input, and death band. DC old type 4.

trh

Rheostat travel time (Trh). Typical Value = 20. Default: 0

ks

Coefficient to allow different usage of the model-speed coefficient (Ks). Typical Value = 0. Default: 0.0

kr

Death band (Kr). If Kr is not zero, the voltage regulator input changes at a constant rate if Verr > Kr or Verr < -Kr as per the IEEE (1968) Type 4 model. If Kr is zero, the error signal drives the voltage regulator continuously as per the IEEE (1980) DC3 and IEEE (1992, 2005) DC3A models. Typical Value = 0. Default: 0.0

kv

Fast raise/lower contact setting (Kv). Typical Value = 0.05. Default: 0.0

vrmax

Maximum voltage regulator output (Vrmax). Typical Value = 5. Default: 0.0

vrmin

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

te

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

ke

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

efd1

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

seefd1

Exciter saturation function value at the corresponding exciter voltage, Efd1 (Se[Eefd1]). Typical Value = 0.1. Default: 0.0

efd2

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

seefd2

Exciter saturation function value at the corresponding exciter voltage, Efd2 (Se[Efd2]). Typical Value = 0.35. Default: 0.0

exclim

(exclim). IEEE standard is ambiguous about lower limit on exciter output. true = a lower limit of zero is applied to integrator output false = a lower limit of zero not applied to integrator output. Typical Value = true. Default: False

edfmax

Maximum voltage exciter output limiter (Efdmax). Typical Value = 99. Default: 0.0

efdmin

Minimum voltage exciter output limiter (Efdmin). Typical Value = -99. Default: 0.0

efdlim

(Efdlim). true = exciter output limiter is active false = exciter output limiter not active. Typical Value = true. Default: False

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.ExcDC3A