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

# IEEE AC7B

## Description

The **AC7B** block, located in the **Control Exciters** library, is an implementation of the IEEE Std. 412.5 type AC7B excitation system model. It is implemented as described in and developed in line with references.

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

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

<table><thead><tr><th width="200.20001220703125">Parameter</th><th>Description</th></tr></thead><tbody><tr><td><strong>K</strong><sub><strong>PA</strong></sub></td><td>Field current regulator proportional gain (pu).</td></tr><tr><td><strong>K</strong><sub><strong>IA</strong></sub></td><td>Field current regulator integral gain (pu/s).</td></tr><tr><td><strong>V</strong><sub><strong>Amax</strong></sub></td><td>Maximum field current regulator output (pu).</td></tr><tr><td><strong>V</strong><sub><strong>Amin</strong></sub></td><td>Minimum field current regulator output (pu).</td></tr><tr><td><strong>K</strong><sub><strong>PR</strong></sub></td><td>Voltage regulator proportional gain (s).</td></tr><tr><td><strong>K</strong><sub><strong>IR</strong></sub></td><td>Voltage regulator integral gain (pu/s).</td></tr><tr><td><strong>K</strong><sub><strong>DR</strong></sub></td><td>Voltage regulator derivative gain (pu/s).</td></tr><tr><td><strong>T</strong><sub><strong>DR</strong></sub></td><td>Lag time constant for the derivative channel of the PID controller (s).</td></tr><tr><td><strong>V</strong><sub><strong>Rmax</strong></sub></td><td>Maximum regulator output (pu).</td></tr><tr><td><strong>V</strong><sub><strong>Rmin</strong></sub></td><td>Minimum regulator output (pu).</td></tr><tr><td><strong>K</strong><sub><strong>p</strong></sub></td><td>Potential circuit gain coefficient (pu).</td></tr><tr><td><strong>K</strong><sub><strong>L</strong></sub></td><td>Gain related to negative exciter field current capability (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>K</strong><sub><strong>E</strong></sub></td><td>Exciter gain (pu).</td></tr><tr><td><strong>T</strong><sub><strong>E</strong></sub></td><td>Exciter time constant (s).</td></tr><tr><td><strong>K</strong><sub><strong>F1</strong></sub></td><td>Excitation control system stabilizer gain (pu).</td></tr><tr><td><strong>K</strong><sub><strong>F2</strong></sub></td><td>Excitation control system stabilizer gain (pu).</td></tr><tr><td><strong>K</strong><sub><strong>F3</strong></sub></td><td>Excitation control system stabilizer gain (pu).</td></tr><tr><td><strong>T</strong><sub><strong>F</strong></sub></td><td>Excitation control system stabilizer time constant (s).</td></tr><tr><td><strong>V</strong><sub><strong>FEMAX</strong></sub></td><td>Exciter field current limit (pu).</td></tr><tr><td><strong>V</strong><sub><strong>FEMIN</strong></sub></td><td>Minimum exciter voltage back of commutating reactance (pu).</td></tr><tr><td><strong>K</strong><sub><strong>D</strong></sub></td><td>Demagnetizing factor (pu).</td></tr><tr><td><strong>K</strong><sub><strong>C</strong></sub></td><td>Rectifier loading factor (pu).</td></tr><tr><td><strong>V</strong><sub><strong>E1</strong></sub></td><td>Exciter voltage near the exciter ceiling voltage (pu).</td></tr><tr><td><strong>V</strong><sub><strong>E2</strong></sub></td><td>Exciter voltage near 75% of VE1 (pu).</td></tr><tr><td><strong>SE_V</strong><sub><strong>E1</strong></sub></td><td>Exciter saturation function value at VE1 (pu).</td></tr><tr><td><strong>SE_V</strong><sub><strong>E2</strong></sub></td><td>Exciter saturation function value at VE2 (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-d3e279041a5eb58e612a37fdf07981a9d1e42d5f%2Fjfx414500699508382718.gif?alt=media" alt=""><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>Ifd0</strong></td><td>Initial field current. Can be set manually (numeric value) or automatically from load flow using a referenced synchronous machine variable.</td></tr><tr><td><strong>Efd0</strong></td><td>Initial field voltage. Can be set manually (numeric value) or automatically from load flow using a referenced synchronous machine variable.</td></tr></tbody></table>

{% hint style="info" %}
The parameters Ifd0 and Efd0 can be set manually or automatically based on load flow using a referenced synchronous machine variable. For example, if the synchronous machine name is “SM1”:

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

## Inputs

<table><thead><tr><th width="199.5999755859375">Input</th><th>Description</th></tr></thead><tbody><tr><td><strong>Vref</strong></td><td>Reference for the stator terminal voltage (pu).</td></tr><tr><td><strong>Vc1</strong></td><td>Terminal voltage transducer output (pu).</td></tr><tr><td><strong>Vs</strong></td><td>Power System Stabilizer signal (pu).</td></tr><tr><td><strong>Vt</strong></td><td>Synchronous machine terminal voltage (pu).</td></tr><tr><td><strong>Ifd</strong></td><td>Synchronous machine field current (pu).</td></tr><tr><td><strong>Vuel</strong></td><td>Under Excitation Limiter signal (pu).</td></tr></tbody></table>

If a Synchronous 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="200.4000244140625">Output</th><th>Description</th></tr></thead><tbody><tr><td><strong>Efd</strong></td><td>Field voltage signal (pu).</td></tr></tbody></table>

## References

* “IEEE Recommended Practice for Excitation System Models for Power System Models for Power System Stability Studies,” IEEE Standard 421.5-2005.
* Kundur, “Power System Stability and Control”, McGraw-Hill 1994
* Standard Dynamic Turbine-Governor Systems in NEPLAN Power System Analysis Tool
* PSSE Explore 34 Siemens software


---

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