Basic Exciters
The simplest excitation models: a constant field voltage, a first-order regulator, and the regulator of the Kundur two-area system. CONSTANT and 1ST_ORDER are built in and written in uppercase with no prefix; kundur is registered, and RAMSES adds the exc_ prefix automatically.
The EXC sub-record these models are entered with, and the table of IEEE model variants, are on the Exciter Models page.
CONSTANT (exc_constant)
Section titled “CONSTANT (exc_constant)”The data-file model name is CONSTANT.
Scientific Description
Section titled “Scientific Description”The exc_constant model provides a constant field voltage source. The field voltage is fixed at its load-flow initialisation value and does not respond to any input:
The single algebraic state satisfies:
This model is useful for open-loop tests, for machines that are not equipped with a voltage regulator, or as a placeholder during model development.
Implementation details (from Fortran source):
nbxvar = 1,nbzvar = 0,nbdata = 0- One additional parameter:
prm(1) = Vf0(set at initialisation from the load-flow field voltage) - Observables:
vf,if
Parameters
Section titled “Parameters”| Parameter | Description |
|---|---|
| (none) | No user-supplied data parameters. The field voltage is taken from the initialisation (load-flow) value automatically. |
Usage Example
Section titled “Usage Example”Show the data record
SYNC_MACH GEN1 BUS1 # FP FQ P Q: share of the power-flow injection (FP, FQ) or initial power (P in MW, Q in Mvar) 1. 1. 0. 0. # SNOM: Nominal apparent power, used as base power in the machine model (MVA) 600. # Pnom: Nominal active power of the turbine, used as base power for the turbine model (MW) 570. # H: Inertia constant (s) 3. # D: Damping coefficient (usually set to zero when the damper windings are modelled) (pu) 0. # IBRATIO: Field current base ratio I_fB^mac/I_fB^exc (see above) (pu) 0.95 # TYPE_MOD: Parameter format keyword: RL or XT (case-insensitive) XT # Xl: Leakage reactance L_l (pu) 0.15 # Xd: d-axis synchronous reactance (pu) 1.1 # X'd: d-axis transient reactance (must be smaller than Xd) (pu) 0.25 # X"d: d-axis subtransient reactance (pu) 0.2 # Xq: q-axis synchronous reactance (pu) 0.7 # X'q: q-axis transient reactance (pu) * # X"q: q-axis subtransient reactance (pu) 0.2 # m: Saturation coefficient (set to 0 to neglect saturation) 0.1 # n: Saturation exponent (ignored when m = 0) 6.0257 # Ra: Armature resistance (pu) 0. # T'do: d-axis open-circuit transient time constant (s) 5.00 # T"do: d-axis open-circuit subtransient time constant (s) 0.05 # T'qo: q-axis open-circuit transient time constant (s) * # T"qo: q-axis open-circuit subtransient time constant (s) 0.1EXC CONSTANTTOR CONSTANT;- No parameters need to be supplied; the model self-initialises to the load-flow value.
- Useful for simulation of machines operating in manual excitation mode.
- The model name in the data file is
CONSTANT(notexc_constant).
1ST_ORDER (exc_1storder)
Section titled “1ST_ORDER (exc_1storder)”The data-file model name is 1ST_ORDER (uppercase, with the underscore).
Scientific Description
Section titled “Scientific Description”The exc_1storder model is a first-order automatic voltage regulator (AVR). It represents the simplest dynamic exciter: a proportional gain acting on the terminal voltage error, filtered through a single first-order lag , with output limits.
The AVR computes the voltage error and drives the field voltage:
The reference voltage is initialised from:
Implementation details (from Fortran source):
nbxvar = 1,nbzvar = 1,nbdata = 4- Parameters:
prm(1) = KA,prm(2) = TA,prm(3) = Vfmin,prm(4) = Vfmax - Additional parameter:
prm(5) = V0(voltage setpoint, computed at initialisation) - The ODE in the continuous mode is:
- With anti-windup: if the limiter is active,
f(1) = Vf - Vfmin(orVfmax).
Parameters
Section titled “Parameters”| Parameter | Description |
|---|---|
KA | AVR gain (pu/pu) |
TA | AVR time constant (s) |
Vfmin | Minimum field voltage (pu) |
Vfmax | Maximum field voltage (pu) |
Usage Example
Section titled “Usage Example”Show the data record
SYNC_MACH GEN1 BUS1 # FP FQ P Q: share of the power-flow injection (FP, FQ) or initial power (P in MW, Q in Mvar) 1. 1. 0. 0. # SNOM: Nominal apparent power, used as base power in the machine model (MVA) 600. # Pnom: Nominal active power of the turbine, used as base power for the turbine model (MW) 570. # H: Inertia constant (s) 3. # D: Damping coefficient (usually set to zero when the damper windings are modelled) (pu) 0. # IBRATIO: Field current base ratio I_fB^mac/I_fB^exc (see above) (pu) 0.95 # TYPE_MOD: Parameter format keyword: RL or XT (case-insensitive) XT # Xl: Leakage reactance L_l (pu) 0.15 # Xd: d-axis synchronous reactance (pu) 1.1 # X'd: d-axis transient reactance (must be smaller than Xd) (pu) 0.25 # X"d: d-axis subtransient reactance (pu) 0.2 # Xq: q-axis synchronous reactance (pu) 0.7 # X'q: q-axis transient reactance (pu) * # X"q: q-axis subtransient reactance (pu) 0.2 # m: Saturation coefficient (set to 0 to neglect saturation) 0.1 # n: Saturation exponent (ignored when m = 0) 6.0257 # Ra: Armature resistance (pu) 0. # T'do: d-axis open-circuit transient time constant (s) 5.00 # T"do: d-axis open-circuit subtransient time constant (s) 0.05 # T'qo: q-axis open-circuit transient time constant (s) * # T"qo: q-axis open-circuit subtransient time constant (s) 0.1EXC 1ST_ORDER # KA: AVR gain (pu/pu) 200.0 # TA: AVR time constant (s) 0.05 # Vfmin: Minimum field voltage (pu) 0.0 # Vfmax: Maximum field voltage (pu) 6.0TOR CONSTANT;- This model is the Fortran-coded equivalent of a simple
tf1plimblock with input . KAandTAtogether set the closed-loop bandwidth.- The model name in the data file is
1ST_ORDER(uppercase, with the underscore).
kundur (exc_kundur)
Section titled “kundur (exc_kundur)”The data-file model name is kundur or exc_kundur. The exc_ prefix is added automatically.
Scientific Description
Section titled “Scientific Description”The exc_kundur model implements the excitation system from Kundur’s textbook (Power System Stability and Control, 1994). It includes a first-order voltage transducer, a proportional AVR with transient gain reduction (TGR), and a two-stage PSS acting on rotor speed deviation.
Voltage transducer:
AVR with transient gain reduction (lead–lag):
where is computed at initialisation and is the PSS output.
PSS (two-stage lead–lag with washout):
This is the standard two-stage phase-compensating PSS structure. The CODEGEN blocks in the .txt file are:
| Block | CODEGEN type | Function |
|---|---|---|
| Voltage filter | tf1p | |
| Main summing junction | algeq | |
| AVR (TGR) | tf1p1z | |
| PSS washout | tfder1p | |
| PSS lead–lag 1 | tf1p1z | |
| PSS lead–lag 2 | tf1p1z |
Parameters
Section titled “Parameters”| Parameter | Description |
|---|---|
TR | Voltage measurement filter time constant (s) |
KA | AVR gain (pu/pu) |
TA | TGR lead time constant (s) |
TB | TGR lag time constant (s) |
KSTAB | PSS gain |
TW | PSS washout time constant (s) |
T1 | PSS first lead–lag zero time constant (s) |
T2 | PSS first lead–lag pole time constant (s) |
T3 | PSS second lead–lag zero time constant (s) |
T4 | PSS second lead–lag pole time constant (s) |
Computed at initialisation: Vref = V + Vf / KA
Usage Example
Section titled “Usage Example”Show the data record
SYNC_MACH GEN1 BUS1 # FP FQ P Q: share of the power-flow injection (FP, FQ) or initial power (P in MW, Q in Mvar) 1. 1. 0. 0. # SNOM: Nominal apparent power, used as base power in the machine model (MVA) 600. # Pnom: Nominal active power of the turbine, used as base power for the turbine model (MW) 570. # H: Inertia constant (s) 3. # D: Damping coefficient (usually set to zero when the damper windings are modelled) (pu) 0. # IBRATIO: Field current base ratio I_fB^mac/I_fB^exc (see above) (pu) 0.95 # TYPE_MOD: Parameter format keyword: RL or XT (case-insensitive) XT # Xl: Leakage reactance L_l (pu) 0.15 # Xd: d-axis synchronous reactance (pu) 1.1 # X'd: d-axis transient reactance (must be smaller than Xd) (pu) 0.25 # X"d: d-axis subtransient reactance (pu) 0.2 # Xq: q-axis synchronous reactance (pu) 0.7 # X'q: q-axis transient reactance (pu) * # X"q: q-axis subtransient reactance (pu) 0.2 # m: Saturation coefficient (set to 0 to neglect saturation) 0.1 # n: Saturation exponent (ignored when m = 0) 6.0257 # Ra: Armature resistance (pu) 0. # T'do: d-axis open-circuit transient time constant (s) 5.00 # T"do: d-axis open-circuit subtransient time constant (s) 0.05 # T'qo: q-axis open-circuit transient time constant (s) * # T"qo: q-axis open-circuit subtransient time constant (s) 0.1EXC kundur # TR: Voltage measurement time constant (s) 0.02 # KA: AVR gain (pu/pu) 200.0 # TA: Transient gain reduction lead time constant (s) 0.02 # TB: Transient gain reduction lag time constant (s) 10.0 # KSTAB: PSS gain (pu/pu) 9.5 # TW: PSS washout time constant (s) 1.41 # T1: PSS first lead-lag numerator time constant (s) 0.154 # T2: PSS first lead-lag denominator time constant (s) 0.033 # T3: PSS second lead-lag numerator time constant (s) 0.154 # T4: PSS second lead-lag denominator time constant (s) 0.033TOR CONSTANT;- Parameters match the Example 12.6 from Kundur (1994), applicable to a medium-speed generator.
- The PSS stabilises local modes in the 0.5–2 Hz range.
- No output limiter is defined in the base model; add clipping externally if required.
- The model name in the data file is
kundur(notexc_kundur).