modelGENCLS

Classic generator model that can also represent an infinite bus
Diagram of GENCLS

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:

  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.

Parameters

TypeNameDefaultDescription
Power flow data
Types.ApparentPowerS_b (from pfComponent)SysData.S_bSystem base power
Types.VoltageV_b (from pfComponent)400e3Base voltage of the bus
Types.Frequencyfn (from pfComponent)SysData.fnSystem frequency
Types.ActivePowerP_0 (from pfComponent)1e6Initial active power
Types.ReactivePowerQ_0 (from pfComponent)0Initial reactive power
Types.PerUnitv_0 (from pfComponent)1Initial voltage magnitude
Types.Angleangle_0 (from pfComponent)0Initial voltage angle
BooleandisplayPF (from pfComponent)falseDisplay power flow:
Parameter mask
BooleanenableS_b (from pfComponent)falseEnable S_b in parameter list
BooleanenableV_b (from pfComponent)falseEnable V_b in parameter list
Booleanenablefn (from pfComponent)falseEnable fn in parameter list
BooleanenableP_0 (from pfComponent)falseEnable P_0 in parameter list
BooleanenableQ_0 (from pfComponent)falseEnable Q_0 in parameter list
Booleanenablev_0 (from pfComponent)falseEnable v_0 in parameter list
Booleanenableangle_0 (from pfComponent)falseEnable angle_0 in parameter list
BooleanenabledisplayPF (from pfComponent)falseEnable displayPF in parameter list
Machine parameters
Types.ApparentPowerM_b100e6Machine base power rating
Types.TimeH0Inertia constant
RealD0Damping coefficient
Types.PerUnitR_a0Armature resistance
Types.PerUnitX_d0.2d-axis transient reactance

Connectors

TypeNameDefaultDescription
OpenIPSL.Interfaces.PwPinp

Components

TypeNameDefaultDescription
OpenIPSL.Electrical.SystemBaseSysData (from pfComponent)Must add this line in all models
Types.AngledeltaRotor angle
Types.PerUnitomegaRotor speed
Types.PerUnitVBus voltage magnitude
Types.AngleanglevBus voltage angle
Types.PerUniteqConstant emf behind transient reactance
Types.PerUnitvdd-axis voltage
Types.PerUnitvqq-axis voltage
Types.PerUnitidd-axis current
Types.PerUnitiqq-axis current
Types.PerUnitPActive power (system base)
Types.PerUnitQReactive 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

see UsersGuide.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.