Machine models from PSSE
Extends from Modelica.Icons.Package (Icon for standard packages).
| Name | Description |
|---|---|
| Framework for an electrical plant including controllers | |
| PSSE CIM5 three-phase induction motor model | |
| PSSE CIM6 three-phase induction motor model | |
| Classic generator model that can also represent an infinite bus | |
| ROUND ROTOR GENERATOR MODEL (EXPONENTIAL SATURATION) | |
| ROUND ROTOR GENERATOR MODEL (QUADRATIC SATURATION) | |
| SALIENT POLE GENERATOR MODEL (EXPONENTIAL SATURATION) | |
| SALIENT POLE GENERATOR MODEL (QUADRATIC SATURATION ON D-AXIS) | |
| WECC Type J GENERATOR: ROUND ROTOR WITH SATURATION ON BOTH AXES. | |
| Base classes for base machines from PSSE |
OpenIPSL.Electrical.Machines.PSSE.PlantFramework for an electrical plant including controllers
This model is meant as a simple framework to create a electric power plant that consists of:
The type of each can be selected via a drop down list where also a deactivation is provided (normally via feed through).
Extends from Interfaces.Generator (Interface for a generator which provides the PwPin).
| Name | Description |
|---|---|
| machine | |
| exciter | |
| governor | |
| pss | |
| Power flow data | |
| S_b | System base power [V.A] |
| V_b | Base voltage of the bus [V] |
| fn | System frequency [Hz] |
| P_0 | Initial active power [W] |
| Q_0 | Initial reactive power [var] |
| v_0 | Initial voltage magnitude [1] |
| angle_0 | Initial voltage angle [rad] |
| displayPF | Display power flow: |
| Name | Description |
|---|---|
| pwPin |
OpenIPSL.Electrical.Machines.PSSE.CIM5PSSE CIM5 three-phase induction motor model
The CIM5 induction motor model represents an induction machine that can be either model a single or double cage motor. The model can represent two distinct impedance circuits depending on the selected type.
The load torque equation for the CIM5 motor model is defines as:
TL = T(1+w)^D
The modelling of such devices is based, mainly, on the following references:
Siemens: "PSS®E Model Library" [PSSE-MODELS].
PowerWorld: Load Characteristic Models [PSSEMotor].
Extends from OpenIPSL.Electrical.Machines.PSSE.BaseClasses.baseMotor (Base model for the PSSE three-phase induction motor models).
| Name | Description |
|---|---|
| Power flow data | |
| M_b | Machine base power [V.A] |
| S_b | System base power [V.A] |
| V_b | Base voltage of the bus [V] |
| fn | System frequency [Hz] |
| P_0 | Initial active power [W] |
| Q_0 | Initial reactive power [var] |
| v_0 | Initial voltage magnitude [1] |
| angle_0 | Initial voltage angle [rad] |
| displayPF | Display power flow: |
| Motor Setup | |
| Sup | True: Start-up process, False: Steady-state condition |
| Ctrl | True: Model for VSD control, False: Model not controllable |
| Mtype | 1- Motor Type A; 2- Motor Type B |
| Machine parameters | |
| N | Number of pair of Poles |
| H | Inertia constant [s] |
| Ra | Stator resistance [1] |
| Xa | Stator reactance [1] |
| Xm | Magnetizing reactance [1] |
| R1 | 1st cage rotor resistance [1] |
| X1 | 1st cage rotor reactance [1] |
| R2 | 2nd cage rotor resistance. To model single cage motor set R2 = 0. [1] |
| X2 | 2nd cage rotor reactance. To model single cage motor set X2 = 0. [1] |
| E1 | First Saturation Voltage Value [1] |
| SE1 | Saturation Factor at E1 [1] |
| E2 | Second Saturation Voltage Value [1] |
| SE2 | Saturation Factor at E2 [1] |
| T_nom | Load torque at 1 pu speed |
| D | Load Damping Factor |
| Name | Description |
|---|---|
| p | |
| wr | Absolute angular velocity of flange as output signal (rad/s) |
| we | Input for controllable synchronous speed functionality (rad/s) |
OpenIPSL.Electrical.Machines.PSSE.CIM6PSSE CIM6 three-phase induction motor model
The CIM6 induction motor model represents an induction machine that can be either model a single or double cage motor. The model can represent two distinct impedance circuits depending on the selected type.
The load torque equation for the CIM6 motor model is defines as:
TL = T(Aw^2 + B*w + C0 + Dw^E)
The modelling of such devices is based, mainly, on the following references:
Siemens: "PSS®E Model Library" [PSSE-MODELS].
PowerWorld: Load Characteristic Models [PSSEMotor].
Extends from OpenIPSL.Electrical.Machines.PSSE.BaseClasses.baseMotor (Base model for the PSSE three-phase induction motor models).
| Name | Description |
|---|---|
| Power flow data | |
| M_b | Machine base power [V.A] |
| S_b | System base power [V.A] |
| V_b | Base voltage of the bus [V] |
| fn | System frequency [Hz] |
| P_0 | Initial active power [W] |
| Q_0 | Initial reactive power [var] |
| v_0 | Initial voltage magnitude [1] |
| angle_0 | Initial voltage angle [rad] |
| displayPF | Display power flow: |
| Motor Setup | |
| Sup | True: Start-up process, False: Steady-state condition |
| Ctrl | True: Model for VSD control, False: Model not controllable |
| Mtype | 1- Motor Type A; 2- Motor Type B |
| Machine parameters | |
| N | Number of pair of Poles |
| H | Inertia constant [s] |
| Ra | Stator resistance [1] |
| Xa | Stator reactance [1] |
| Xm | Magnetizing reactance [1] |
| R1 | 1st cage rotor resistance [1] |
| X1 | 1st cage rotor reactance [1] |
| R2 | 2nd cage rotor resistance. To model single cage motor set R2 = 0. [1] |
| X2 | 2nd cage rotor reactance. To model single cage motor set X2 = 0. [1] |
| E1 | First Saturation Voltage Value [1] |
| SE1 | Saturation Factor at E1 [1] |
| E2 | Second Saturation Voltage Value [1] |
| SE2 | Saturation Factor at E2 [1] |
| T_nom | Load torque at 1 pu speed |
| A | Load Torque Coefficient A |
| B | Load Torque Coefficient B |
| D | Load Torque Coefficient D |
| E | Load Torque Coefficient E |
| C0 | Load Torque Coefficient C0 |
| Name | Description |
|---|---|
| p | |
| wr | Absolute angular velocity of flange as output signal (rad/s) |
| we | Input for controllable synchronous speed functionality (rad/s) |
OpenIPSL.Electrical.Machines.PSSE.GENCLSClassic generator model that can also represent an infinite bus
Synchronous machine represented by 'classical' modeling (see also [PSSE-AGV2], chapter 15).
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 by v_0 and fn, are kept constant.
P and Q are then calculated accordingly (i.e., the initial values
P_0 and Q_0 have no influence on the behavior of the model).H>0: "Classical Generator" model with physically-meaningful parameters, e.g.,
H=5 in a 100 MVA base. The parameters P_0 and Q_0 are used
to specify the fixed active and reactive power injected or absorbed by the model.
The parameters v_0 and fn can be used to specify the initial
voltage and frequency.H>>0: By making H very large, e.g., H=1e6 in a 100 MVA base,
the speed of the machine will not undergo any changes, and consequently will set the frequency f at the
bus to a fixed value (i.e., fn). The parameters P_0, Q_0,
v_0 and fn have the same function as in case 2.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.
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).
| Name | Description |
|---|---|
| Power flow data | |
| S_b | System base power [V.A] |
| V_b | Base voltage of the bus [V] |
| fn | System frequency [Hz] |
| P_0 | Initial active power [W] |
| Q_0 | Initial reactive power [var] |
| v_0 | Initial voltage magnitude [1] |
| angle_0 | Initial voltage angle [rad] |
| displayPF | Display power flow: |
| Machine parameters | |
| M_b | Machine base power rating [V.A] |
| H | Inertia constant [s] |
| D | Damping coefficient |
| R_a | Armature resistance [1] |
| X_d | d-axis transient reactance [1] |
| Parameter mask | |
| enableS_b | Enable S_b in parameter list |
| enableV_b | Enable V_b in parameter list |
| enablefn | Enable fn in parameter list |
| enableP_0 | Enable P_0 in parameter list |
| enableQ_0 | Enable Q_0 in parameter list |
| enablev_0 | Enable v_0 in parameter list |
| enableangle_0 | Enable angle_0 in parameter list |
| enabledisplayPF | Enable displayPF in parameter list |
| Name | Description |
|---|---|
| p |
OpenIPSL.Electrical.Machines.PSSE.GENROEROUND ROTOR GENERATOR MODEL (EXPONENTIAL SATURATION)
Extends from Icons.VerifiedModel (Icon for classes that were verified), BaseClasses.baseMachine (Base machine for PSSE models).
| Name | Description |
|---|---|
| Power flow data | |
| S_b | System base power [V.A] |
| V_b | Base voltage of the bus [V] |
| fn | System frequency [Hz] |
| P_0 | Initial active power [W] |
| Q_0 | Initial reactive power [var] |
| v_0 | Initial voltage magnitude [1] |
| angle_0 | Initial voltage angle [rad] |
| displayPF | Display power flow: |
| Machine parameters | |
| M_b | Machine base power [V.A] |
| Tpd0 | d-axis transient open-circuit time constant [s] |
| Tppd0 | d-axis sub-transient open-circuit time constant [s] |
| Tppq0 | q-axis sub-transient open-circuit time constant [s] |
| H | Inertia constant [s] |
| D | Speed damping |
| Xd | d-axis reactance [1] |
| Xq | q-axis reactance [1] |
| Xpd | d-axis transient reactance [1] |
| Xppd | d-axis sub-transient reactance [1] |
| Xppq | q-axis sub-transient reactance [1] |
| Xl | leakage reactance [1] |
| S10 | Saturation factor at 1.0 pu [1] |
| S12 | Saturation factor at 1.2 pu [1] |
| R_a | Armature resistance [1] |
| Xpq | Sub-transient reactance [1] |
| Tpq0 | q-axis transient open-circuit time constant [s] |
| Xpp | Sub-transient reactance [1] |
| Initialization | |
| w0 | Initial speed deviation from nominal [1] |
| PMECH | Turbine mechanical power (machine base) |
| EFD | Generator main field voltage [pu] |
| XADIFD | Machine field current [pu] |
| delta | Rotor angle [rad] |
| Te | Electrical torque [pu] [1] |
| id | d-axis armature current [pu] [1] |
| iq | q-axis armature current [pu] [1] |
| ud | d-axis terminal voltage [pu] [1] |
| uq | q-axis terminal voltage [pu] [1] |
| Name | Description |
|---|---|
| p | |
| SPEED | Machine speed deviation from nominal [pu] |
| PMECH0 | Initial value of machine electrical power (machine base) |
| ETERM | Machine terminal voltage [pu] |
| EFD0 | Initial generator main field voltage [pu] |
| PELEC | Machine electrical power (machine base) |
| ISORCE | Machine source current [pu] |
| ANGLE | Machine relative rotor angle |
| QELEC | Machine electrical power (machine base) |
| Initialization | |
| PMECH | Turbine mechanical power (machine base) |
| EFD | Generator main field voltage [pu] |
| XADIFD | Machine field current [pu] |
OpenIPSL.Electrical.Machines.PSSE.GENROUROUND ROTOR GENERATOR MODEL (QUADRATIC SATURATION)
Extends from Icons.VerifiedModel (Icon for classes that were verified), BaseClasses.baseMachine (Base machine for PSSE models).
| Name | Description |
|---|---|
| Power flow data | |
| S_b | System base power [V.A] |
| V_b | Base voltage of the bus [V] |
| fn | System frequency [Hz] |
| P_0 | Initial active power [W] |
| Q_0 | Initial reactive power [var] |
| v_0 | Initial voltage magnitude [1] |
| angle_0 | Initial voltage angle [rad] |
| displayPF | Display power flow: |
| Machine parameters | |
| M_b | Machine base power [V.A] |
| Tpd0 | d-axis transient open-circuit time constant [s] |
| Tppd0 | d-axis sub-transient open-circuit time constant [s] |
| Tppq0 | q-axis sub-transient open-circuit time constant [s] |
| H | Inertia constant [s] |
| D | Speed damping |
| Xd | d-axis reactance [1] |
| Xq | q-axis reactance [1] |
| Xpd | d-axis transient reactance [1] |
| Xppd | d-axis sub-transient reactance [1] |
| Xppq | q-axis sub-transient reactance [1] |
| Xl | leakage reactance [1] |
| S10 | Saturation factor at 1.0 pu [1] |
| S12 | Saturation factor at 1.2 pu [1] |
| R_a | Armature resistance [1] |
| Xpq | q-axis transient reactance [1] |
| Tpq0 | q-axis transient open-circuit time constant [s] |
| Xpp | Sub-transient reactance [1] |
| Initialization | |
| w0 | Initial speed deviation from nominal [1] |
| XADIFD | Machine field current [pu] |
| delta | Rotor angle [rad] |
| Te | Electrical torque [pu] [1] |
| id | d-axis armature current [pu] [1] |
| iq | q-axis armature current [pu] [1] |
| ud | d-axis terminal voltage [pu] [1] |
| uq | q-axis terminal voltage [pu] [1] |
| Name | Description |
|---|---|
| p | |
| SPEED | Machine speed deviation from nominal [pu] |
| PMECH | Turbine mechanical power (machine base) |
| PMECH0 | Initial value of machine electrical power (machine base) |
| ETERM | Machine terminal voltage [pu] |
| EFD | Generator main field voltage [pu] |
| EFD0 | Initial generator main field voltage [pu] |
| PELEC | Machine electrical power (machine base) |
| ISORCE | Machine source current [pu] |
| ANGLE | Machine relative rotor angle |
| QELEC | Machine electrical power (machine base) |
| Initialization | |
| XADIFD | Machine field current [pu] |
OpenIPSL.Electrical.Machines.PSSE.GENSAESALIENT POLE GENERATOR MODEL (EXPONENTIAL SATURATION)
Extends from Icons.VerifiedModel (Icon for classes that were verified), BaseClasses.baseMachine (Base machine for PSSE models).
| Name | Description |
|---|---|
| Power flow data | |
| S_b | System base power [V.A] |
| V_b | Base voltage of the bus [V] |
| fn | System frequency [Hz] |
| P_0 | Initial active power [W] |
| Q_0 | Initial reactive power [var] |
| v_0 | Initial voltage magnitude [1] |
| angle_0 | Initial voltage angle [rad] |
| displayPF | Display power flow: |
| Machine parameters | |
| M_b | Machine base power [V.A] |
| Tpd0 | d-axis transient open-circuit time constant [s] |
| Tppd0 | d-axis sub-transient open-circuit time constant [s] |
| Tppq0 | q-axis sub-transient open-circuit time constant [s] |
| H | Inertia constant [s] |
| D | Speed damping |
| Xd | d-axis reactance [1] |
| Xq | q-axis reactance [1] |
| Xpd | d-axis transient reactance [1] |
| Xppd | d-axis sub-transient reactance [1] |
| Xppq | q-axis sub-transient reactance [1] |
| Xl | leakage reactance [1] |
| S10 | Saturation factor at 1.0 pu [1] |
| S12 | Saturation factor at 1.2 pu [1] |
| R_a | Armature resistance [1] |
| Initialization | |
| w0 | Initial speed deviation from nominal [1] |
| PMECH | Turbine mechanical power (machine base) |
| EFD | Generator main field voltage [pu] |
| XADIFD | Machine field current [pu] |
| delta | Rotor angle [rad] |
| Te | Electrical torque [pu] [1] |
| id | d-axis armature current [pu] [1] |
| iq | q-axis armature current [pu] [1] |
| ud | d-axis terminal voltage [pu] [1] |
| uq | q-axis terminal voltage [pu] [1] |
| Name | Description |
|---|---|
| p | |
| SPEED | Machine speed deviation from nominal [pu] |
| PMECH0 | Initial value of machine electrical power (machine base) |
| ETERM | Machine terminal voltage [pu] |
| EFD0 | Initial generator main field voltage [pu] |
| PELEC | Machine electrical power (machine base) |
| ISORCE | Machine source current [pu] |
| ANGLE | Machine relative rotor angle |
| QELEC | Machine electrical power (machine base) |
| Initialization | |
| PMECH | Turbine mechanical power (machine base) |
| EFD | Generator main field voltage [pu] |
| XADIFD | Machine field current [pu] |
OpenIPSL.Electrical.Machines.PSSE.GENSALSALIENT POLE GENERATOR MODEL (QUADRATIC SATURATION ON D-AXIS)
Extends from Icons.VerifiedModel (Icon for classes that were verified), BaseClasses.baseMachine (Base machine for PSSE models).
| Name | Description |
|---|---|
| Power flow data | |
| S_b | System base power [V.A] |
| V_b | Base voltage of the bus [V] |
| fn | System frequency [Hz] |
| P_0 | Initial active power [W] |
| Q_0 | Initial reactive power [var] |
| v_0 | Initial voltage magnitude [1] |
| angle_0 | Initial voltage angle [rad] |
| displayPF | Display power flow: |
| Machine parameters | |
| M_b | Machine base power [V.A] |
| Tpd0 | d-axis transient open-circuit time constant [s] |
| Tppd0 | d-axis sub-transient open-circuit time constant [s] |
| Tppq0 | q-axis sub-transient open-circuit time constant [s] |
| H | Inertia constant [s] |
| D | Speed damping |
| Xd | d-axis reactance [1] |
| Xq | q-axis reactance [1] |
| Xpd | d-axis transient reactance [1] |
| Xppd | d-axis sub-transient reactance [1] |
| Xppq | q-axis sub-transient reactance [1] |
| Xl | leakage reactance [1] |
| S10 | Saturation factor at 1.0 pu [1] |
| S12 | Saturation factor at 1.2 pu [1] |
| R_a | Armature resistance [1] |
| Initialization | |
| w0 | Initial speed deviation from nominal [1] |
| PMECH | Turbine mechanical power (machine base) |
| EFD | Generator main field voltage [pu] |
| XADIFD | Machine field current [pu] |
| delta | Rotor angle [rad] |
| Te | Electrical torque [pu] [1] |
| id | d-axis armature current [pu] [1] |
| iq | q-axis armature current [pu] [1] |
| ud | d-axis terminal voltage [pu] [1] |
| uq | q-axis terminal voltage [pu] [1] |
| Name | Description |
|---|---|
| p | |
| SPEED | Machine speed deviation from nominal [pu] |
| PMECH0 | Initial value of machine electrical power (machine base) |
| ETERM | Machine terminal voltage [pu] |
| EFD0 | Initial generator main field voltage [pu] |
| PELEC | Machine electrical power (machine base) |
| ISORCE | Machine source current [pu] |
| ANGLE | Machine relative rotor angle |
| QELEC | Machine electrical power (machine base) |
| Initialization | |
| PMECH | Turbine mechanical power (machine base) |
| EFD | Generator main field voltage [pu] |
| XADIFD | Machine field current [pu] |
OpenIPSL.Electrical.Machines.PSSE.GENTPJWECC Type J GENERATOR: ROUND ROTOR WITH SATURATION ON BOTH AXES.
Solid rotor generator with saturation on both axes. The saturation in this model is not only function of the air-gap flux, but also of armature current magnitude. This effect is included via parameter Kis.
If Kis is set to zero, then the model will behave like the WECC Type F Generator, that is, GENTPF.
Extends from OpenIPSL.Icons.VerifiedModel (Icon for classes that were verified), OpenIPSL.Electrical.Machines.PSSE.BaseClasses.baseMachine (Base machine for PSSE models).
| Name | Description |
|---|---|
| Power flow data | |
| S_b | System base power [V.A] |
| V_b | Base voltage of the bus [V] |
| fn | System frequency [Hz] |
| P_0 | Initial active power [W] |
| Q_0 | Initial reactive power [var] |
| v_0 | Initial voltage magnitude [1] |
| angle_0 | Initial voltage angle [rad] |
| displayPF | Display power flow: |
| Machine parameters | |
| M_b | Machine base power [V.A] |
| Tpd0 | d-axis transient open-circuit time constant [s] |
| Tppd0 | d-axis sub-transient open-circuit time constant [s] |
| Tppq0 | q-axis sub-transient open-circuit time constant [s] |
| H | Inertia constant [s] |
| D | Speed damping |
| Xd | d-axis reactance [1] |
| Xq | q-axis reactance [1] |
| Xpd | d-axis transient reactance [1] |
| Xppd | d-axis sub-transient reactance [1] |
| Xppq | q-axis sub-transient reactance [1] |
| Xl | leakage reactance [1] |
| S10 | Saturation factor at 1.0 pu [1] |
| S12 | Saturation factor at 1.2 pu [1] |
| R_a | Armature resistance [1] |
| Xpq | q-axis transient reactance [1] |
| Tpq0 | q-axis transient open-circuit time constant [s] |
| Kis | Current multiplier for saturation calculation [1] |
| Initialization | |
| w0 | Initial speed deviation from nominal [1] |
| XADIFD | Machine field current [pu] |
| delta | Rotor angle [rad] |
| Te | Electrical torque [pu] [1] |
| id | d-axis armature current [pu] [1] |
| iq | q-axis armature current [pu] [1] |
| ud | d-axis terminal voltage [pu] [1] |
| uq | q-axis terminal voltage [pu] [1] |
| Name | Description |
|---|---|
| p | |
| SPEED | Machine speed deviation from nominal [pu] |
| PMECH | Turbine mechanical power (machine base) |
| PMECH0 | Initial value of machine electrical power (machine base) |
| ETERM | Machine terminal voltage [pu] |
| EFD | Generator main field voltage [pu] |
| EFD0 | Initial generator main field voltage [pu] |
| PELEC | Machine electrical power (machine base) |
| ISORCE | Machine source current [pu] |
| ANGLE | Machine relative rotor angle |
| QELEC | Machine electrical power (machine base) |
| Initialization | |
| XADIFD | Machine field current [pu] |