> 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/examples/benchmarks/hvac-230kv-7bus.md).

# HVAC 230kV 7Bus

## Description

The **HVAC 230kV 7Bus** example, located in **File > Open an Example File > Benchmarks**, is designed to evaluate electromagnetic transient overvoltage caused by line switching, fault initiation, and fault clearing. It can also be used to test the performance of real protection relays interfaced with the simulator through digital-to-analog converters and power amplifiers, or via the IEC 61850 Ethernet communication protocol used with model relays. The model includes four synchronous machines with built-in voltage and speed regulators, one voltage source, six two-winding transformers, seven constant-parameter lines, and two loads. It operates at three voltage levels: 13.8 kV, 110 kV, and 230 kV. During the simulation, single-line-to-ground, three-phase, and two-phase-to-ground faults can be applied at different locations. In this example, three three-phase faults are configured on Buses 7, 12, and 14.

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

## Requirements

This example model does not require any additional hardware or licenses.

## Detailed explanation

**Generation system controls**

All synchronous machines are controlled by internal exciters, governors (speed regulators), and stabilizers. You can modify these controllers by double-clicking the machine subsystem and editing the values in the mask.

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

**Fault setup and customization**

* Three three-phase faults are provided as configurable subsystems: Fault1 (Bus 7), Fault2 (Bus 12), and Fault3 (Bus 14).
* Fault activation and clearing are configured using the parameters T1 (activation time) and T2 (clearing time) within each fault subsystem.
* By default, only Fault1 is enabled. To enable a specific fault scenario:
  * Scenario 1 (Bus 7): Enable Fault1 and disable Fault2 and Fault3.
  * Scenario 2 (Bus 12): Enable Fault2 and disable Fault1 and Fault3.
  * Scenario 3 (Bus 14): Enable Fault3 and disable Fault1 and Fault2.
* Default timing for each scenario is to activate at 0.1 s and clear 0.1 s later.
* You may add new faults at other buses as needed.

## Simulation and results

### **Scenario 1: Three-phase fault on Bus 7**

* Configuration: Fault1 enabled; Fault2 and Fault3 disabled.
* Timing: Activate at 0.1 s; clear at 0.2 s (0.1 s later).

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

Observed signals in ScopeView:

<figure><img src="https://3623212549-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLxgTpoh7kyPmQ5vuyqD7%2Fuploads%2Fgit-blob-c790d79d8fc48ed6310edec76639647a0daad273%2Fimage%20(1305).png?alt=media" alt=""><figcaption><p>Bus voltages and fault current during a three-phase-to-ground fault at Bus 7.</p></figcaption></figure>

<figure><img src="https://3623212549-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLxgTpoh7kyPmQ5vuyqD7%2Fuploads%2Fgit-blob-da2704a53a9c1b7426c42c6af3bf69c39c820daa%2Fimage%20(1306).png?alt=media" alt=""><figcaption><p>Bus 7 voltage and grid current with a three-phase to ground fault at Bus 7</p></figcaption></figure>

<figure><img src="https://3623212549-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLxgTpoh7kyPmQ5vuyqD7%2Fuploads%2Fgit-blob-6474db8dd49be4dc410c439f9bd15cc30195ddc4%2Fimage%20(1307).png?alt=media" alt=""><figcaption><p>Machine Terminal Voltages and Speeds with a three-phase to-ground fault at Bus 7</p></figcaption></figure>

### **Scenario 2: Three-phase fault on Bus 12**

* Configuration: Fault2 enabled; Fault1 and Fault3 disabled.
* Timing: Activate at 0.1 s; clear at 0.2 s (0.1 s later).
* Observed signals in ScopeView

<figure><img src="https://3623212549-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLxgTpoh7kyPmQ5vuyqD7%2Fuploads%2Fgit-blob-a0b5515c73e41158be6973354b663ead5706bf54%2Fimage%20(1308).png?alt=media" alt=""><figcaption><p>Bus Voltage and Fault current on Bus 7 with a three-phase to-ground fault at Bus 12</p></figcaption></figure>

<figure><img src="https://3623212549-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLxgTpoh7kyPmQ5vuyqD7%2Fuploads%2Fgit-blob-ee686cc728a070d486173bb7f22444eb4e691c53%2Fimage%20(1310).png?alt=media" alt=""><figcaption><p>Machine Terminal Voltages and Speeds with a three-phase to-ground fault at Bus 12</p></figcaption></figure>

### **Scenario 3: Three-phase fault on Bus 14**

* Configuration: Fault3 enabled; Fault1 and Fault2 disabled.
* Timing: Activate at 0.1 s; clear at 0.2 s (0.1 s later).

Observed signals in ScopeView:

<figure><img src="https://3623212549-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLxgTpoh7kyPmQ5vuyqD7%2Fuploads%2Fgit-blob-b7b9db0df0b17471a5a51ef361a3ec16811ae25b%2Fimage%20(1311).png?alt=media" alt=""><figcaption><p>Bus Voltage and Fault current on Bus 7 with a three-phase to-ground fault at Bus 14</p></figcaption></figure>

<figure><img src="https://3623212549-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLxgTpoh7kyPmQ5vuyqD7%2Fuploads%2Fgit-blob-f7ecf64b144212f5c1eacc8e9743b091142b08b1%2Fimage%20(1312).png?alt=media" alt=""><figcaption><p>Bus 7 voltage and grid current with a three-phase to-ground fault at Bus 14</p></figcaption></figure>

<figure><img src="https://3623212549-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLxgTpoh7kyPmQ5vuyqD7%2Fuploads%2Fgit-blob-c5a6eb751352944b942a81e39c18246241c0212a%2Fimage%20(1313).png?alt=media" alt=""><figcaption><p>Machine Terminal Voltages and Speeds with a three-phase to-ground fault at Bus 14</p></figcaption></figure>


---

# 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/examples/benchmarks/hvac-230kv-7bus.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.
