> 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/hypersim/library-blocks-reference/control-exciters/ieee-st2a.md).

# IEEE ST2A

## Description

<figure><img src="https://3623212549-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLxgTpoh7kyPmQ5vuyqD7%2Fuploads%2Fgit-blob-8e1ca5c2e9e33eecf1c9c1bc9c9e9f1856498881%2Fimage%20(855).png?alt=media" alt=""><figcaption></figcaption></figure>

The **ST2A excitation system** block, located in the **Control Exciters** library, is based on the IEEE Std. 412.5 type ST2A model. It uses both terminal current and terminal voltage. The model accounts for commutation and rectifier loading effects.

<figure><img src="https://3623212549-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLxgTpoh7kyPmQ5vuyqD7%2Fuploads%2Fgit-blob-ea33eab92986d8524aa567fcbf6c9edbd012cdc0%2Fimage%20(784).png?alt=media" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
The HYPERSIM<sup>®</sup> simulation option Set Initial Conditions must be checked for the automatic initialization to work properly.
{% endhint %}

## Mask parameters

{% tabs %}
{% tab title="AVR" %}

<table><thead><tr><th width="200.20001220703125">Parameter</th><th>Description</th></tr></thead><tbody><tr><td><strong>Tr</strong></td><td>Regulator input filter time constant (s)</td></tr><tr><td><strong>Kf</strong></td><td>Excitation control system stabilizer gain</td></tr><tr><td><strong>Tf</strong></td><td>Excitation control system stabilizer time constant (s)</td></tr><tr><td><strong>Ka</strong></td><td>Voltage regulator gain</td></tr><tr><td><strong>Ta</strong></td><td>Regulator time constant (s)</td></tr><tr><td><strong>Vrmax</strong></td><td>Maximum voltage regulator output (pu)</td></tr><tr><td><strong>Vrmin</strong></td><td>Minimum voltage regulator output (pu)</td></tr><tr><td><strong>UEL input location</strong></td><td>Two options : at the summation point (voltage error) or as take-over at the voltage regulator input.</td></tr></tbody></table>
{% endtab %}

{% tab title="Exciter" %}

<table><thead><tr><th width="201">Parameter</th><th>Description</th></tr></thead><tbody><tr><td><strong>Te</strong></td><td>Exciter time constant (s)</td></tr><tr><td><strong>Ke</strong></td><td>Exciter constant related to self-excited field</td></tr><tr><td><strong>Kc</strong></td><td>Rectifier loading factor proportional to commutating reactance</td></tr><tr><td><strong>EFDmax</strong></td><td>Maximum exciter output voltage (pu)</td></tr><tr><td><strong>Kp</strong></td><td>Potential circuit real part gain coefficient</td></tr><tr><td><strong>Kj</strong></td><td>Potential circuit imaginary part gain coefficient</td></tr></tbody></table>

<figure><img src="https://3623212549-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLxgTpoh7kyPmQ5vuyqD7%2Fuploads%2Fgit-blob-62e846e520032c350672b2722a0166837b5375d3%2Fimage%20(785).png?alt=media" alt=""><figcaption><p>Exciter diagram</p></figcaption></figure>
{% endtab %}

{% tab title="Initial values" %}

<table><thead><tr><th width="200.20001220703125">Parameter</th><th>Description</th></tr></thead><tbody><tr><td><strong>Ifd0</strong></td><td>Synchronous machine field current initial value (pu)</td></tr><tr><td><strong>Efd0</strong></td><td>Exciter output voltage initial value (pu)</td></tr></tbody></table>

{% hint style="info" %}
Ifd0 and Efd0 can be set manually by entering numerical values. They can also be set automatically from load flow calculations by referencing the synchronous machine variables. For example, if the machine name is “SM1”:

* For a thermal or hydraulic machine: set Ifd0 to “=SM1.IfdInit” multiplied by Xad = Xd – Xl, and set Efd0 to “=SM1.EfdInit”.
* For a pu standard or pu fundamental machine: set Ifd0 to “=SM1.IF\_Init” and Efd0 to “=SM1.EFD\_Init”.
  {% endhint %}
  {% endtab %}
  {% endtabs %}

## Inputs

<table><thead><tr><th width="201.20001220703125">Input</th><th>Description</th></tr></thead><tbody><tr><td><strong>Voel</strong></td><td>Over-excitation limiter output (pu)</td></tr><tr><td><strong>Vc1</strong></td><td>Signal proportional to compensated terminal voltage. If the Load Compensator block is not used upstream from the exciter block, Vc1 equals Vt (main alternator terminal voltage) (pu).</td></tr><tr><td><strong>Vuel</strong></td><td>Under-excitation limiter output (pu)</td></tr><tr><td><strong>Vref</strong></td><td>Voltage regulator reference voltage (pu)</td></tr><tr><td><strong>Vs</strong></td><td>Output voltage of a Power System Stabilizer (PSS) (pu)</td></tr><tr><td><strong>Ifd</strong></td><td>Synchronous machine field current (pu)</td></tr><tr><td><strong>Id</strong></td><td>Active component of generator terminal current or component from load compensator (pu)</td></tr><tr><td><strong>Iq</strong></td><td>Reactive component of generator terminal current or component from load compensator</td></tr><tr><td><strong>Vd</strong></td><td>Active component of generator terminal voltage or component from load compensator</td></tr><tr><td><strong>Vq</strong></td><td>Reactive component of generator terminal voltage or component from load compensator</td></tr></tbody></table>

{% hint style="danger" %}
**Vuel** and **Voel** are normally inputs for this excitation system. You can choose fixed constant values directly in the mask by selecting the “internal” option.
{% endhint %}

If a synchronous machine (Hydraulic or Thermal) from the Network Machines and Generators library is used, multiply the machine observable Ifd by Xad = Xd – Xl before connecting it to the exciter. This multiplication is not needed for a Synchronous Machine (pu Standard) or (pu Fundamental).

## Outputs

<table><thead><tr><th width="200.4000244140625">Output</th><th>Description</th></tr></thead><tbody><tr><td><strong>Efd</strong></td><td>Exciter output voltage (pu)</td></tr></tbody></table>

## References

“IEEE Recommended Practice for Excitation System Models for Power System Models forPower System Stability Studies,” IEEE Standard 421.5-2005.


---

# 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/hypersim/library-blocks-reference/control-exciters/ieee-st2a.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.
