OpenIPSL.Electrical.Machines.PSSE

Machine models from PSSE

Information

Extends from Modelica.Icons.Package (Icon for standard packages).

Package Content

Name Description
OpenIPSL.Electrical.Machines.PSSE.Plant Plant Framework for an electrical plant including controllers
OpenIPSL.Electrical.Machines.PSSE.CIM5 CIM5 PSSE CIM5 three-phase induction motor model
OpenIPSL.Electrical.Machines.PSSE.CIM6 CIM6 PSSE CIM6 three-phase induction motor model
OpenIPSL.Electrical.Machines.PSSE.GENCLS GENCLS Classic generator model that can also represent an infinite bus
OpenIPSL.Electrical.Machines.PSSE.GENROE GENROE ROUND ROTOR GENERATOR MODEL (EXPONENTIAL SATURATION)
OpenIPSL.Electrical.Machines.PSSE.GENROU GENROU ROUND ROTOR GENERATOR MODEL (QUADRATIC SATURATION)
OpenIPSL.Electrical.Machines.PSSE.GENSAE GENSAE SALIENT POLE GENERATOR MODEL (EXPONENTIAL SATURATION)
OpenIPSL.Electrical.Machines.PSSE.GENSAL GENSAL SALIENT POLE GENERATOR MODEL (QUADRATIC SATURATION ON D-AXIS)
OpenIPSL.Electrical.Machines.PSSE.GENTPJ GENTPJ WECC Type J GENERATOR: ROUND ROTOR WITH SATURATION ON BOTH AXES.
OpenIPSL.Electrical.Machines.PSSE.BaseClasses BaseClasses Base classes for base machines from PSSE

OpenIPSL.Electrical.Machines.PSSE.Plant OpenIPSL.Electrical.Machines.PSSE.Plant

Framework for an electrical plant including controllers

Information

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).

Parameters

NameDescription
machine 
exciter 
governor 
pss 
Power flow data
S_bSystem base power [V.A]
V_bBase voltage of the bus [V]
fnSystem frequency [Hz]
P_0Initial active power [W]
Q_0Initial reactive power [var]
v_0Initial voltage magnitude [1]
angle_0Initial voltage angle [rad]
displayPFDisplay power flow:

Connectors

NameDescription
pwPin 

OpenIPSL.Electrical.Machines.PSSE.CIM5 OpenIPSL.Electrical.Machines.PSSE.CIM5

PSSE CIM5 three-phase induction motor model

Information

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:

Extends from OpenIPSL.Electrical.Machines.PSSE.BaseClasses.baseMotor (Base model for the PSSE three-phase induction motor models).

Parameters

NameDescription
Power flow data
M_bMachine base power [V.A]
S_bSystem base power [V.A]
V_bBase voltage of the bus [V]
fnSystem frequency [Hz]
P_0Initial active power [W]
Q_0Initial reactive power [var]
v_0Initial voltage magnitude [1]
angle_0Initial voltage angle [rad]
displayPFDisplay power flow:
Motor Setup
SupTrue: Start-up process, False: Steady-state condition
CtrlTrue: Model for VSD control, False: Model not controllable
Mtype1- Motor Type A; 2- Motor Type B
Machine parameters
NNumber of pair of Poles
HInertia constant [s]
RaStator resistance [1]
XaStator reactance [1]
XmMagnetizing reactance [1]
R11st cage rotor resistance [1]
X11st cage rotor reactance [1]
R22nd cage rotor resistance. To model single cage motor set R2 = 0. [1]
X22nd cage rotor reactance. To model single cage motor set X2 = 0. [1]
E1First Saturation Voltage Value [1]
SE1Saturation Factor at E1 [1]
E2Second Saturation Voltage Value [1]
SE2Saturation Factor at E2 [1]
T_nomLoad torque at 1 pu speed
DLoad Damping Factor

Connectors

