CGMES_3_0_0
Loading...
Searching...
No Matches
CIMPP::ExcIEEEAC8B Class Reference

IEEE 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 (KPR), integral (KIR), and derivative (KDR) gains. The representation of the brushless exciter (TE, KE, SE, KC, KD) 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 KC and KD set to 0. For thyristor power stages fed from the generator terminals, the limits VRMAX and VRMIN should be a function of terminal voltage: VT x VRMAX and VT x VRMIN. Reference: IEEE 421.5-2005, 6.8. More...

#include <ExcIEEEAC8B.hpp>

Inheritance diagram for CIMPP::ExcIEEEAC8B:
Inheritance graph
[legend]
Collaboration diagram for CIMPP::ExcIEEEAC8B:
Collaboration graph
[legend]

Public Member Functions

const char * debugString () const override
const std::list< std::string > & getAttributeNames () const override
const std::string & getClassNamespaceUrl () const override
const std::string & getAttributeNamespaceUrl (const std::string &attrName) const override
const std::list< CGMESProfile > & getPossibleProfiles () const override
const CGMESProfile & getRecommendedProfile () const override
const std::list< CGMESProfile > & getPossibleAttributeProfiles (const std::string &attrName) const override
const std::list< CGMESProfile > & getPossibleProfilesIncludingAttributes () const override
void addPrimitiveGetFnsToMap (std::map< std::string, get_function > &get_map) const override
void addClassGetFnsToMap (std::map< std::string, class_get_function > &get_map) const override
void addEnumGetFnsToMap (std::map< std::string, get_function > &get_map) const override
bool isAssignableFrom (BaseClass *otherObject) const override
Public Member Functions inherited from CIMPP::ExcitationSystemDynamics
const char * debugString () const override
const std::list< std::string > & getAttributeNames () const override
const std::string & getClassNamespaceUrl () const override
const std::string & getAttributeNamespaceUrl (const std::string &attrName) const override
const std::list< CGMESProfile > & getPossibleProfiles () const override
const CGMESProfile & getRecommendedProfile () const override
const std::list< CGMESProfile > & getPossibleAttributeProfiles (const std::string &attrName) const override
const std::list< CGMESProfile > & getPossibleProfilesIncludingAttributes () const override
void addPrimitiveGetFnsToMap (std::map< std::string, get_function > &get_map) const override
void addClassGetFnsToMap (std::map< std::string, class_get_function > &get_map) const override
void addEnumGetFnsToMap (std::map< std::string, get_function > &get_map) const override
bool isAssignableFrom (BaseClass *otherObject) const override
Public Member Functions inherited from CIMPP::IdentifiedObject
const char * debugString () const override
const std::list< std::string > & getAttributeNames () const override
const std::string & getClassNamespaceUrl () const override
const std::string & getAttributeNamespaceUrl (const std::string &attrName) const override
const std::list< CGMESProfile > & getPossibleProfiles () const override
const CGMESProfile & getRecommendedProfile () const override
const std::list< CGMESProfile > & getPossibleAttributeProfiles (const std::string &attrName) const override
const std::list< CGMESProfile > & getPossibleProfilesIncludingAttributes () const override
void addPrimitiveGetFnsToMap (std::map< std::string, get_function > &get_map) const override
void addClassGetFnsToMap (std::map< std::string, class_get_function > &get_map) const override
void addEnumGetFnsToMap (std::map< std::string, get_function > &get_map) const override
bool isAssignableFrom (BaseClass *otherObject) const override
Public Member Functions inherited from BaseClass
void setRdfid (const std::string &id)
std::string getRdfid () const

Static Public Member Functions

static void addConstructToMap (std::unordered_map< std::string, BaseClass *(*)()> &factory_map)
static void addPrimitiveAssignFnsToMap (std::unordered_map< std::string, assign_function > &assign_map)
static void addClassAssignFnsToMap (std::unordered_map< std::string, class_assign_function > &assign_map)
static const BaseClassDefiner declare ()
Static Public Member Functions inherited from CIMPP::ExcitationSystemDynamics
static void addConstructToMap (std::unordered_map< std::string, BaseClass *(*)()> &factory_map)
static void addPrimitiveAssignFnsToMap (std::unordered_map< std::string, assign_function > &assign_map)
static void addClassAssignFnsToMap (std::unordered_map< std::string, class_assign_function > &assign_map)
static const BaseClassDefiner declare ()
Static Public Member Functions inherited from CIMPP::DynamicsFunctionBlock
static void addConstructToMap (std::unordered_map< std::string, BaseClass *(*)()> &factory_map)
static void addPrimitiveAssignFnsToMap (std::unordered_map< std::string, assign_function > &assign_map)
static void addClassAssignFnsToMap (std::unordered_map< std::string, class_assign_function > &assign_map)
static const BaseClassDefiner declare ()
Static Public Member Functions inherited from CIMPP::IdentifiedObject
static void addConstructToMap (std::unordered_map< std::string, BaseClass *(*)()> &factory_map)
static void addPrimitiveAssignFnsToMap (std::unordered_map< std::string, assign_function > &assign_map)
static void addClassAssignFnsToMap (std::unordered_map< std::string, class_assign_function > &assign_map)
static const BaseClassDefiner declare ()
Static Public Member Functions inherited from BaseClass
static void addConstructToMap (std::unordered_map< std::string, BaseClass *(*)()> &factory_map)
static void addPrimitiveAssignFnsToMap (std::unordered_map< std::string, assign_function > &assign_map)
static void addClassAssignFnsToMap (std::unordered_map< std::string, class_assign_function > &assign_map)
static const CIMPP::BaseClassDefiner declare ()

