modelGENCLS
Classic generator model that can also represent an infinite bus
Extends from Icons.VerifiedModel (Icon for classes that were verified), OpenIPSL.Electrical.Essentials.pfComponent (Partial model containing all the parameters for entering power flow data).
Information
Synchronous machine represented by 'classical' modeling (see also [PSSE-AGV2], chapter 15).
Parametrization
This model changes its behavior depending on the value of the parameter H:
H=0: The model behaves like an infinite bus where the voltage and frequency, specified byv_0andfn, are kept constant.PandQare then calculated accordingly (i.e., the initial valuesP_0andQ_0have no influence on the behavior of the model).H>0: "Classical Generator" model with physically-meaningful parameters, e.g.,H=5in a 100 MVA base. The parametersP_0andQ_0are used to specify the fixed active and reactive power injected or absorbed by the model. The parametersv_0andfncan be used to specify the initial voltage and frequency.H>>0: By makingHvery large, e.g.,H=1e6in a 100 MVA base, the speed of the machine will not undergo any changes, and consequently will set the frequencyfat the bus to a fixed value (i.e.,fn). The parametersP_0,Q_0,v_0andfnhave the same function as in case 2.
Applications
H=0: Infinite busH>0: Can be used to model a generation facility when only limited information is available, this is the simplest model possible to represent a synchronous machine's electro-mechanical dynamics.H>>0: Can be used to model the connection to a "stiff grid".
See also [PSSE-AGV2], chapter 15.
Parameters
| Type | Name | Default | Description |
|---|---|---|---|
| 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 |
| Machine parameters | |||
| Types.ApparentPower | M_b | 100e6 | Machine base power rating |
| Types.Time | H | 0 | Inertia constant |
| Real | D | 0 | Damping coefficient |
| Types.PerUnit | R_a | 0 | Armature resistance |
| Types.PerUnit | X_d | 0.2 | d-axis transient reactance |
Connectors
| Type | Name | Default | Description |
|---|---|---|---|
| OpenIPSL.Interfaces.PwPin | p |
Components
| Type | Name | Default | Description |
|---|---|---|---|
| OpenIPSL.Electrical.SystemBase | SysData (from pfComponent) | Must add this line in all models | |
| Types.Angle | delta | Rotor angle | |
| Types.PerUnit | omega | Rotor speed | |
| Types.PerUnit | V | Bus voltage magnitude | |
| Types.Angle | anglev | Bus voltage angle | |
| Types.PerUnit | eq | Constant emf behind transient reactance | |
| Types.PerUnit | vd | d-axis voltage | |
| Types.PerUnit | vq | q-axis voltage | |
| Types.PerUnit | id | d-axis current | |
| Types.PerUnit | iq | q-axis current | |
| Types.PerUnit | P | Active power (system base) | |
| Types.PerUnit | Q | Reactive power (system base) |
Revisions
Model Name |
GENCLS |
Reference |
PSS/E Manual |
Last update |
September 2020 |
Author |
Mengjia Zhang, SmarTS Lab, KTH Royal Institute of Technology |
Contact |
|
Model Verification |
This model has been verified against PSS/E. |
Description |
Synchronous machine represented by 'classical' modeling or Thevenin Voltage Source to play Back known voltage/frequency signal. |