> 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/rt-lab/example-models/ephasorsim-example-models/10000-bus-synthetic-grid-on-the-footprint-of-us-portion-in-wecc-system.md).

# 10000-Bus Synthetic Grid on the Footprint of US Portion in WECC System

## Description

The **10000-Bus Synthetic Grid on the Footprint of US Portion in WECC System** example can be created by starting a new RT‑LAB project. From the menu bar, select **File > New > RT‑LAB Project**. Enter a name and location for your project, then click **Next**. From the available templates list, navigate to **ePHASORsim** and select **phasor21\_10k\_WECC**, then click **Finish**.

This demo shows transient stability simulation of a synthetic 10000-bus grid system that is built on the geographic footprint of the United States portion in the Western Electricity Coordinating Council (WECC)\[1]. The approximate geographic area of this 10k grid system is shown in figure below.

<figure><img src="https://96827845-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNRdpSk8kjn20gXAexnt6%2Fuploads%2Fgit-blob-e32096d6c3216ef87cf3f6e1ee975f9b23d05a37%2Fphasor21_10k_diagram.png?alt=media" alt=""><figcaption><p>Approximate geographic area of the 10000-bus grid system.</p></figcaption></figure>

The test case does not represent the actual grid; however, the generation and load profiles are based on public data. The synthetic grid consists of sixteen areas with seven nominal voltage levels. The following modifications are made to the original data provided in \[2]:

1. All renewable energy generators in the original \*.raw file with no corresponding dynamic data in \*.dyr are replaced with classical generators (GENCLS).
2. All the loads are converted to constant impedance type assuming 1 p.u. voltage.
3. Some modifications in the \*.dyr file is done, such as change in parameters of some components, to resolve initialization issues and to stabilize the system with 10 ms time-step.

The modified data files are in the model folder named as phasor21\_10k\_WECC.raw and phasor21\_10k\_WECC.dyr.

## Requirements

* MATLAB R2019b and later

## Simulation and results

For this demo of the 10000-bus system, the contingency event implemented is the loss of generation. A total of four generators located at buses 40843, 40844, 40786 and 40787 are disconnected, which creates approximately 4200 MW of generation loss. The simulation starts from a steady-state and at t = 5 sec these generators are tripped.

The terminal voltage magnitude and frequency of some generators from the simulation are demonstrated here.

Figure (a) shows the terminal voltage magnitude (p.u.) and Figure (b) depicts the frequency (Hz) oscillations of generator buses.

<figure><img src="https://96827845-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNRdpSk8kjn20gXAexnt6%2Fuploads%2Fgit-blob-5d2103f07a336afd91d07fea00a291acc18ee409%2Fphasor21_10k_WECC_1.png?alt=media" alt=""><figcaption><p>Simulation results for (a) Terminal voltage (p.u.) (b) Frequency (Hz).</p></figcaption></figure>

The in-port and out-port configurations are given in the phasor21\_10k\_WECC.xlsx file.

{% file src="/files/Py6kaOi3DuxzFLSOu88J" %}

In the "Pins" page of the Excel file the following outgoing and incoming pins are assigned:

<details>

<summary>Outgoing pins (measurements)</summary>

* Vmag: Bus voltage magnitude (p.u.)
* SLIP: Synchronous machine speed deviation (p.u.), which is converted to frequency outside the solver
* EFD: Synchronous machine field voltage (p.u.)

</details>

<details>

<summary>Incoming pin (control command)</summary>

* Generator status: To trip the generators

</details>

## References

\[1] A. B. Birchfield, T. Xu, and T. J. Overbye, "Power flow convergence and reactive power planning in the creation of large synthetic grids," in IEEE Transactions on Power Systems, 2018.

\[2] [Electric Grid Test Case Repository](https://electricgrids.engr.tamu.edu/electric-grid-test-cases/activsg10k/).


---

# 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/rt-lab/example-models/ephasorsim-example-models/10000-bus-synthetic-grid-on-the-footprint-of-us-portion-in-wecc-system.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.