Public Attributes

CIMPP::PU ka
 Voltage regulator gain (KA) (> 0). Typical value = 1. Default: 0.0.
CIMPP::PU kc
 Rectifier loading factor proportional to commutating reactance (KC) (>= 0). Typical value = 0,55. Default: 0.0.
CIMPP::PU kd
 Demagnetizing factor, a function of exciter alternator reactances (KD) (>= 0). Typical value = 1,1. Default: 0.0.
CIMPP::PU kdr
 Voltage regulator derivative gain (KDR) (>= 0). Typical value = 10. Default: 0.0.
CIMPP::PU ke
 Exciter constant related to self-excited field (KE). Typical value = 1. Default: 0.0.
CIMPP::PU kir
 Voltage regulator integral gain (KIR) (>= 0). Typical value = 5. Default: 0.0.
CIMPP::PU kpr
 Voltage regulator proportional gain (KPR) (> 0 if ExcIEEEAC8B.kir = 0). Typical value = 80. Default: 0.0.
CIMPP::Float seve1
 Exciter saturation function value at the corresponding exciter voltage, VE1, back of commutating reactance (SE[VE1]) (>= 0). Typical value = 0,3. Default: 0.0.
CIMPP::Float seve2
 Exciter saturation function value at the corresponding exciter voltage, VE2, back of commutating reactance (SE[VE2]) (>= 0). Typical value = 3. Default: 0.0.
CIMPP::Seconds ta
 Voltage regulator time constant (TA) (>= 0). Typical value = 0. Default: 0.0.
CIMPP::Seconds tdr
 Lag time constant (TDR) (> 0). Typical value = 0,1. Default: 0.0.
CIMPP::Seconds te
 Exciter time constant, integration rate associated with exciter control (TE) (> 0). Typical value = 1,2. Default: 0.0.
CIMPP::PU ve1
 Exciter alternator output voltages back of commutating reactance at which saturation is defined (VE1) (> 0). Typical value = 6,5. Default: 0.0.
CIMPP::PU ve2
 Exciter alternator output voltages back of commutating reactance at which saturation is defined (VE2) (> 0). Typical value = 9. Default: 0.0.
CIMPP::PU vemin
 Minimum exciter voltage output (VEMIN) (<= 0). Typical value = 0. Default: 0.0.
CIMPP::PU vfemax
 Exciter field current limit reference (VFEMAX). Typical value = 6. Default: 0.0.
CIMPP::PU vrmax
 Maximum voltage regulator output (VRMAX) (> 0). Typical value = 35. Default: 0.0.
CIMPP::PU vrmin
 Minimum voltage regulator output (VRMIN) (<= 0). Typical value = 0. Default: 0.0.
Public Attributes inherited from CIMPP::ExcitationSystemDynamics
CIMPP::DiscontinuousExcitationControlDynamics * DiscontinuousExcitationControlDynamics
 Discontinuous excitation control model associated with this excitation system model. Default: nullptr.
CIMPP::OverexcitationLimiterDynamics * OverexcitationLimiterDynamics
 Overexcitation limiter model associated with this excitation system model. Default: nullptr.
CIMPP::PFVArControllerType1Dynamics * PFVArControllerType1Dynamics
 Power factor or VAr controller type 1 model associated with this excitation system model. Default: nullptr.
CIMPP::PFVArControllerType2Dynamics * PFVArControllerType2Dynamics
 Power factor or VAr controller type 2 model associated with this excitation system model. Default: nullptr.
CIMPP::PowerSystemStabilizerDynamics * PowerSystemStabilizerDynamics
 Power system stabilizer model associated with this excitation system model. Default: nullptr.
CIMPP::SynchronousMachineDynamics * SynchronousMachineDynamics
 Synchronous machine model with which this excitation system model is associated. Default: nullptr.
CIMPP::UnderexcitationLimiterDynamics * UnderexcitationLimiterDynamics
 Undrexcitation limiter model associated with this excitation system model. Default: nullptr.
CIMPP::VoltageCompensatorDynamics * VoltageCompensatorDynamics
 Voltage compensator model associated with this excitation system model. Default: nullptr.
Public Attributes inherited from CIMPP::DynamicsFunctionBlock
CIMPP::Boolean enabled
 Function block used indicator. true = use of function block is enabled false = use of function block is disabled. Default: false.
