modelVSourceIO
Generic voltage source behind an internal impedance with inputs that vary the internal source magnitude and angle from steady state
Extends from BaseClasses.baseVoltageSource (Base model for voltage sources behind an impedance).
Information
The purpose of this model is to support the development of Grid-Forming Inverter models as described in [Du2021]. The model provides a voltage source with an internal voltage source and internal impedance whose magnitude and angle can be varied via inputs starting from their initial values.
See the documentation of BaseClasses.baseVoltageSource for more information.
Parameters
| Type | Name | Default | Description |
|---|---|---|---|
| Boolean | useEphasorInternalAsInput | true | If true, the values of E0 and delta0 are computed internally and used as the start value of the input, requiring only a deviation \Delta E and \Delta delta to be supplied. If false, the magnitude E and angle delta must be supplied, including the correct value of E0 and delta0 needed for proper initialization. |
| Power flow data | |||
| Types.ApparentPower | S_b (from pfComponent) | SysData.S_b | System base power |
| Types.Voltage | V_b (from pfComponent) | 400e3 | Base voltage of the bus |
| Types.Frequency | fn (from pfComponent) | SysData.fn | System frequency |
| Types.ActivePower | P_0 (from pfComponent) | 1e6 | Initial active power |
| Types.ReactivePower | Q_0 (from pfComponent) | 0 | Initial reactive power |
| Types.PerUnit | v_0 (from pfComponent) | 1 | Initial voltage magnitude |
| Types.Angle | angle_0 (from pfComponent) | 0 | Initial voltage angle |
| Boolean | displayPF (from pfComponent) | false | Display power flow: |
| Parameter mask | |||
| Boolean | enableS_b (from pfComponent) | false | Enable S_b in parameter list |
| Boolean | enableV_b (from pfComponent) | false | Enable V_b in parameter list |
| Boolean | enablefn (from pfComponent) | false | Enable fn in parameter list |
| Boolean | enableP_0 (from pfComponent) | false | Enable P_0 in parameter list |
| Boolean | enableQ_0 (from pfComponent) | false | Enable Q_0 in parameter list |
| Boolean | enablev_0 (from pfComponent) | false | Enable v_0 in parameter list |
| Boolean | enableangle_0 (from pfComponent) | false | Enable angle_0 in parameter list |
| Boolean | enabledisplayPF (from pfComponent) | false | Enable displayPF in parameter list |
| Voltage Source parameters | |||
| OpenIPSL.Types.ApparentPower | M_b (from baseVoltageSource) | SysData.S_b | Voltage Source base power rating (MVA) |
| OpenIPSL.Types.PerUnit | R_a (from baseVoltageSource) | 1e-3 | Internal source resistance, pu, system base |
| OpenIPSL.Types.PerUnit | X_d (from baseVoltageSource) | 0.2 | Internal source d-axis reactance, pu, system base |
Connectors
| Type | Name | Default | Description |
|---|---|---|---|
| OpenIPSL.Interfaces.PwPin_p | p (from baseVoltageSource) | Instantiation of graphical component PwPin_p | |
| RealOutput | Emag (from baseVoltageSource) | Internal voltage magnitude | |
| RealOutput | Edelta (from baseVoltageSource) | Internal voltage angle | |
| RealOutput | Emag0 (from baseVoltageSource) | Initial value of the internal voltage source magnitude | |
| RealOutput | Eang0 (from baseVoltageSource) | Initial value of the internal voltage angle | |
| Modelica.Blocks.Interfaces.RealInput | uDEmag | Input to vary the voltage magnitude of the voltage source | |
| Modelica.Blocks.Interfaces.RealInput | uDEang | Input to vary the angle of the voltage source |
Components
| Type | Name | Default | Description |
|---|---|---|---|
| OpenIPSL.Electrical.SystemBase | SysData (from baseVoltageSource) | ||
| OpenIPSL.Types.PerUnit | V (from baseVoltageSource) | Bus voltage magnitude | |
| OpenIPSL.Types.Angle | anglev (from baseVoltageSource) | Bus voltage angle | |
| OpenIPSL.Types.PerUnit | P (from baseVoltageSource) | Active power (system base) | |
| OpenIPSL.Types.PerUnit | Q (from baseVoltageSource) | Reactive power (system base) | |
| OpenIPSL.Types.Angle | delta (from baseVoltageSource) | Internal voltage source angle | |
| OpenIPSL.Types.PerUnit | E (from baseVoltageSource) | Internal voltage source magnitude | |
| Modelica.Blocks.Math.PolarToRectangular | p2R | Convert from magnitude and angle to real and imaginary |