modelGENCLS

Classic generator model that can also represent an infinite bus

Extends from OpenRESV.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
OpenRESV.Types.ApparentPowerS_b (from pfComponent)SysData.S_bSystem base power
OpenRESV.Types.VoltageV_b (from pfComponent)400e3Base voltage of the bus
OpenRESV.Types.Frequencyfn (from pfComponent)SysData.fnSystem frequency
OpenRESV.Types.ActivePowerP_0 (from pfComponent)1e6Initial active power
OpenRESV.Types.ReactivePowerQ_0 (from pfComponent)0Initial reactive power
OpenRESV.Types.PerUnitv_0 (from pfComponent)1Initial voltage magnitude
OpenRESV.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
OpenRESV.Types.ApparentPowerM_b100e6Machine base power rating
OpenRESV.Types.TimeH0Inertia constant
RealD0Damping coefficient
OpenRESV.Types.PerUnitR_a0Armature resistance
OpenRESV.Types.PerUnitX_d0.2d-axis transient reactance

Connectors

TypeNameDefaultDescription
OpenRESV.Interfaces.PwPinp

Components

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