modelSynchronousMachine4Windings
Synchronous machine with four windings - external parameters
Extends from SynchronousMachine4WindingsInternalParameters (Synchronous machine with 4 windings - internal parameters).
Information
Same as SynchronousMachine4WindingsInternalParameters, but using external parameters such as transient and sub-transient time constants.
The parameter transformation is carried out according to the relationships described by P. Kundur, Power System Stability and Control, chapter 4.
Currently, only the case with zero Canay's coupling inductance is handled
Parameters
| Type | Name | Default | Description |
|---|---|---|---|
| Types.Voltage | UNom (from OnePortAC) | Nominal/rated line-to-line voltage | |
| Types.ApparentPower | SNom (from OnePortAC) | Nominal/rated apparent power | |
| Boolean | portVariablesPhases (from OnePortAC) | false | Compute voltage and current phases for monitoring purposes only |
| Boolean | portVariablesPu (from OnePortAC) | true | Add per-unit variables to model |
| Boolean | generatorConvention (from OnePortAC) | false | Add currents with generator convention (i > 0 when exiting the device) to model |
| LocalInitializationOption | localInit (from OnePortAC) | LocalInitializationOption.none | Initialize the component locally in steady state from port start values |
| SI.Angle | thetaStart (from OnePortACdqPU) | UPhaseStart | Start value of rotation between machine rotor frame and port phasor frame |
| Types.PerUnit | udPuStart (from OnePortACdqPU) | Start value of udPu | |
| Types.PerUnit | uqPuStart (from OnePortACdqPU) | Start value of uqPu | |
| Types.PerUnit | idPuStart (from OnePortACdqPU) | Start value of idPu | |
| Types.PerUnit | iqPuStart (from OnePortACdqPU) | Start value of iqPu | |
| Types.ActivePower | PNom (from SynchronousMachine4WindingsInternalParameters) | SNom | Nominal active (turbine) power |
| Types.PerUnit | raPu (from SynchronousMachine4WindingsInternalParameters) | Armature resistance in p.u. | |
| Types.PerUnit | LdPu (from SynchronousMachine4WindingsInternalParameters) | Direct axis stator leakage in p.u. | |
| Types.PerUnit | MdPu (from SynchronousMachine4WindingsInternalParameters) | Direct axis mutual inductance in p.u. | |
| Types.PerUnit | mrcPu (from SynchronousMachine4WindingsInternalParameters) | Canay's mutual inductance in p.u. | |
| Types.PerUnit | LDPu (from SynchronousMachine4WindingsInternalParameters) | Direct axis damper leakage in p.u. | |
| Types.PerUnit | rDPu (from SynchronousMachine4WindingsInternalParameters) | Resistance of the direct axis damper in p.u. | |
| Types.PerUnit | LfPu (from SynchronousMachine4WindingsInternalParameters) | Excitation winding leakage in p.u. | |
| Types.PerUnit | rfPu (from SynchronousMachine4WindingsInternalParameters) | Resistance of the excitation windings in p.u. | |
| Types.PerUnit | LqPu (from SynchronousMachine4WindingsInternalParameters) | Quadrature axis stator leakage in p.u. | |
| Types.PerUnit | MqPu (from SynchronousMachine4WindingsInternalParameters) | Quadrature axis mutual inductance in p.u. | |
| Types.PerUnit | LQ1Pu (from SynchronousMachine4WindingsInternalParameters) | Quadrature axis 1st damper leakage in p.u. | |
| Types.PerUnit | rQ1Pu (from SynchronousMachine4WindingsInternalParameters) | Quadrature axis 2nd damper leakage in p.u. | |
| Types.PerUnit | LQ2Pu (from SynchronousMachine4WindingsInternalParameters) | Leakage of quadrature axis 2nd damper in p.u. | |
| Types.PerUnit | rQ2Pu (from SynchronousMachine4WindingsInternalParameters) | Resistance of quadrature axis 2nd damper in p.u. | |
| Types.PerUnit | DPu (from SynchronousMachine4WindingsInternalParameters) | 0 | Damping coefficient of the swing equation in p.u. |
| Modelica.SIunits.Time | H (from SynchronousMachine4WindingsInternalParameters) | Kinetic constant = kinetic energy / rated power | |
| Types.Choices.ExcitationPuType | excitationPuType (from SynchronousMachine4WindingsInternalParameters) | PowerGrids.Types.Choices.ExcitationPuType.nominalStatorVoltageNoLoad | Choice of excitation base voltage |
| Boolean | neglectTransformerTerms (from SynchronousMachine4WindingsInternalParameters) | true | Neglect the transformer terms in the Park equations |
| Boolean | referenceGenerator (from SynchronousMachine4WindingsInternalParameters) | false | True if reference generator in an isolated synchronous system |
| Types.Choices.InitializationOption | initOpt (from SynchronousMachine4WindingsInternalParameters) | systemPowerGrids.initOpt | Initialization option |
| SI.AngularVelocity | omegaBase (from SynchronousMachine4WindingsInternalParameters) | systemPowerGrids.omegaNom | Base angular frequency value |
| Types.PerUnit | kuf (from SynchronousMachine4WindingsInternalParameters) | Scaling factor for excitation p.u. voltage | |
| Types.PerUnit | omegaNomPu (from SynchronousMachine4WindingsInternalParameters) | 1 | Nominal frequency in p.u. |
| Types.PerUnit | lambdadPuStart (from SynchronousMachine4WindingsInternalParameters) | Start value of lambdadPu | |
| Types.PerUnit | lambdaqPuStart (from SynchronousMachine4WindingsInternalParameters) | Start value of lambdaqPu | |
| Types.PerUnit | ufPuStart (from SynchronousMachine4WindingsInternalParameters) | Start value of exciter voltage in p.u. (Kundur base) | |
| Types.PerUnit | ufPuInStart (from SynchronousMachine4WindingsInternalParameters) | Start value of input exciter voltage in p.u. (user-selcted base | |
| Types.PerUnit | ifPuStart (from SynchronousMachine4WindingsInternalParameters) | Start value of ifPu | |
| Types.PerUnit | xlPu | Stator leakage in p.u. | |
| Types.PerUnit | xdPu | Direct axis reactance in p.u. | |
| Types.PerUnit | xpdPu | Direct axis transient reactance in p.u. | |
| Types.PerUnit | xppdPu | Direct axis sub-transient reactance p.u. | |
| Types.Time | Tpd0 | Direct axis, open circuit transient time constant | |
| Types.Time | Tppd0 | Direct axis, open circuit sub-transient time constant | |
| Types.PerUnit | xqPu | Quadrature axis reactance in p.u. | |
| Types.PerUnit | xpqPu | Quadrature axis transient reactance in p.u. | |
| Types.PerUnit | xppqPu | Quadrature axis sub-transient reactance in p.u. | |
| Types.Time | Tpq0 | Open circuit quadrature axis transient time constant | |
| Types.Time | Tppq0 | Open circuit quadrature axis sub-transient time constant | |
| Types.Choices.TimeConstantsApproximation | timeConstApprox | PowerGrids.Types.Choices.TimeConstantsApproximation.classicalDefinition | Approximation of time constants for internal parameter computation |
| Types.PerUnit | T1dPu | ||
| Types.PerUnit | T2dPu | ||
| Types.PerUnit | T3dPu | ||
| Types.PerUnit | T4dPu | ||
| Types.PerUnit | T5dPu | ||
| Types.PerUnit | T6dPu | ||
| Types.PerUnit | T1qPu | ||
| Types.PerUnit | T2qPu | ||
| Types.PerUnit | T3qPu | ||
| Types.PerUnit | T4qPu | ||
| Types.PerUnit | T5qPu | ||
| Types.PerUnit | T6qPu | ||
| Types.Time | Tpd | ||
| Types.Time | Tppd | ||
| Types.Time | Tpq | ||
| Types.Time | Tppq | ||
| Types.PerUnit | cosPhiStart | abs(PStart)/sqrt(PStart^2 + QStart^2 + 1e-9*SNom) | Start value of power factor cos(phi) |
| Types.PerUnit | sinPhiStart | sqrt(1 - cosPhiStart^2) | Start value of sin(phi) |
| Types.PerUnit | VStartPu | port.VStart/port.VBase | Start value of voltage modulus in p.u. |
| Types.PerUnit | IStartPu | port.IStart/port.IBase | Start value of current modulus in p.u. |
| Initialization | |||
| Types.Voltage | UStart (from OnePortAC) | UNom | Start value of phase-to-phase voltage phasor, absolute value |
| Types.Angle | UPhaseStart (from OnePortAC) | 0 | Start value of phase-to-phase voltage phasor, phase angle |
| Types.ActivePower | PStart (from OnePortAC) | SNom | Start value of active power flowing into the port |
| Types.ReactivePower | QStart (from OnePortAC) | 0 | Start value of reactive power flowing into the port |
Connectors
| Type | Name | Default | Description |
|---|---|---|---|
| PowerGrids.Interfaces.TerminalAC | terminal (from OnePortAC) | ||
| Modelica.Blocks.Interfaces.RealInput | PmPu (from SynchronousMachine4WindingsInternalParameters) | Input mechanical power in p.u. (base PNom) | |
| Modelica.Blocks.Interfaces.RealInput | ufPuIn (from SynchronousMachine4WindingsInternalParameters) | Input voltage of exciter winding in p.u. (user-selected base voltage) | |
| Modelica.Blocks.Interfaces.RealOutput | omega (from SynchronousMachine4WindingsInternalParameters) | Angular frequency in rad/s for system object | |
| Modelica.Blocks.Interfaces.RealOutput | omegaPu (from SynchronousMachine4WindingsInternalParameters) | Angular frequency in p.u. | |
| Modelica.Blocks.Interfaces.RealOutput | VPu (from SynchronousMachine4WindingsInternalParameters) | Port voltage magnitude [pu] | |
| Modelica.Blocks.Interfaces.RealOutput | PPu (from SynchronousMachine4WindingsInternalParameters) | Active Power Production [pu base PNom] |
Components
| Type | Name | Default | Description |
|---|---|---|---|
| PortAC | port (from OnePortAC) | AC port of node | |
| Electrical.System | systemPowerGrids (from OnePortAC) | Reference to system object | |
| Types.PerUnit | udPu (from OnePortACdqPU) | Voltage of direct axis in p.u. | |
| Types.PerUnit | uqPu (from OnePortACdqPU) | Voltage of quadrature axis in p.u. | |
| Types.PerUnit | idPu (from OnePortACdqPU) | Current of direct axis in p.u. | |
| Types.PerUnit | iqPu (from OnePortACdqPU) | Current of quadrature axis in p.u. | |
| Types.Angle | theta (from OnePortACdqPU) | Rotation between machine rotor frame and port phasor frame | |
| Types.PerUnit | iDPu (from SynchronousMachine4WindingsInternalParameters) | Current of direct axis damper in p.u | |
| Types.PerUnit | ifPu (from SynchronousMachine4WindingsInternalParameters) | Current of excitation winding in p.u. | |
| Types.PerUnit | iQ1Pu (from SynchronousMachine4WindingsInternalParameters) | Current of quadrature axis 1st damper in p.u. | |
| Types.PerUnit | iQ2Pu (from SynchronousMachine4WindingsInternalParameters) | Current of quadrature axis 2nd damper in p.u. | |
| Types.PerUnit | ufPu (from SynchronousMachine4WindingsInternalParameters) | Voltage of exciter winding in p.u. (base voltage as per Kundur) | |
| Types.PerUnit | lambdadPu (from SynchronousMachine4WindingsInternalParameters) | Flux of direct axis in p.u. | |
| Types.PerUnit | lambdaqPu (from SynchronousMachine4WindingsInternalParameters) | Flux of quadrature axis in p.u. | |
| Types.PerUnit | lambdaDPu (from SynchronousMachine4WindingsInternalParameters) | Flux of direct axis damper in p.u | |
| Types.PerUnit | lambdafPu (from SynchronousMachine4WindingsInternalParameters) | Flux of excitation winding in p.u. | |
| Types.PerUnit | lambdaQ1Pu (from SynchronousMachine4WindingsInternalParameters) | Flux of quadrature axis 1st damper in p.u. | |
| Types.PerUnit | lambdaQ2Pu (from SynchronousMachine4WindingsInternalParameters) | Flux of quadrature axis 1st damper in p.u. | |
| Types.PerUnit | omegaRefPu (from SynchronousMachine4WindingsInternalParameters) | systemPowerGrids.omegaRef/systemPowerGrids.omegaNom | Reference frequency in p.u. |
| Types.PerUnit | CmPu (from SynchronousMachine4WindingsInternalParameters) | Mechanical torque in p.u. (base PNom/omegaBase) | |
| Types.PerUnit | CePu (from SynchronousMachine4WindingsInternalParameters) | Electrical torque in p.u. (base SNom/omegaBase) | |
| Types.PerUnit | PePu (from SynchronousMachine4WindingsInternalParameters) | Electrical power in p.u. (base SNom) | |
| Types.PerUnit | PePuPNom (from SynchronousMachine4WindingsInternalParameters) | PePu*SNom/PNom | Electrical active power in p.u. (base PNom) |
| Types.Frequency | f (from SynchronousMachine4WindingsInternalParameters) | systemPowerGrids.fNom*omegaPu | Frequency of rotation of d-q axes |