> 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-x1.md).

# IEEE X1

## Description

The **IEEEX1** block, located in the **Control Exciters** library, is based on the IEEE Std. 412.5 type IEEEX1 excitation system model. It includes the transducer, transient filter, voltage regulator, exciter, and damping feedback to maintain voltage stability under varying conditions, and is intended for power system stability studies.

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

## Mask parameters

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

<table><thead><tr><th width="200.20001220703125">Parameter</th><th>Description</th></tr></thead><tbody><tr><td><strong>Tr</strong></td><td>Transducer time constant (lag), (s).</td></tr><tr><td><strong>Tb</strong></td><td>Transient filter time constant (lag), (s).</td></tr><tr><td><strong>Tc</strong></td><td>Transient filter time constant (lead), (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 (lag), (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>Te</strong></td><td>Exciter time constant (lag), (s).</td></tr><tr><td><strong>Ke</strong></td><td>Linear gain of exciter feedback.</td></tr><tr><td><strong>Efd1</strong></td><td>Field voltage at the first breakpoint, (pu).</td></tr><tr><td><strong>Se1</strong></td><td>Gain at the first breakpoint.</td></tr><tr><td><strong>Efd2</strong></td><td>Field voltage at the second breakpoint, (pu).</td></tr><tr><td><strong>Se2</strong></td><td>Gain at the second breakpoint.</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 (lag), (s).</td></tr></tbody></table>
{% endtab %}

{% tab title="Initial values" %}

<table><thead><tr><th width="200.20001220703125">Parameter</th><th>Description</th></tr></thead><tbody><tr><td><strong>Efd0</strong></td><td>Exciter output voltage initial value, (pu).</td></tr></tbody></table>

{% hint style="info" %}
Efd0 can be set by entering a numerical value, or set to “=SM1.EFD\_Init” when a pu standard or pu fundamental machine is used.
{% endhint %}
{% endtab %}
{% endtabs %}

Se(Efd) is computed with a piecewise linear function:

<p align="center"><span class="math">if (E_{fd} &#x3C; E_{fd1}), S_e = \frac{S_{e1}}{E_{fd1}} * E_{fd}</span></p>

$$
if (E\_{fd} > E\_{fd1}), S\_e = S\_{e1} + \frac{S\_{e2}-S\_{e1}}{E\_{fd2}-E\_{fd1}} \*( E\_{fd}-E\_{fd1} )
$$

## Inputs

<table><thead><tr><th width="200.4000244140625">Input</th><th>Description</th></tr></thead><tbody><tr><td><strong>E</strong><sub><strong>C</strong></sub></td><td>Output of terminal voltage transducer and load compensation elements, (pu).</td></tr><tr><td><strong>V</strong><sub><strong>UEL</strong></sub></td><td>Under-excitation limiter output, (pu).</td></tr><tr><td><strong>V</strong><sub><strong>OEL</strong></sub></td><td>Overexcitation limiter output, (pu).</td></tr><tr><td><strong>V</strong><sub><strong>othsg</strong></sub></td><td>Stabilizer output, (pu).</td></tr><tr><td><strong>V</strong><sub><strong>REF</strong></sub></td><td>Voltage regulator reference voltage, (pu).</td></tr></tbody></table>

## 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

Computer representation of excitation systems, IEEE Transactions on Power Apparatus and Systems ( Volume: PAS-87, Issue: 6, June 1968)


---

# 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-x1.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.