NameDescription
p 
wrAbsolute angular velocity of flange as output signal (rad/s)
weInput for controllable synchronous speed functionality (rad/s)

OpenIPSL.Electrical.Machines.PSSE.CIM6 OpenIPSL.Electrical.Machines.PSSE.CIM6

PSSE CIM6 three-phase induction motor model

Information

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:

Extends from OpenIPSL.Electrical.Machines.PSSE.BaseClasses.baseMotor (Base model for the PSSE three-phase induction motor models).

Parameters

NameDescription
Power flow data
M_bMachine base power [V.A]
S_bSystem base power [V.A]
V_bBase voltage of the bus [V]
fnSystem frequency [Hz]
P_0Initial active power [W]
Q_0Initial reactive power [var]
v_0Initial voltage magnitude [1]
angle_0Initial voltage angle [rad]
displayPFDisplay power flow:
Motor Setup
SupTrue: Start-up process, False: Steady-state condition
CtrlTrue: Model for VSD control, False: Model not controllable
Mtype1- Motor Type A; 2- Motor Type B
Machine parameters
NNumber of pair of Poles
HInertia constant [s]
RaStator resistance [1]
XaStator reactance [1]
XmMagnetizing reactance [1]
R11st cage rotor resistance [1]
X11st cage rotor reactance [1]
R22nd cage rotor resistance. To model single cage motor set R2 = 0. [1]
X22nd cage rotor reactance. To model single cage motor set X2 = 0. [1]
E1First Saturation Voltage Value [1]
SE1Saturation Factor at E1 [1]
E2Second Saturation Voltage Value [1]
SE2Saturation Factor at E2 [1]
T_nomLoad torque at 1 pu speed
ALoad Torque Coefficient A
BLoad Torque Coefficient B
DLoad Torque Coefficient D
ELoad Torque Coefficient E
C0Load Torque Coefficient C0

Connectors

NameDescription
p 
wrAbsolute angular velocity of flange as output signal (rad/s)
weInput for controllable synchronous speed functionality (rad/s)

OpenIPSL.Electrical.Machines.PSSE.GENCLS OpenIPSL.Electrical.Machines.PSSE.GENCLS

Classic generator model that can also represent an infinite bus

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:

  1. 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).
  2. 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.
  3. 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.
Applications
  1. H=0: Infinite bus
  2. H>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.
  3. 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).

Parameters

NameDescription
Power flow data
S_bSystem base power [V.A]
V_bBase voltage of the bus [V]
fnSystem frequency [Hz]
P_0Initial active power [W]
Q_0Initial reactive power [var]
v_0Initial voltage magnitude [1]
angle_0Initial voltage angle [rad]
displayPFDisplay power flow:
Machine parameters
M_bMachine base power rating [V.A]
HInertia constant [s]
DDamping coefficient
R_aArmature resistance [1]
X_dd-axis transient reactance [1]
Parameter mask
enableS_bEnable S_b in parameter list
enableV_bEnable V_b in parameter list
enablefnEnable fn in parameter list
enableP_0Enable P_0 in parameter list
enableQ_0Enable Q_0 in parameter list
enablev_0Enable v_0 in parameter list
enableangle_0Enable angle_0 in parameter list
enabledisplayPFEnable displayPF in parameter list

Connectors

NameDescription
p 

OpenIPSL.Electrical.Machines.PSSE.GENROE OpenIPSL.Electrical.Machines.PSSE.GENROE

ROUND ROTOR GENERATOR MODEL (EXPONENTIAL SATURATION)

Information

Round Rotor Generator Model GENROE. It is the same as GENROU model except that an exponential function is used as saturation.

Extends from Icons.VerifiedModel (Icon for classes that were verified), BaseClasses.baseMachine (Base machine for PSSE models).

Parameters

