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

# IEEE VC

## Description

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

The **IEEEVC compensator** block, located in the **Control Exciters** library, is developed in line with references \[1] \[2]. IEEEVC simulates an impedance and allows the machine voltage regulator to sense a calculated voltage at a point other than the machine terminals \[1]. The model also calculates the compensated reference voltage for the exciter based on the impedance parameters Rc, Xc, and the desired machine terminal voltage.

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

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

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

<table><thead><tr><th width="200.4000244140625">Parameter</th><th>Description</th></tr></thead><tbody><tr><td><strong>Rc</strong></td><td>Resistance of the simulated impedance (pu), on machine base.</td></tr><tr><td><strong>Xc</strong></td><td>Reactance of the simulated impedance (pu), on machine base.</td></tr><tr><td><strong>Synchronous machine type</strong></td><td>The type of the synchronous machine: two options<br>pu standard=0; thermal or hydraulic=1.</td></tr></tbody></table>
{% endtab %}

{% tab title="Synchronous machine type" %}

<table><thead><tr><th width="200.4000244140625">Parameter</th><th>Description</th></tr></thead><tbody><tr><td><strong>Vt_real</strong></td><td>Machine terminal voltage real part from the load flow solution =SM.Vpos_real (pu).</td></tr><tr><td><strong>Vt_imag</strong></td><td>Machine terminal voltage imaginary part from the load flow solution =SM.Vpos_imag (pu).</td></tr><tr><td><strong>It_real</strong></td><td>Machine terminal current real part from the load flow solution =SM.Ipos_real (pu).</td></tr><tr><td><strong>It_imag</strong></td><td>Machine terminal current imaginary part from the load flow solution =SM.Ipos_imag (pu).</td></tr></tbody></table>
{% endtab %}

{% tab title="thermal or hydraulic machine" %}

<table><thead><tr><th width="200.4000244140625">Parameter</th><th>Description</th></tr></thead><tbody><tr><td><strong>P</strong></td><td>Machine active power output =SM.Peo (W).</td></tr><tr><td><strong>Q</strong></td><td>Machine reactive power output =SM.Qeo (Var).</td></tr><tr><td><strong>Sbase</strong></td><td>Machine electrical power base =SM.baseMVA (MVA).</td></tr><tr><td><strong>Vbase</strong></td><td>Machine voltage base =SM.baseVolt (kV).</td></tr><tr><td><strong>Itpeak</strong></td><td>Machine terminal voltage peak value from the load flow solution =SM.IInit_mag (A).</td></tr></tbody></table>
{% endtab %}
{% endtabs %}

## Inputs

<table><thead><tr><th width="198.79998779296875">Input</th><th>Description</th></tr></thead><tbody><tr><td><strong>Vd</strong></td><td>Generator d-axis terminal voltage (pu).</td></tr><tr><td><strong>Vq</strong></td><td>Generator q-axis terminal voltage (pu).</td></tr><tr><td><strong>Id</strong></td><td>Generator d-axis terminal current (pu).</td></tr><tr><td><strong>Iq</strong></td><td>Generator q-axis terminal current (pu).</td></tr><tr><td><strong>Vref</strong></td><td>Reference value for the machine terminal voltage (pu).</td></tr></tbody></table>

## Outputs

<table><thead><tr><th width="198.79998779296875">Output</th><th>Description</th></tr></thead><tbody><tr><td><strong>Vc1</strong></td><td>Compensated terminal voltage (pu).</td></tr><tr><td><strong>Vrefc</strong></td><td>Calculated reference voltage for the exciter considering the compensation (pu).</td></tr></tbody></table>

Vrefc is computed from Rc, Xc, and the input Vref (the desired machine terminal voltage). Connect Vrefc to the exciter Vref input. Depending on the synchronous machine type, the available machine variables from load flow calculations differ.

If a thermal or hydraulic synchronous machine is used,

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

If a pu standard synchronous machine is used,

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

## References

1. IEEE, "IEEE Recommended Practice for Excitation System Models for Power System Stability Studies," \_IEEE Std 421.5-2016 (Revision of IEEE Std 421.5-2005),\_pp. 1-207, 26 Aug. 2016
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-vc.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.
