OpenIPSL.Electrical.Machines.PSSE

Machine models from PSSE

Information

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

Package Content

Name	Description
Plant	Framework for an electrical plant including controllers
GENCLS	Classic generator model that can also represent an infinite bus
GENROE	ROUND ROTOR GENERATOR MODEL (EXPONENTIAL SATURATION)
GENROU	ROUND ROTOR GENERATOR MODEL (QUADRATIC SATURATION)
GENSAE	SALIENT POLE GENERATOR MODEL (EXPONENTIAL SATURATION)
GENSAL	SALIENT POLE GENERATOR MODEL (QUADRATIC SATURATION ON D-AXIS)
BaseClasses	Base classes for base machines from PSSE

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:

Generator
Excitation System
Turbine Governor
Power System Stabiliser

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

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:

Connectors

Name	Description
pwPin

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:

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.

Applications

H=0: Infinite bus
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.
H>>0: Can be used to model the connection to a "stiff grid".

Parameters

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

Connectors

Name	Description
p

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

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]

Connectors

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

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

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]

Connectors

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

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

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]

Connectors

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

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

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]

Connectors

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

Automatically generated Mon Oct 10 14:35:56 2022.