NameDescription
Power flow data
S_bSystem base power [V.A]
V_bBase voltage of the bus [V]
fnSystem frequency [Hz]
P_0Initial active power [W]
Q_0Initial reactive power [var]
v_0Initial voltage magnitude [1]
angle_0Initial voltage angle [rad]
displayPFDisplay power flow:
Machine parameters
M_bMachine base power [V.A]
Tpd0d-axis transient open-circuit time constant [s]
Tppd0d-axis sub-transient open-circuit time constant [s]
Tppq0q-axis sub-transient open-circuit time constant [s]
HInertia constant [s]
DSpeed damping
Xdd-axis reactance [1]
Xqq-axis reactance [1]
Xpdd-axis transient reactance [1]
Xppdd-axis sub-transient reactance [1]
Xppqq-axis sub-transient reactance [1]
Xlleakage reactance [1]
S10Saturation factor at 1.0 pu [1]
S12Saturation factor at 1.2 pu [1]
R_aArmature resistance [1]
XpqSub-transient reactance [1]
Tpq0q-axis transient open-circuit time constant [s]
XppSub-transient reactance [1]
Initialization
w0Initial speed deviation from nominal [1]
PMECHTurbine mechanical power (machine base)
EFDGenerator main field voltage [pu]
XADIFDMachine field current [pu]
deltaRotor angle [rad]
TeElectrical torque [pu] [1]
idd-axis armature current [pu] [1]
iqq-axis armature current [pu] [1]
udd-axis terminal voltage [pu] [1]
uqq-axis terminal voltage [pu] [1]

Connectors

NameDescription
p 
SPEEDMachine speed deviation from nominal [pu]
PMECH0Initial value of machine electrical power (machine base)
ETERMMachine terminal voltage [pu]
EFD0Initial generator main field voltage [pu]
PELECMachine electrical power (machine base)
ISORCEMachine source current [pu]
ANGLEMachine relative rotor angle
QELECMachine electrical power (machine base)
Initialization
PMECHTurbine mechanical power (machine base)
EFDGenerator main field voltage [pu]
XADIFDMachine field current [pu]

OpenIPSL.Electrical.Machines.PSSE.GENROU OpenIPSL.Electrical.Machines.PSSE.GENROU

ROUND ROTOR GENERATOR MODEL (QUADRATIC SATURATION)

Information

Solid Rotor Generator represented by equal mutual inductance rotor modeling.

Extends from Icons.VerifiedModel (Icon for classes that were verified), BaseClasses.baseMachine (Base machine for PSSE models).

Parameters

NameDescription
Power flow data
S_bSystem base power [V.A]
V_bBase voltage of the bus [V]
fnSystem frequency [Hz]
P_0Initial active power [W]
Q_0Initial reactive power [var]
v_0Initial voltage magnitude [1]
angle_0Initial voltage angle [rad]
displayPFDisplay power flow:
Machine parameters
M_bMachine base power [V.A]
Tpd0d-axis transient open-circuit time constant [s]
Tppd0d-axis sub-transient open-circuit time constant [s]
Tppq0q-axis sub-transient open-circuit time constant [s]
HInertia constant [s]
DSpeed damping
Xdd-axis reactance [1]
Xqq-axis reactance [1]
Xpdd-axis transient reactance [1]
Xppdd-axis sub-transient reactance [1]
Xppqq-axis sub-transient reactance [1]
Xlleakage reactance [1]
S10Saturation factor at 1.0 pu [1]
S12Saturation factor at 1.2 pu [1]
R_aArmature resistance [1]
Xpqq-axis transient reactance [1]
Tpq0q-axis transient open-circuit time constant [s]
XppSub-transient reactance [1]
Initialization
w0Initial speed deviation from nominal [1]
XADIFDMachine field current [pu]
deltaRotor angle [rad]
TeElectrical torque [pu] [1]
idd-axis armature current [pu] [1]
iqq-axis armature current [pu] [1]
udd-axis terminal voltage [pu] [1]
uqq-axis terminal voltage [pu] [1]

Connectors

