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

# IEEE T1

## Description

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

The **IEEET1** block, located in the **Control Exciters** library, implements the IEEE Std. 412.5 type IEET1 excitation system specified in the IEEE committee report "Computer representation of excitation systems" \[1]\[2].

<figure><img src="https://3623212549-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLxgTpoh7kyPmQ5vuyqD7%2Fuploads%2Fgit-blob-b7b5e0b4e6f6ea8894623d008eb36b47d6d57fdd%2Fimage%20(786).png?alt=media" alt="" width="563"><figcaption><p>IEET1 diagram</p></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

<figure><img src="https://3623212549-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLxgTpoh7kyPmQ5vuyqD7%2Fuploads%2Fgit-blob-221262234209e5157f00df0e2b9804d490d45729%2FIEET1.jpg?alt=media" alt=""><figcaption></figcaption></figure>

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

<table><thead><tr><th width="201">Parameter</th><th>Description</th></tr></thead><tbody><tr><td><strong>Tr</strong></td><td>Regulator input filter time constant (s). Range: 0 ≤ Tr &#x3C; 0.5</td></tr><tr><td><strong>Ka</strong></td><td>Voltage regulator gain. Range: 10 &#x3C; Ka &#x3C; 500</td></tr><tr><td><strong>Ta</strong></td><td>Regulator time constant (s). Range: 0 ≤ Ta &#x3C; 1</td></tr><tr><td><strong>Kf</strong></td><td>Excitation control system stabilizer gain. Range: 0 &#x3C; Kf &#x3C; 0.3</td></tr><tr><td><strong>Tf</strong></td><td>Excitation control system stabilizer time constant (s). Range: 0.04 &#x3C; Tf &#x3C; 1.5</td></tr><tr><td><strong>Vrmax</strong></td><td>Maximum voltage regulator output (pu). Range: 0.5 &#x3C; Vrmax &#x3C; 10</td></tr><tr><td><strong>Vrmin</strong></td><td>Minimum voltage regulator output (pu). Range: -10 &#x3C; Vrmin &#x3C; 0</td></tr></tbody></table>
{% endtab %}

{% tab title="Exciter" %}

<table><thead><tr><th width="200.199951171875">Parameter</th><th>Description</th></tr></thead><tbody><tr><td><strong>Te</strong></td><td>Exciter time constant (s). Range: 0.04 &#x3C; Te &#x3C; 1</td></tr><tr><td><strong>Ke</strong></td><td>Exciter constant related to self-excited field.<br>Range: -1 ≤ Ke ≤ 1</td></tr><tr><td><strong>Se1, Se2</strong></td><td>Exciter saturation factor at the corresponding Vex (pu).</td></tr><tr><td><strong>Efd1, Efd2</strong></td><td>Exciter voltage for the exciter saturation function (pu).</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-6cd9ca630c84978f65ba1027caf07281ac59f36d%2Fimage%20(788).png?alt=media" alt="" width="375"><figcaption><p>Exciter diagram</p></figcaption></figure>
{% endtab %}

{% tab title="Initial values" %}

<table><thead><tr><th width="200.199951171875">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" %}
The parameter Efd0 can be set manually by entering a numerical value. It can also be set automatically based on load flow calculations by entering a referenced synchronous machine variable.

For instance, if the name of the synchronous machine on which the excitation system is connected is “SM1”, then Efd0 shall be set as “=SM1.EfdInit” if a thermal machine or a hydraulic machine is used, and as "=SM1.EFD\_Init" if a pu standard or pu fundamental machine is used.
{% endhint %}
{% endtab %}
{% endtabs %}

## Inputs

<table><thead><tr><th width="200.39996337890625">Input</th><th>Description</th></tr></thead><tbody><tr><td><strong>Vc1</strong></td><td>Signal proportional to compensated terminal voltage (pu); see the load compensator block documentation. If the load compensator block is not used upstream from the exciter block, then Vc1 = Vt.</td></tr><tr><td><strong>Vref</strong></td><td>Voltage regulator reference voltage (pu).</td></tr><tr><td><strong>Vs</strong></td><td>Combined PSS and possibly discontinuous control output after any limits or switching, summed with terminal voltage and reference signals (pu).<br>For example, Voel and Vuel should be added to the signal before connecting to this input.</td></tr></tbody></table>

## Outputs

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

## References

1. C. Report, "Computer representation of excitation systems," IEEE Transactions on Power Apparatus and Systems,\_pp. 1460-1464, June 1968
2. PSS<sup>®</sup>E 34.2.0 Model Library. NY, USA: Siemens Industry, Inc., 2017.


---

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