cimpy.cgmes_v2_4_15.VsConverter module¶
-
class
cimpy.cgmes_v2_4_15.VsConverter.
VsConverter
(CapabilityCurve=None, maxModulationIndex=0.0, maxValveCurrent=0.0, droop=0.0, droopCompensation=0.0, pPccControl=None, qPccControl=None, qShare=0.0, targetQpcc=0.0, targetUpcc=0.0, delta=0.0, uf=0.0, *args, **kw_args)[source]¶ DC side of the voltage source converter (VSC).
- CapabilityCurve
All converters with this capability curve. Default: None
- maxModulationIndex
The max quotient between the AC converter voltage (Uc) and DC voltage (Ud). A factor typically less than 1. VSC configuration data used in power flow. Default: 0.0
- maxValveCurrent
The maximum current through a valve. This current limit is the basis for calculating the capability diagram. VSC configuration data. Default: 0.0
- droop
Droop constant; pu value is obtained as D [kV^2 / MW] x Sb / Ubdc^2. Default: 0.0
- droopCompensation
Compensation (resistance) constant. Used to compensate for voltage drop when controlling voltage at a distant bus. Default: 0.0
- pPccControl
Kind of control of real power and/or DC voltage. Default: None
- qPccControl
Default: None
- qShare
Reactive power sharing factor among parallel converters on Uac control. Default: 0.0
- targetQpcc
Reactive power injection target in AC grid, at point of common coupling. Default: 0.0
- targetUpcc
Voltage target in AC grid, at point of common coupling. Default: 0.0
- delta
Angle between uf and uc. Converter state variable used in power flow. Default: 0.0
- uf
Filter bus voltage. Converter state variable, result from power flow. Default: 0.0
Documentation of parent class ACDCConverter:
A unit with valves for three phases, together with unit control equipment, essential protective and switching devices, DC storage capacitors, phase reactors and auxiliaries, if any, used for conversion.
- baseS
Base apparent power of the converter pole. Default: 0.0
- idleLoss
Active power loss in pole at no power transfer. Converter configuration data used in power flow. Default: 0.0
- maxUdc
The maximum voltage on the DC side at which the converter should operate. Converter configuration data used in power flow. Default: 0.0
- minUdc
Min allowed converter DC voltage. Converter configuration data used in power flow. Default: 0.0
- numberOfValves
Number of valves in the converter. Used in loss calculations. Default: 0
- ratedUdc
Rated converter DC voltage, also called UdN. Converter configuration data used in power flow. Default: 0.0
- resistiveLoss
Converter configuration data used in power flow. Refer to poleLossP. Default: 0.0
- switchingLoss
Switching losses, relative to the base apparent power baseS. Refer to poleLossP. Default: 0.0
- valveU0
Valve threshold voltage. Forward voltage drop when the valve is conducting. Used in loss calculations, i.e. the switchLoss depend on numberOfValves * valveU0. Default: 0.0
- DCTerminals
Default: “list”
- PccTerminal
All converters` DC sides linked to this point of common coupling terminal. Default: None
- 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
- q
Reactive 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
- targetPpcc
Real power injection target in AC grid, at point of common coupling. Default: 0.0
- targetUdc
Target value for DC voltage magnitude. Default: 0.0
- idc
Converter DC current, also called Id. Converter state variable, result from power flow. Default: 0.0
- poleLossP
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 Converter state variable used in power flow. Default: 0.0
- uc
Converter voltage, the voltage at the AC side of the bridge. Converter state variable, result from power flow. Default: 0.0
- udc
Converter voltage at the DC side, also called Ud. Converter state variable, result from power flow. Default: 0.0
Documentation of parent class ConductingEquipment:
The parts of the AC power system that are designed to carry current or that are conductively connected through terminals.
- BaseVoltage
All conducting equipment with this base voltage. Use only when there is no voltage level container used and only one base voltage applies. For example, not used for transformers. Default: None
- Terminals
Conducting equipment have terminals that may be connected to other conducting equipment terminals via connectivity nodes or topological nodes. Default: “list”
- SvStatus
The status state variable associated with this conducting equipment. Default: None
Documentation of parent class Equipment:
The parts of a power system that are physical devices, electronic or mechanical.
- aggregate
The single instance of equipment represents multiple pieces of equipment that have been modeled together as an aggregate. Examples would be power transformers or synchronous machines operating in parallel modeled as a single aggregate power transformer or aggregate synchronous machine. This is not to be used to indicate equipment that is part of a group of interdependent equipment produced by a network production program. Default: False
- EquipmentContainer
Container of this equipment. Default: None
- OperationalLimitSet
The operational limit sets associated with this equipment. Default: “list”
Documentation of parent class PowerSystemResource:
A power system resource can be an item of equipment such as a switch, an equipment container containing many individual items of equipment such as a substation, or an organisational entity such as sub-control area. Power system resources can have measurements associated.
- Controls
Regulating device governed by this control output. Default: “list”
- Measurements
The power system resource that contains the measurement. Default: “list”
- Location
Location of this power system resource. Default: None
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