> 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-8bus.md).

# HVAC 230kV 8Bus

## Description

The **HVAC\_230kV\_8Bus** example, located in **File > Open an Example File > Benchmarks**, evaluates electromagnetic transient overvoltages caused by line switching, fault initiation, and fault clearing.

The main objective is to demonstrate testing real protection relays interfaced with the simulator through digital-to-analog converters and power amplifiers, or via the IEC 61850 Ethernet protocol. The model includes five synchronous machines (with built-in exciters, governors, and stabilizers), five two-winding transformers, six constant-parameter lines, and one load, and operates at 13.8 kV and 230 kV. Three-phase faults are defined on Buses 3, 6, 7, 11, and 12, with configurable activation and clearing times.

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

## Requirements

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

## Detailed explanation

### Model structure and controls

* Five synchronous machines, each controlled by internal exciters, governors (speed regulators), and stabilizers. You can modify these settings by double-clicking the machine subsystem and adjusting parameters 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-50ba2f86ab4238ef5cc18a2bc48ae037eebfc6e5%2Fimage%20(1341).png?alt=media" alt=""><figcaption><p>Synchronous machine configuration settings</p></figcaption></figure>

* Five two-winding transformers, six constant-parameter transmission lines, and one load.
* Operating voltage levels: 13.8 kV and 230 kV.

### Fault configuration

* Three-phase faults are available on Buses 3, 6, 7, 11, and 12. You can introduce other fault types (single-line-to-ground and two-phase-to-ground) at different locations if required.
* Fault timing is set using parameters T1 (activation time) and T2 (clearing time) inside each fault subsystem.
* By default, only the fault on Bus 6 is enabled (Fault4). Other defined three-phase faults (Fault1, Fault2, Fault3, Fault5) are disabled. Enable or disable each fault using the corresponding option inside its fault subsystem.

## Simulation and results

As part of the example model setup, the user can perform three types of scenarios. The user can enable or disable five three-phase faults on different model buses. In this case, only two of the five three-phase faults equipped in this model will show the results, each fault is applied independently in different buses. The other 3 three-phase faults can be activated or deactivated following the same instructions given below.

### Scenario 1: Three-phase fault on Bus 6

The first scenario is about introducing a three-phase fault on Bus 6 at 0.1s by 0.1s. This scenario gives the user an idea of reliability in power systems, and how it reacts after clearing a fault.

<figure><img src="https://3623212549-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLxgTpoh7kyPmQ5vuyqD7%2Fuploads%2Fgit-blob-28be8257d4e8c280e5accdc4b855b4199bf5cae7%2Fimage%20(1342).png?alt=media" alt=""><figcaption><p>Bus voltage on Buses 4 and 8 with a three-phase-to-ground fault at Bus 6</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-2102139e54c712076aa69999e0278c62d6503b64%2Fimage%20(1343).png?alt=media" alt=""><figcaption><p>Primary and secondary current of Transformer 4 with a three-phase-to-ground fault at Bus 6</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-96232a61753453829ba614293e30cb55f6aaade8%2Fimage%20(1344).png?alt=media" alt=""><figcaption><p>Machine 1 terminal voltages and speeds with a three-phase-to-ground fault at Bus 6</p></figcaption></figure>

### Scenario 2: Three-phase fault on Bus 7

For this scenario :

* Enable Fault5; disable Fault1, Fault2, Fault3, Fault4.
* Default times: T1 = 0.1 s, T2 = 0.2 s.

<figure><img src="https://3623212549-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLxgTpoh7kyPmQ5vuyqD7%2Fuploads%2Fgit-blob-9a29cf83eac398293a843c91ba426c53ef6dcd8d%2Fimage%20(1345).png?alt=media" alt=""><figcaption><p>Bus voltage on Buses 4 and 8 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-52c7c13d2c7754e8f45db909e1540e6e2aa17008%2Fimage%20(1346).png?alt=media" alt=""><figcaption><p>Primary and secondary current of Transformer 4 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-553fe59045d7f536d8640ebb862d8e83eca179c5%2Fimage%20(1347).png?alt=media" alt=""><figcaption><p>Machine 1 terminal voltages and speeds with a three-phase-to-ground fault at Bus 7</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-8bus.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.
