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

# IEEE T3

## Description

The **IEEET3** block, located in the **Control Exciters** library, implements the IEEE Std. 412.5 type 3 excitation system described in the IEEE committee report “Computer representation of excitation systems” \[1]\[2]. The IEEET3 uses the generator terminal current and potential as the excitation source \[1].

<figure><img src="https://3623212549-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLxgTpoh7kyPmQ5vuyqD7%2Fuploads%2Fgit-blob-3cd18b402aa77dbc64e2177e913a3723840a96d1%2Fimage%20(783).png?alt=media" alt=""><figcaption><p>IEEET3 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-9dc333bd86a3ee6d7d89477acd3bf9d92f055de6%2FIEEET3.png?alt=media" alt=""><figcaption></figcaption></figure>

{% 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>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>Kf</strong></td><td>Excitation control system stabilizer gain.</td></tr><tr><td><strong>Tf</strong></td><td>Excitation control system stabilizer time constant 1 (Tf1); Tf1 >= 0.001 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></tbody></table>
{% endtab %}

{% tab title="Exciter" %}

<table><thead><tr><th width="200.20001220703125">Parameter</th><th>Description</th></tr></thead><tbody><tr><td><strong>Te</strong></td><td>Exciter time constant (s); Te >= 0.04 s.</td></tr><tr><td><strong>Ke</strong></td><td>Exciter constant related to self-excited field.</td></tr><tr><td><strong>Kp</strong></td><td>Potential circuit gain coefficient proportional to voltage.</td></tr><tr><td><strong>Ki</strong></td><td>Potential circuit gain coefficient proportional to current.</td></tr><tr><td><strong>Vbmax</strong></td><td>Maximum field voltage (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-693b472c589e3420adb50855e468c8eb9e48697f%2Fimage%20(782).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>Efd0</strong></td><td>Exciter output voltage initial value (pu).</td></tr><tr><td><strong>Ifd0</strong></td><td>Initial field current (pu).</td></tr></tbody></table>

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

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

## Inputs

<table><thead><tr><th width="199.60003662109375">Input</th><th>Description</th></tr></thead><tbody><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>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 (pu).</td></tr><tr><td><strong>Vd</strong></td><td>Active component of generator terminal voltage, or component from load compensator (pu).</td></tr><tr><td><strong>Vq</strong></td><td>Reactive component of generator terminal voltage, or component from load compensator (pu).</td></tr><tr><td><strong>Vuel</strong></td><td>Under-excitation limiter output (pu).</td></tr><tr><td><strong>Voel</strong></td><td>Over-excitation limiter output (pu).</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 Synch. Machine (Hydraulic or Thermal) from the Network Machines and Generators library is used, the machine observable Ifd must be multiplied by the synchronous machine parameter Xad = Xd – Xl before its input to the exciter. This multiplication is not needed if a Synchronous Machine (pu Standard) or (pu Fundamental) is used.

## Outputs

<table><thead><tr><th width="199.5999755859375">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-t3.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.
