|
CGMES_3_0_0
|
|
|
CGMES_3_0_0
|
DC side of the current source converter (CSC). The firing angle controls the dc voltage at the converter, both for rectifier and inverter. The difference between the dc voltages of the rectifier and inverter determines the dc current. The extinction angle is used to limit the dc voltage at the inverter, if needed, and is not used in active power control. The firing angle, transformer tap position and number of connected filters are the primary means to control a current source dc line. Higher level controls are built on top, e.g. dc voltage, dc current and active power. From a steady state perspective it is sufficient to specify the wanted active power transfer (ACDCConverter.targetPpcc) and the control functions will set the dc voltage, dc current, firing angle, transformer tap position and number of connected filters to meet this. Therefore attributes targetAlpha and targetGamma are not applicable in this case. The reactive power consumed by the converter is a function of the firing angle, transformer tap position and number of connected filter, which can be approximated with half of the active power. The losses is a function of the dc voltage and dc current. The attributes minAlpha and maxAlpha define the range of firing angles for rectifier operation between which no discrete tap changer action takes place. The range is typically 10-18 degrees. The attributes minGamma and maxGamma define the range of extinction angles for inverter operation between which no discrete tap changer action takes place. The range is typically 17-20 degrees. More...
#include <CsConverter.hpp>
Public Attributes | |
| CIMPP::CSCDynamics * | CSCDynamics |
| Current source converter dynamics model used to describe dynamic behaviour of this converter. Default: nullptr. | |
| CIMPP::CsPpccControlKind | pPccControl |
| Firing angle that determines the dc voltage at the converter dc terminal. Typical value between 10 degrees and 18 degrees for a rectifier. It is converter`s state variable, result from power flow. The attribute shall be a positive value. Default: 0.0 */ CIMPP::AngleDegrees alpha;. | |
| Public Attributes inherited from CIMPP::ACDCConverter | |
| std::list< CIMPP::ACDCConverterDCTerminal * > | DCTerminals |
| A DC converter have DC converter terminals. A converter has two DC converter terminals. Default: {}. | |
| CIMPP::Terminal * | PccTerminal |
| Point of common coupling terminal for this converter DC side. It is typically the terminal on the power transformer (or switch) closest to the AC network. Default: nullptr. | |
| CIMPP::ApparentPower | baseS |
| Base apparent power of the converter pole. The attribute shall be a positive value. Default: 0.0. | |
| CIMPP::ActivePower | maxP |
| Converter DC current, also called Id. It is converter`s state variable, result from power flow. Default: 0.0 */ CIMPP::CurrentFlow idc;. | |
| CIMPP::ActivePower | minP |
| The maximum voltage on the DC side at which the converter should operate. It is converter`s configuration data used in power flow. The attribute shall be a positive value. Default: 0.0 */ CIMPP::Voltage maxUdc;. | |
| CIMPP::Integer | numberOfValves |
| The minimum voltage on the DC side at which the converter should operate. It is converter`s configuration data used in power flow. The attribute shall be a positive value. Default: 0.0 */ CIMPP::Voltage minUdc;. | |
| CIMPP::ActivePower | p |
| Active power at the point of common coupling. Load sign convention is used, i.e. positive sign means flow out from a node. Starting value for a steady state solution in the case a simplified power flow model is used. Default: 0.0. | |
| CIMPP::ReactivePower | q |
| The active power loss at a DC Pole = idleLoss + switchingLoss*|Idc| + resitiveLoss*Idc^2. For lossless operation Pdc=Pac. For rectifier operation with losses Pdc=Pac-lossP. For inverter operation with losses Pdc=Pac+lossP. It is converter`s state variable used in power flow. The attribute shall be a positive value. Default: 0.0 */ CIMPP::ActivePower poleLossP;. | |
| CIMPP::ActivePowerPerCurrentFlow | switchingLoss |
| Rated converter DC voltage, also called UdN. The attribute shall be a positive value. It is converter`s configuration data used in power flow. For instance a bipolar HVDC link with value 200 kV has a 400kV difference between the dc lines. Default: 0.0 */ CIMPP::Voltage ratedUdc;. | |
| CIMPP::ActivePower | targetPpcc |
| Real power injection target in AC grid, at point of common coupling. Load sign convention is used, i.e. positive sign means flow out from a node. Default: 0.0. | |
| CIMPP::Voltage | targetUdc |
| Target value for DC voltage magnitude. The attribute shall be a positive value. Default: 0.0. | |
| CIMPP::Voltage | valveU0 |
| Line-to-line converter voltage, the voltage at the AC side of the valve. It is converter`s state variable, result from power flow. The attribute shall be a positive value. Default: 0.0 */ CIMPP::Voltage uc;. | |
| Public Attributes inherited from CIMPP::ConductingEquipment | |
| CIMPP::BaseVoltage * | BaseVoltage |
| Base voltage of this conducting equipment. Use only when there is no voltage level container used and only one base voltage applies. For example, not used for transformers. Default: nullptr. | |
| CIMPP::SvStatus * | SvStatus |
| The status state variable associated with this conducting equipment. Default: nullptr. | |
| std::list< CIMPP::Terminal * > | Terminals |
| Conducting equipment have terminals that may be connected to other conducting equipment terminals via connectivity nodes or topological nodes. Default: {}. | |
| Public Attributes inherited from CIMPP::Equipment | |
| CIMPP::EquipmentContainer * | EquipmentContainer |
| Container of this equipment. Default: nullptr. | |
| std::list< CIMPP::OperationalLimitSet * > | OperationalLimitSet |
| The operational limit sets associated with this equipment. Default: {}. | |
| CIMPP::Boolean | aggregate |
| The aggregate flag provides an alternative way of representing an aggregated (equivalent) element. It is applicable in cases when the dedicated classes for equivalent equipment do not have all of the attributes necessary to represent the required level of detail. In case the flag is set to true the single instance of equipment represents multiple pieces of equipment that have been modelled together as an aggregate equivalent obtained by a network reduction procedure. Examples would be power transformers or synchronous machines operating in parallel modelled as a single aggregate power transformer or aggregate synchronous machine. The attribute is not used for EquivalentBranch, EquivalentShunt and EquivalentInjection. Default: false. | |
| CIMPP::Boolean | inService |
| Specifies the availability of the equipment. True means the equipment is available for topology processing, which determines if the equipment is energized or not. False means that the equipment is treated by network applications as if it is not in the model. Default: false. | |
| CIMPP::Boolean | normallyInService |
| Specifies the availability of the equipment under normal operating conditions. True means the equipment is available for topology processing, which determines if the equipment is energized or not. False means that the equipment is treated by network applications as if it is not in the model. Default: false. | |
| Public Attributes inherited from CIMPP::PowerSystemResource | |
| std::list< CIMPP::Control * > | Controls |
| The controller outputs used to actually govern a regulating device, e.g. the magnetization of a synchronous machine or capacitor bank breaker actuator. Default: {}. | |
| CIMPP::Location * | Location |
| Location of this power system resource. Default: nullptr. | |
| std::list< CIMPP::Measurement * > | Measurements |
| The measurements associated with this power system resource. Default: {}. | |
| 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: "". | |
Additional Inherited Members | |
| Public Member Functions inherited from CIMPP::ACDCConverter | |
| 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::ConductingEquipment | |
| 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::Equipment | |
| 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::PowerSystemResource | |
| 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 inherited from CIMPP::ACDCConverter | |
| 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::ConductingEquipment | |
| 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::Equipment | |
| 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::PowerSystemResource | |
| 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 () |
| Static Public Attributes inherited from CIMPP::ACDCConverter | |
| static const char | debugName [] = "ACDCConverter" |
| Static Public Attributes inherited from CIMPP::ConductingEquipment | |
| static const char | debugName [] = "ConductingEquipment" |
| Static Public Attributes inherited from CIMPP::Equipment | |
| static const char | debugName [] = "Equipment" |
| Static Public Attributes inherited from CIMPP::PowerSystemResource | |
| static const char | debugName [] = "PowerSystemResource" |
| 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 inherited from CIMPP::ACDCConverter | |
| std::map< std::string, AttrDetails > | allAttrDetailsMap () const override |
| Protected Member Functions inherited from CIMPP::ConductingEquipment | |
| std::map< std::string, AttrDetails > | allAttrDetailsMap () const override |
| Protected Member Functions inherited from CIMPP::Equipment | |
| std::map< std::string, AttrDetails > | allAttrDetailsMap () const override |
| Protected Member Functions inherited from CIMPP::PowerSystemResource | |
| std::map< std::string, AttrDetails > | allAttrDetailsMap () const override |
DC side of the current source converter (CSC). The firing angle controls the dc voltage at the converter, both for rectifier and inverter. The difference between the dc voltages of the rectifier and inverter determines the dc current. The extinction angle is used to limit the dc voltage at the inverter, if needed, and is not used in active power control. The firing angle, transformer tap position and number of connected filters are the primary means to control a current source dc line. Higher level controls are built on top, e.g. dc voltage, dc current and active power. From a steady state perspective it is sufficient to specify the wanted active power transfer (ACDCConverter.targetPpcc) and the control functions will set the dc voltage, dc current, firing angle, transformer tap position and number of connected filters to meet this. Therefore attributes targetAlpha and targetGamma are not applicable in this case. The reactive power consumed by the converter is a function of the firing angle, transformer tap position and number of connected filter, which can be approximated with half of the active power. The losses is a function of the dc voltage and dc current. The attributes minAlpha and maxAlpha define the range of firing angles for rectifier operation between which no discrete tap changer action takes place. The range is typically 10-18 degrees. The attributes minGamma and maxGamma define the range of extinction angles for inverter operation between which no discrete tap changer action takes place. The range is typically 17-20 degrees.
| CIMPP::CsPpccControlKind CIMPP::CsConverter::pPccControl |
Firing angle that determines the dc voltage at the converter dc terminal. Typical value between 10 degrees and 18 degrees for a rectifier. It is converter`s state variable, result from power flow. The attribute shall be a positive value. Default: 0.0 */ CIMPP::AngleDegrees alpha;.
/** Extinction angle. It is used to limit the dc voltage at the inverter if needed. Typical value between 17 degrees and 20 degrees for an inverter. It is converter`s state variable, result from power flow. The attribute shall be a positive value. Default: 0.0 */ CIMPP::AngleDegrees gamma;
/** Maximum firing angle. It is converter`s configuration data used in power flow. The attribute shall be a positive value. Default: 0.0 */ CIMPP::AngleDegrees maxAlpha;
/** Maximum extinction angle. It is converter`s configuration data used in power flow. The attribute shall be a positive value. Default: 0.0 */ CIMPP::AngleDegrees maxGamma;
/** The maximum direct current (Id) on the DC side at which the converter should operate. It is converter`s configuration data use in power flow. The attribute shall be a positive value. Default: 0.0 */ CIMPP::CurrentFlow maxIdc;
/** Minimum firing angle. It is converter`s configuration data used in power flow. The attribute shall be a positive value. Default: 0.0 */ CIMPP::AngleDegrees minAlpha;
/** Minimum extinction angle. It is converter`s configuration data used in power flow. The attribute shall be a positive value. Default: 0.0 */ CIMPP::AngleDegrees minGamma;
/** The minimum direct current (Id) on the DC side at which the converter should operate. It is converter`s configuration data used in power flow. The attribute shall be a positive value. Default: 0.0 */ CIMPP::CurrentFlow minIdc;
/** Indicates whether the DC pole is operating as an inverter or as a rectifier. It is converter`s control variable used in power flow. Default: 0 */ CIMPP::CsOperatingModeKind operatingMode;
/** Kind of active power control. Default: 0
1.15.0