NameDescription
p 
SPEEDMachine speed deviation from nominal [pu]
PMECHTurbine mechanical power (machine base)
PMECH0Initial value of machine electrical power (machine base)
ETERMMachine terminal voltage [pu]
EFDGenerator main field voltage [pu]
EFD0Initial generator main field voltage [pu]
PELECMachine electrical power (machine base)
ISORCEMachine source current [pu]
ANGLEMachine relative rotor angle
QELECMachine electrical power (machine base)
Initialization
XADIFDMachine field current [pu]

OpenIPSL.Electrical.Machines.PSSE.GENSAE OpenIPSL.Electrical.Machines.PSSE.GENSAE

SALIENT POLE GENERATOR MODEL (EXPONENTIAL SATURATION)

Information

Salient Pole Generator represented by equal mutual inductance rotor modeling. The model is the same as GENSAL model with the exception that an exponential function is used for saturation.

Extends from Icons.VerifiedModel (Icon for classes that were verified), BaseClasses.baseMachine (Base machine for PSSE models).

Parameters

NameDescription
Power flow data
S_bSystem base power [V.A]
V_bBase voltage of the bus [V]
fnSystem frequency [Hz]
P_0Initial active power [W]
Q_0Initial reactive power [var]
v_0Initial voltage magnitude [1]
angle_0Initial voltage angle [rad]
displayPFDisplay power flow:
Machine parameters
M_bMachine base power [V.A]
Tpd0d-axis transient open-circuit time constant [s]
Tppd0d-axis sub-transient open-circuit time constant [s]
Tppq0q-axis sub-transient open-circuit time constant [s]
HInertia constant [s]
DSpeed damping
Xdd-axis reactance [1]
Xqq-axis reactance [1]
Xpdd-axis transient reactance [1]
Xppdd-axis sub-transient reactance [1]
Xppqq-axis sub-transient reactance [1]
Xlleakage reactance [1]
S10Saturation factor at 1.0 pu [1]
S12Saturation factor at 1.2 pu [1]
R_aArmature resistance [1]
Initialization
w0Initial speed deviation from nominal [1]
PMECHTurbine mechanical power (machine base)
EFDGenerator main field voltage [pu]
XADIFDMachine field current [pu]
deltaRotor angle [rad]
TeElectrical torque [pu] [1]
idd-axis armature current [pu] [1]
iqq-axis armature current [pu] [1]
udd-axis terminal voltage [pu] [1]
uqq-axis terminal voltage [pu] [1]

Connectors

NameDescription
p 
SPEEDMachine speed deviation from nominal [pu]
PMECH0Initial value of machine electrical power (machine base)
ETERMMachine terminal voltage [pu]
EFD0Initial generator main field voltage [pu]
PELECMachine electrical power (machine base)
ISORCEMachine source current [pu]
ANGLEMachine relative rotor angle
QELECMachine electrical power (machine base)
Initialization
PMECHTurbine mechanical power (machine base)
EFDGenerator main field voltage [pu]
XADIFDMachine field current [pu]

OpenIPSL.Electrical.Machines.PSSE.GENSAL OpenIPSL.Electrical.Machines.PSSE.GENSAL

SALIENT POLE GENERATOR MODEL (QUADRATIC SATURATION ON D-AXIS)

Information

Salient Pole Generator represented by equal mutual inductance rotor modeling.

Extends from Icons.VerifiedModel (Icon for classes that were verified), BaseClasses.baseMachine (Base machine for PSSE models).

Parameters

