> For the complete documentation index, see [llms.txt](https://www.opal-rt.com/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://www.opal-rt.com/docs/smart-power-simulation-software-sps/blocks-functions-tools/machines/blocks/machines-control/synchronous-machines-control/excitation-systems/excitation-system.md).

# Excitation System

## Description

<figure><img src="https://799605156-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FdlNg8IbOdahCpFCyzxSN%2Fuploads%2Fgit-blob-40f538f9a8612f4502df760e245246f6174a2a72%2Fexcitation_sys_block.png?alt=media" alt=""><figcaption></figcaption></figure>

The **Excitation System** block, located in the **OPAL-RT SPS Software/Blocks/Electrical Machines/ Synchronous Machine** library, provides excitation system for synchronous machine and regulate its terminal voltage in generating mode. The Excitation System block is a Simulink® system implementing a DC exciter described in \[1], without the exciter’s saturation function. The basic elements that form the Excitation System block are the voltage regulator and the exciter.

<figure><img src="https://799605156-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FdlNg8IbOdahCpFCyzxSN%2Fuploads%2Fgit-blob-212c1700de147d5b549eda0988b42176cbe82fa3%2Fexcitation_sys_model.png?alt=media" alt=""><figcaption></figcaption></figure>

The exciter is represented by the following transfer function between the exciter voltage Vfd and the regulator’s output ef:

$$
\frac{V\_{fd}}{ef}=\frac{1}{Ke+sTe}
$$

## Ports

### Input

<table data-header-hidden><thead><tr><th width="249.33331298828125"></th><th></th></tr></thead><tbody><tr><td><strong>vref</strong> — Stator terminal voltage<br>Scalar</td><td>Desired value, in pu, of the stator terminal voltage.</td></tr><tr><td><strong>vd</strong> — v<sub>d</sub> component of terminal voltage<br>Scalar</td><td>v<sub>d</sub> component, in pu, of the terminal voltage.</td></tr><tr><td><strong>vq</strong> — v<sub>q</sub> component of terminal voltage<br>Scalar</td><td>v<sub>q</sub> component, in pu, of the terminal voltage.</td></tr><tr><td><strong>vstab</strong> — Additional stabilization of power system oscillations<br>Scalar</td><td>Connect this input to a power system stabilizer to provide additional stabilization of power system oscillations.</td></tr></tbody></table>

### Output

<table data-header-hidden><thead><tr><th width="249.99993896484375"></th><th></th></tr></thead><tbody><tr><td><strong>Vf</strong> — Field voltage<br>Scalar</td><td>Field voltage, in pu, for the Synchronous Machine block.</td></tr></tbody></table>

## Parameters

To edit block parameters interactively, use the Property Inspector. From the Simulink Toolstrip, on the **Simulation** tab, in the **Prepare** gallery, select **Property Inspector**.

<table data-header-hidden><thead><tr><th width="250.4444580078125"></th><th></th></tr></thead><tbody><tr><td><strong>Low-pass filter time constant Tr(s):</strong> — Time constant Tr of first-order system<br>20e-3 (default)</td><td>Time constant Tr, in seconds (s), of the first-order system that represents the stator terminal voltage transducer.</td></tr><tr><td><strong>Regulator gain and time constant [ Ka() Ta(s) ]</strong> — Gain Ka and time constant Ta of first-order system<br>[ 300, 0.001 ] (default)</td><td>Gain Ka and time constant Ta, in seconds (s), of the first-order system representing the main regulator.</td></tr><tr><td><strong>Exciter [ Ke() Te(s) ]</strong> — Gain Ke and time constant Te of first-order system<br>[ 1, 0 ] (default)</td><td>Gain Ke and time constant Te, in seconds (s), of the first-order system representing the exciter.</td></tr><tr><td><strong>Transient gain reduction [ Tb(s) Tc(s) ]</strong> — Time constants Tb and Tc of first-order system<br>[ 0, 0 ] (default)</td><td>Time constants Tb, in seconds (s), and Tc, in seconds (s), of the first-order system representing a lead-lag compensator.</td></tr><tr><td><strong>Damping filter gain and time constant [ Kf() Tf(s) ]</strong> — Gain Kf and time constant Tf of first-order system<br>[ 0.001, 0.1 ] (default)</td><td>Gain Kf and time constant Tf, in seconds (s), of the first-order system representing a derivative feedback.</td></tr><tr><td><strong>Regulator output limits and gain [ Efmin, Efmax (pu), Kp() ]</strong> — Regulator output limits and gain<br>[ -11.5, 11.5, 0 ] (default)</td><td>Limits Efmin and Efmax are imposed on the output of the voltage regulator. The upper limit can be constant and equal to Efmax, or variable and equal to the rectified stator terminal voltage Vtf times a proportional gain Kp.<br>If Kp is set to 0, the former applies.<br>If Kp is set to a positive value, the latter applies.</td></tr><tr><td><strong>Initial values of terminal voltage and field voltage [ Vt0 (pu) Vf0(pu) ]</strong> — Initial values of terminal voltage and field voltage<br>[1.0 1.28] (default)</td><td>Initial values of terminal voltage Vt0 (pu) and field voltage Vf0 (pu). When set correctly, they allow you to start the simulation in steady state. Initial terminal voltage should normally be set to 1 pu. Both Vt0 and Vf0 values are automatically updated by the load flow utility of the Powergui block.</td></tr></tbody></table>

## Examples

[Synchronous Machine](https://www.opal-rt.com/docs/smart-power-simulation-software-sps/example-models/machines/synchronous-machine.md)

## References

\[1] “Recommended Practice for Excitation System Models for Power System Stability Studies,” *IEEE® Standard 421.5-1992,* August, 1992.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://www.opal-rt.com/docs/smart-power-simulation-software-sps/blocks-functions-tools/machines/blocks/machines-control/synchronous-machines-control/excitation-systems/excitation-system.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
