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

# HVAC 230kV 9Bus IEEE

## Description

The **HVAC 230kV 9Bus IEEE** example, located in **File > Open an Example File > Benchmarks**, is based on the Western System Coordinating Council (WSCC) 9‑bus test case presented in \[1].

The objective is to demonstrate steady‑state operation and transient performance under a configurable three‑phase fault at Bus 4, while showcasing the use of built‑in exciters, governors, and stabilizers for the synchronous machines.

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

## Requirements

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

## Detailed explanation

The IEEE 9‑bus modified test system includes the following:

* Three synchronous machines with IEEE type‑1 exciters and built‑in voltage and speed regulators
* Three two‑winding transformers
* Six constant‑parameter transmission lines
* Three loads

The system operates at four voltage levels: 15.5 kV, 18 kV, 24 kV, and 230 kV. The total load demand is 315 MW and 115 MVA \[2,3].

All generator units are equipped with internal exciters, governors (speed regulators), and stabilizers. To modify these controls, double‑click the machine subsystem and adjust the 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-d93fb6da485aeec7be85283f7a611b428612464d%2Fimage%20(1354).png?alt=media" alt=""><figcaption><p>Synchronous machine configuration settings</p></figcaption></figure>

A three‑phase fault is provided on Bus 4. You can modify the fault timing by opening the fault subsystem and editing T1 (activation time) and T2 (clearing time). Additional faults can be added on other buses as needed.

## Simulation and results

As part of the example model setup, the user can perform two types of scenarios, each scenario has a template in ScopeView to display the signals.

### Scenario 1: Model running without events

This scenario runs the IEEE 9‑bus model without any type of failure or event.

<figure><img src="https://3623212549-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLxgTpoh7kyPmQ5vuyqD7%2Fuploads%2Fgit-blob-b15238675cdcec722fde18d53bcb05a4d193ebeb%2Fimage%20(1355).png?alt=media" alt=""><figcaption><p>Voltages in PU of the buses of the IEEE-9 model</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-26e22537cee3c7de4947e395d89e6fae690c2583%2Fimage%20(1356).png?alt=media" alt=""><figcaption><p>Three-phase bus voltages of the IEEE-9 model</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-2a386889c863d39edfeefd1f224621dbc3134878%2Fimage%20(1357).png?alt=media" alt=""><figcaption><p>Active and reactive power in the lines of the IEEE-9 model</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-0de687379839c239f7ae153aa0378044b263494e%2Fimage%20(1358).png?alt=media" alt=""><figcaption><p>Active and reactive power generated by synchronous machines</p></figcaption></figure>

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

This scenario applies a three‑phase fault on Bus 4 at 0.05 s for 0.02 s. Adjust T1 and T2 in the fault subsystem to change the 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-1c6a3cda00ec5a7117dc62fb77ddc6e9cf12c5c3%2Fimage%20(1359).png?alt=media" alt=""><figcaption><p>Fault configuration settings</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-585de9bf412557fb0540e06eb2d422b2f9f09096%2Fimage%20(1360).png?alt=media" alt=""><figcaption><p>Three-phase voltage on the buses of the IEEE-9 model with a three-phase to-ground fault at Bus 4.</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-b4e38837887965e5754e273d6915c99828c0721d%2Fimage%20(1361).png?alt=media" alt=""><figcaption><p>Three-phase currents in the lines of the IEEE-9 model with a three-phase to-ground fault at Bus 4.</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-cd48cb2b1f7de4feafb4cf2fb7930cd92a07fe78%2Fimage%20(1362).png?alt=media" alt=""><figcaption><p>Machines terminal voltages and frequency with a three-phase to ground fault at Bus 4.</p></figcaption></figure>

## References

\[1] KIOS Centre for Intelligent Systems & Networks. 2013. IEEE 9-bus modified test system. \[ONLINE] Available at: <http://www.kios.ucy.ac.cy/testsystems/index.php/dynamic-ieee-testsystems/ieee-9-bus-modified-test-system>.

\[2] Harrys Kon. 2016. WSCC 9-Bus System.

\[3] Manitoba HVDC Research Center. 2015. IEEE Test Systems.


---

# 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-9bus-ieee.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.