Public Attributes inherited from CIMPP::IdentifiedObject
std::list< CIMPP::DiagramObject * > DiagramObjects
 The diagram objects that are associated with the domain object. Default: {}.
CIMPP::String 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: "".
CIMPP::String 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. For details on EIC scheme please refer to ENTSO-E web site. Default: "".
CIMPP::String mRID
 Master resource identifier issued by a model authority. The mRID is 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, the mRID is mapped to rdf:ID or rdf:about attributes that identify CIM object elements. Default: "".
CIMPP::String name
 The name is any free human readable and possibly non unique text naming the object. Default: "".
CIMPP::String shortName
 The attribute is used for an exchange of a human readable short name with length of the string 12 characters maximum. Default: "".

Static Public Attributes

static const char debugName [] = "ExcIEEEAC8B"
Static Public Attributes inherited from CIMPP::ExcitationSystemDynamics
static const char debugName [] = "ExcitationSystemDynamics"
Static Public Attributes inherited from CIMPP::DynamicsFunctionBlock
static const char debugName [] = "DynamicsFunctionBlock"
Static Public Attributes inherited from CIMPP::IdentifiedObject
static const char debugName [] = "IdentifiedObject"
Static Public Attributes inherited from BaseClass
static const char debugName [] = "BaseClass"

Protected Member Functions

std::map< std::string, AttrDetails > allAttrDetailsMap () const override
Protected Member Functions inherited from CIMPP::ExcitationSystemDynamics
std::map< std::string, AttrDetails > allAttrDetailsMap () const override
Protected Member Functions inherited from CIMPP::IdentifiedObject
std::map< std::string, AttrDetails > allAttrDetailsMap () const override

Detailed Description

IEEE 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 (KPR), integral (KIR), and derivative (KDR) gains. The representation of the brushless exciter (TE, KE, SE, KC, KD) 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 KC and KD set to 0. For thyristor power stages fed from the generator terminals, the limits VRMAX and VRMIN should be a function of terminal voltage: VT x VRMAX and VT x VRMIN. Reference: IEEE 421.5-2005, 6.8.

Member Function Documentation

◆ addClassGetFnsToMap()

void ExcIEEEAC8B::addClassGetFnsToMap ( std::map< std::string, class_get_function > & get_map) const
overridevirtual

Reimplemented from CIMPP::DynamicsFunctionBlock.

◆ addEnumGetFnsToMap()

void ExcIEEEAC8B::addEnumGetFnsToMap ( std::map< std::string, get_function > & get_map) const
overridevirtual

Reimplemented from CIMPP::DynamicsFunctionBlock.

◆ addPrimitiveGetFnsToMap()

void ExcIEEEAC8B::addPrimitiveGetFnsToMap ( std::map< std::string, get_function > & get_map) const
overridevirtual

Reimplemented from CIMPP::DynamicsFunctionBlock.

◆ allAttrDetailsMap()

std::map< std::string, AttrDetails > ExcIEEEAC8B::allAttrDetailsMap ( ) const
overrideprotectedvirtual

Reimplemented from CIMPP::DynamicsFunctionBlock.

◆ debugString()

const char * ExcIEEEAC8B::debugString ( ) const
overridevirtual

Reimplemented from CIMPP::DynamicsFunctionBlock.

◆ getAttributeNames()

const std::list< std::string > & ExcIEEEAC8B::getAttributeNames ( ) const
overridevirtual

Reimplemented from CIMPP::DynamicsFunctionBlock.

◆ getAttributeNamespaceUrl()

const std::string & ExcIEEEAC8B::getAttributeNamespaceUrl ( const std::string & attrName) const
overridevirtual

Reimplemented from CIMPP::DynamicsFunctionBlock.

◆ getClassNamespaceUrl()

const std::string & ExcIEEEAC8B::getClassNamespaceUrl ( ) const
overridevirtual

Reimplemented from CIMPP::DynamicsFunctionBlock.

◆ getPossibleAttributeProfiles()

const std::list< CGMESProfile > & ExcIEEEAC8B::getPossibleAttributeProfiles ( const std::string & attrName) const
overridevirtual

Reimplemented from CIMPP::DynamicsFunctionBlock.

◆ getPossibleProfiles()

const std::list< CGMESProfile > & ExcIEEEAC8B::getPossibleProfiles ( ) const
overridevirtual

Reimplemented from CIMPP::DynamicsFunctionBlock.

◆ getPossibleProfilesIncludingAttributes()

const std::list< CGMESProfile > & ExcIEEEAC8B::getPossibleProfilesIncludingAttributes ( ) const
overridevirtual

Reimplemented from CIMPP::DynamicsFunctionBlock.

◆ getRecommendedProfile()

const CGMESProfile & ExcIEEEAC8B::getRecommendedProfile ( ) const
overridevirtual

Reimplemented from CIMPP::DynamicsFunctionBlock.

◆ isAssignableFrom()

bool ExcIEEEAC8B::isAssignableFrom ( BaseClass * otherObject) const
overridevirtual

Reimplemented from CIMPP::DynamicsFunctionBlock.

The documentation for this class was generated from the following files: