Documentation Home Page ◇ ePHASORSIM Home Page
Pour la documentation en FRANÇAIS, utilisez l'outil de traduction de votre navigateur Chrome, Edge ou Safari. Voir un exemple.
Synchronous Machine
- Sylvain Ménard
- Luc Marcil
- Amira Aouina
On this page:
ePHASORSIM native library includes five PSS/E supported built-in models for synchronous generators.
The classical model that only models the mechanical behaviour of machine: SyncGenGENCLS.
The sixth order round rotor detailed model with the impact of exponential saturation: SyncGenGENROE.
The sixth order round rotor detailed model with the impact of quadratic saturation: SyncGenGENROU.
The fifth order salient pole model with the impact of exponential saturation on both axis: SyncGenGENSAE.
The fifth order salient pole model with the impact of quadratic saturation on d-axis: SyncGenGENSAL.
SyncGenGENCLS
A constant voltage behind the d-axis transient reactance is used to model a second-order classical synchronous generator. This model is valid for dynamics in few cycles after oscillation, or for generators that are far from the disturbance location.
Parameters
Symbol | Description | Unit |
|---|---|---|
Bus | Bus name (Bus ID) | a unique name |
ID | Machine name (Machine ID) | a unique name |
Status | Connect/Disconnect status | 1 for connected 0 for disconnected |
Pg (MW) | Active power | MW |
Qg (MVAr) | Reactive power | MVAr |
Qmin (MVAr) | Minimum reactive power for the machine (for power-flow study) | MVAr |
Qmax (MVAr) | Maximum reactive power for the machine (for power-flow study) | MVAr |
Sbase (MVA) | Power base | MVA |
H (s) | Inertia | second |
D | Damping factor | in machine p.u. |
Ra (pu) | Stator resistance | machine p.u. |
x'_d (pu) | d-axis transient reactance | machine p.u. |
SyncGenGENROE
Parameters
Symbol | Description | Unit |
|---|---|---|
Bus | Bus name (Bus ID) | a unique name |
ID | Machine name (Machine ID) | a unique name |
Status | Connect/Disconnect status | 1 for connected 0 for disconnected |
Pg (MW) | Active power | MW |
Qg (MVAr) | Reactive power | MVAr |
Qmin (MVAr) | Minimum reactive power for the machine (used in power-flow) | MVAr |
Qmax (MVAr) | Maximum reactive power for the machine (used in power-flow) | MVAr |
Sbase (MVA) | Power base | MVA |
H (s) | Inertia | second |
D | Damping factor | in machine p.u. |
Ra (pu) | Stator resistance | in machine p.u. |
x_d (pu) | d-axis reactance | in machine p.u. |
x_q (pu) | q-axis reactance | in machine p.u. |
x'_d (pu) | d-axis transient reactance | in machine p.u. |
x'_q (pu) | q-axis transient reactance | in machine p.u. |
x"_d (pu) | d-axis sub-transient reactance (x"_d=x"_q) | in machine p.u. |
x_l (pu) | Leakage | in machine p.u. |
T'_do (s) | d-axis transient open-circuit time constant | second |
T"_do (s) | d-axis sub-transient open-circuit time constant | second |
T'_qo (s) | q-axis transient open-circuit time constant | second |
T"_qo (s) | q-axis sub-transient open-circuit time constant | second |
S10 | Saturation function value for 1 p.u. input |
|
S12 | Saturation function value for 1.2 p.u. input |
|
SyncGenGENROU
This model is the equivalent of GENROU in the PSS/E library. It is a sixth-order model with a saturation effect. This model includes transient and sub-transient reactances, one damper winding on the d-axis, and two damper windings on the q-axis.
Parameters
Symbol | Description | Unit |
|---|---|---|
Bus | Bus name (Bus ID) | a unique name |
ID | Machine name (Machine ID) | a unique name |
Status | Connect/Disconnect status | 1 for connected 0 for disconnected |
Pg (MW) | Active power | MW |
Qg (MVAr) | Reactive power | MVAr |
Qmin (MVAr) | Minimum reactive power for the machine (used in power-flow) | MVAr |
Qmax (MVAr) | Maximum reactive power for the machine (used in power-flow) | MVAr |
Sbase (MVA) | Power base | MVA |
H (s) | Inertia | second |
D | Damping factor | in machine p.u. |
Ra (pu) | Stator resistance | in machine p.u. |
x_d (pu) | d-axis reactance | in machine p.u. |
x_q (pu) | q-axis reactance | in machine p.u. |
x'_d (pu) | d-axis transient reactance | in machine p.u. |
x'_q (pu) | q-axis transient reactance | in machine p.u. |
x"_d (pu) | d-axis sub-transient reactance (x"_d=x"_q) | in machine p.u. |
x_l (pu) | Leakage | in machine p.u. |
T'_do (s) | d-axis transient open-circuit time constant | second |
T"_do (s) | d-axis sub-transient open-circuit time constant | second |
T'_qo (s) | q-axis transient open-circuit time constant | second |
T"_qo (s) | q-axis sub-transient open-circuit time constant | second |
S10 | Saturation function value for 1 p.u. input |
|
S12 | Saturation function value for 1.2 p.u. input |
|
SyncGenGENSAE
Parameters
Symbol | Description | Unit |
|---|---|---|
Bus | Bus name (Bus ID) | a unique name |
ID | Machine name (Machine ID) | a unique name |
Status | Connect/Disconnect status | 1 for connected 0 for disconnected |
Pg (MW) | Active power | MW |
Qg (MVAr) | Reactive power | MVAr |
Qmin (MVAr) | Minimum reactive power for the machine (used in power-flow) | MVAr |
Qmax (MVAr) | Maximum reactive power for the machine (used in power-flow) | MVAr |
Sbase (MVA) | Power base | MVA |
H (s) | Inertia | second |
D | Damping factor | in machine p.u. |
Ra (pu) | Stator resistance | in machine p.u. |
x_d (pu) | d-axis reactance | in machine p.u. |
x_q (pu) | q-axis reactance | in machine p.u. |
x'_d (pu) | d-axis transient reactance | in machine p.u. |
x"_d (pu) | d-axis sub-transient reactance (x"_d=x"_q) | in machine p.u. |
x_l (pu) | Leakage | in machine p.u. |
T'_do (s) | d-axis transient open-circuit time constant | second |
T"_do (s) | d-axis sub-transient open-circuit time constant | second |
T"_qo (s) | q-axis sub-transient open-circuit time constant | second |
S10 | Saturation function value for 1 p.u. input |
|
S12 | Saturation function value for 1.2 p.u. input |
|
SyncGenGENSAL
Parameters
Symbol | Description | Unit |
|---|---|---|
Bus | Bus name (Bus ID) | a unique name |
ID | Machine name (Machine ID) | a unique name |
Status | Connect/Disconnect status | 1 for connected 0 for disconnected |
Pg (MW) | Active power | MW |
Qg (MVAr) | Reactive power | MVAr |
Qmin (MVAr) | Minimum reactive power for the machine (used in power-flow) | MVAr |
Qmax (MVAr) | Maximum reactive power for the machine (used in power-flow) | MVAr |
Sbase (MVA) | Power base | MVA |
H (s) | Inertia | second |
D | Damping factor | in machine p.u. |
Ra | Stator resistance | in machine p.u. |
x_d (pu) | d-axis reactance | in machine p.u. |
x_q (pu) | q-axis reactance | in machine p.u. |
x'_d (pu) | d-axis transient reactance | in machine p.u. |
x"_d (pu) | d-axis sub-transient reactance (x"_d=x"_q) | in machine p.u. |
x_l (pu) | Leakage | in machine p.u. |
T'_do (s) | d-axis transient open-circuit time constant | second |
T"_do (s) | d-axis sub-transient open-circuit time constant | second |
T"_qo (s) | q-axis sub-transient open-circuit time constant | second |
S10 | Saturation function value for 1 p.u. input |
|
S12 | Saturation function value for 1.2 p.u. input |
|
Available I/O Pins
No | Pin Description | Pin Type | Value/Unit | Instruction |
|---|---|---|---|---|
1 | Get rotor angle | O | Radian | machineID/pins/delta |
2 | Get rotor speed deviation | O | p.u. | machineID/pins/slip |
3 | Get injected current magnitude | O | p.u. (machine base) | machineID/pins/Imag |
4 | Get injected current angle | O | Degree | machineID/pins/Iang |
5 | Get internal voltage magnitude | O | p.u. | machineID/pins/internalVmag |
6 | Get internal voltage angle | O | Degree | machineID/pins/getInternalVang (up to RT-LAB 2023.2) |
7 | Set/Get excitation voltage | I/O | p.u. | machineID/pins/Efd |
8 | Set/Get mechanical input torque | I/O | p.u. (machine base) | machineID/pins/Pmech |
9 | Set/Get service status | I/O | 1: In-service 0: Out-of-service | machineID/pins/status |
10 | Get generated active power | O | MW | machineID/pins/Pelec |
11 | Get generated reactive power | O | MVAr | machineID/pins/Qelec |
Example
See the Machine page in phasor01_IEEE39.xlsx file in the ePHASORSIM example phasor01.
OPAL-RT TECHNOLOGIES, Inc. | 1751, rue Richardson, bureau 1060 | Montréal, Québec Canada H3K 1G6 | opal-rt.com | +1 514-935-2323
Follow OPAL-RT: LinkedIn | Facebook | YouTube | X/Twitter