NameDescription
Power flow data
S_bSystem base power [V.A]
V_bBase voltage of the bus [V]
fnSystem frequency [Hz]
P_0Initial active power [W]
Q_0Initial reactive power [var]
v_0Initial voltage magnitude [1]
angle_0Initial voltage angle [rad]
displayPFDisplay power flow:
Machine parameters
M_bMachine base power [V.A]
Tpd0d-axis transient open-circuit time constant [s]
Tppd0d-axis sub-transient open-circuit time constant [s]
Tppq0q-axis sub-transient open-circuit time constant [s]
HInertia constant [s]
DSpeed damping
Xdd-axis reactance [1]
Xqq-axis reactance [1]
Xpdd-axis transient reactance [1]
Xppdd-axis sub-transient reactance [1]
Xppqq-axis sub-transient reactance [1]
Xlleakage reactance [1]
S10Saturation factor at 1.0 pu [1]
S12Saturation factor at 1.2 pu [1]
R_aArmature resistance [1]
Initialization
w0Initial speed deviation from nominal [1]
PMECHTurbine mechanical power (machine base)
EFDGenerator main field voltage [pu]
XADIFDMachine field current [pu]
deltaRotor angle [rad]
TeElectrical torque [pu] [1]
idd-axis armature current [pu] [1]
iqq-axis armature current [pu] [1]
udd-axis terminal voltage [pu] [1]
uqq-axis terminal voltage [pu] [1]

Connectors

NameDescription
p 
SPEEDMachine speed deviation from nominal [pu]
PMECH0Initial value of machine electrical power (machine base)
ETERMMachine terminal voltage [pu]
EFD0Initial generator main field voltage [pu]
PELECMachine electrical power (machine base)
ISORCEMachine source current [pu]
ANGLEMachine relative rotor angle
QELECMachine electrical power (machine base)
Initialization
PMECHTurbine mechanical power (machine base)
EFDGenerator main field voltage [pu]
XADIFDMachine field current [pu]

OpenIPSL.Electrical.Machines.PSSE.GENTPJ OpenIPSL.Electrical.Machines.PSSE.GENTPJ

WECC Type J GENERATOR: ROUND ROTOR WITH SATURATION ON BOTH AXES.

Information

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).

Parameters

NameDescription
Power flow data
S_bSystem base power [V.A]
V_bBase voltage of the bus [V]
fnSystem frequency [Hz]
P_0Initial active power [W]
Q_0Initial reactive power [var]
v_0Initial voltage magnitude [1]
angle_0Initial voltage angle [rad]
displayPFDisplay power flow:
Machine parameters
M_bMachine base power [V.A]
Tpd0d-axis transient open-circuit time constant [s]
Tppd0d-axis sub-transient open-circuit time constant [s]
Tppq0q-axis sub-transient open-circuit time constant [s]
HInertia constant [s]
DSpeed damping
Xdd-axis reactance [1]
Xqq-axis reactance [1]
Xpdd-axis transient reactance [1]
Xppdd-axis sub-transient reactance [1]
Xppqq-axis sub-transient reactance [1]
Xlleakage reactance [1]
S10Saturation factor at 1.0 pu [1]
S12Saturation factor at 1.2 pu [1]
R_aArmature resistance [1]
Xpqq-axis transient reactance [1]
Tpq0q-axis transient open-circuit time constant [s]
KisCurrent multiplier for saturation calculation [1]
Initialization
w0Initial speed deviation from nominal [1]
XADIFDMachine field current [pu]
deltaRotor angle [rad]
TeElectrical torque [pu] [1]
idd-axis armature current [pu] [1]
iqq-axis armature current [pu] [1]
udd-axis terminal voltage [pu] [1]
uqq-axis terminal voltage [pu] [1]

Connectors

NameDescription
p 
SPEEDMachine speed deviation from nominal [pu]
PMECHTurbine mechanical power (machine base)
PMECH0Initial value of machine electrical power (machine base)
ETERMMachine terminal voltage [pu]
EFDGenerator main field voltage [pu]
EFD0Initial generator main field voltage [pu]
PELECMachine electrical power (machine base)
ISORCEMachine source current [pu]
ANGLEMachine relative rotor angle
QELECMachine electrical power (machine base)
Initialization
XADIFDMachine field current [pu]
Automatically generated Thu Feb 26 06:56:10 2026.