> 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/courseware/electric-courseware/electric-machines-courseware/understanding-transient-stability-using-real-time-simulation-laboratories/panels-overview.md).

# Panels Overview

The **TransientStability** model file, located in the folder **OP1160 - Electric Machines Courseware,** is **EM\_TransientStability-version.zip**

The simulator dashboard contains command switches, control parameters and measurement device display for the stabilization system status of the system. This dashboard represents the interactive user interface for the simulation of the transient stability on the power system under study.

This section is a complete reference for components contained in the simulation dashboard.

## Startup Panel <a href="#id-3.1-startup-panel" id="id-3.1-startup-panel"></a>

At start up, the simulator panel appears, as shown in Figure.1. The default values for the switches, explained in Table 3, are in grey fields.

<figure><img src="https://4054096626-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYbyVjpgEQX9nfCkpYoFP%2Fuploads%2FJcklGL8rZaAX1tFGvqEW%2Fab2b5b8f-9719-4cde-81a0-f26190647eab.png?alt=media&amp;token=9ae98306-bd53-4cb2-9755-88a5dd323dca" alt=""><figcaption><p>Figure 1: Startup panel</p></figcaption></figure>

### Parameters setup and control switches <a href="#id-3.2-tables-for-parameters-setup-and-control-switches" id="id-3.2-tables-for-parameters-setup-and-control-switches"></a>

Table 1: User accessible control parameters

| Control parameters                   | Default values | Variation interval |
| ------------------------------------ | -------------- | ------------------ |
| **Duration of the fault 1 (second)** | 0.1            | \[0 ; 1]           |
| **Duration of the fault 3 (second)** | 0.1            | \[0 ; 1]           |
| **delta file**                       | 0              | \[0 ; 20]          |
| **Voltage file**                     | 0              | \[0 ; 20]          |

Table 2: Control switch descriptions

<table data-search="false"><thead><tr><th width="233.39996337890625">FUNCTION</th><th width="97.79998779296875">Icon</th><th>Description</th></tr></thead><tbody><tr><td><strong>K</strong><sub><strong>1</strong></sub><strong>: “Start PSS”</strong></td><td><img src="https://4054096626-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYbyVjpgEQX9nfCkpYoFP%2Fuploads%2FEP0InqMwAwWO7yL9CpSY%2Fimage.png?alt=media&amp;token=c37be4df-f48c-401b-8f8f-7fdbcedaf272" alt="" data-size="original"></td><td>Default status, no action.</td></tr><tr><td></td><td><img src="https://4054096626-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYbyVjpgEQX9nfCkpYoFP%2Fuploads%2FfiPgZV13g9SiPAPUWbIu%2Fimage.png?alt=media&amp;token=b46f0997-7d7e-4b29-b255-0ad3231e5296" alt="" data-size="original"></td><td>PSS is activated until the system is stabilized.</td></tr><tr><td><strong>K</strong><sub><strong>2</strong></sub><strong>: “Activate Damping”</strong></td><td><img src="https://4054096626-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYbyVjpgEQX9nfCkpYoFP%2Fuploads%2Fw2zBHPNdTJODJXrPeV0V%2Fimage.png?alt=media&amp;token=ddcd6b65-5ee7-4033-ac23-b186a6c60d01" alt="" data-size="original"></td><td>The generator has no rotor damper windings.</td></tr><tr><td></td><td><img src="https://4054096626-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYbyVjpgEQX9nfCkpYoFP%2Fuploads%2F7SGLSBIJvybOhLnC3N3E%2Fimage.png?alt=media&amp;token=5dddfd3a-f77b-4c7e-9ea1-3ff34dc9946f" alt=""></td><td>The generator has rotor damper windings to damp torque oscillations</td></tr><tr><td><strong>K</strong><sub><strong>3</strong></sub><strong>: “Apply Fault at Bus 1”</strong></td><td><img src="https://4054096626-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYbyVjpgEQX9nfCkpYoFP%2Fuploads%2FeOo3cxnjUlPIXnCb06Um%2Fimage.png?alt=media&amp;token=fcba394d-4cab-47ad-a07c-7e9bc3910a26" alt="" data-size="original"></td><td>Default status, no action.</td></tr><tr><td></td><td><img src="https://4054096626-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYbyVjpgEQX9nfCkpYoFP%2Fuploads%2F3v56J1CMcYRBb4aNX8ly%2Fimage.png?alt=media&amp;token=bd15c459-58e6-4a71-b80f-56deac6fdeca" alt=""></td><td>Fault is triggered on bus 1.</td></tr><tr><td><strong>K</strong><sub><strong>4</strong></sub><strong>: “Apply Fault at Bus 3”</strong></td><td><img src="https://4054096626-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYbyVjpgEQX9nfCkpYoFP%2Fuploads%2FEYcbPbmrBu07tpJFJL8i%2Fimage.png?alt=media&amp;token=74c521ba-bda9-444e-83aa-14678ed26dae" alt="" data-size="original"></td><td>Default status, no action.</td></tr><tr><td></td><td><img src="https://4054096626-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYbyVjpgEQX9nfCkpYoFP%2Fuploads%2F4of7H4AFj6ui6JX5Jrli%2Fimage.png?alt=media&amp;token=c10fc49f-d6a7-4b27-93a3-afee18b284c4" alt=""></td><td>Fault is triggered on bus 3.</td></tr><tr><td><strong>K</strong><sub><strong>5</strong></sub><strong>: “Line Breakers”</strong></td><td><img src="https://4054096626-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYbyVjpgEQX9nfCkpYoFP%2Fuploads%2FmkOkb9hwxCzFmTrGLBoL%2Fimage.png?alt=media&amp;token=759a9365-c167-4891-bd3d-8b506a661be0" alt="" data-size="original"></td><td>Default status, no action.</td></tr><tr><td></td><td><img src="https://4054096626-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYbyVjpgEQX9nfCkpYoFP%2Fuploads%2FC8AMnPP3a059f1VXGJ9P%2Fimage.png?alt=media&amp;token=593d6999-b243-4032-a79c-7d8fedc0f7dc" alt=""></td><td>Switches are closed: the line between buses 1 and 3, and between buses 3 and 2 are reconnected.</td></tr><tr><td><strong>K</strong><sub><strong>6</strong></sub><strong>: “Trig-Acq. Gr. 1”</strong></td><td><img src="https://4054096626-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYbyVjpgEQX9nfCkpYoFP%2Fuploads%2FZ4kHt4lzScMcOsINQBbl%2Fimage.png?alt=media&amp;token=f55b1666-8a0c-4dda-9e0a-f1fb5154df9a" alt="" data-size="original"></td><td>The trigger function is inactive. Signals are not synchronized with respect to a reference signal.</td></tr><tr><td></td><td><img src="https://4054096626-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYbyVjpgEQX9nfCkpYoFP%2Fuploads%2Fa6dAGvzb4em7CpE3y2Vm%2Fimage.png?alt=media&amp;token=19033b6a-30c3-4085-b84d-fd72f88c3bb0" alt=""></td><td>Signals are synchronized with the oscillations' frequency of the system.</td></tr><tr><td><strong>K</strong><sub><strong>7</strong></sub><strong>: “Trig-Acq. Gr. 2”</strong></td><td><img src="https://4054096626-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYbyVjpgEQX9nfCkpYoFP%2Fuploads%2FmbhWLzHaNgl1SCURRwFX%2Fimage.png?alt=media&amp;token=4f169345-12a2-4682-b4c9-1bb6e3334f2e" alt="" data-size="original"></td><td>The trigger function is inactive.</td></tr><tr><td></td><td><img src="https://4054096626-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYbyVjpgEQX9nfCkpYoFP%2Fuploads%2FUdS0MeabbIUlQORTi6Tp%2Fimage.png?alt=media&amp;token=a3691caa-5762-4914-9b72-10844a7e9c19" alt=""></td><td>The oscilloscopes are waiting for a fault initiation to display the signal waveforms for 6 seconds.</td></tr></tbody></table>

Table 3: Status indicator functions

<table data-search="false"><thead><tr><th width="240.4000244140625">Control Indicators</th><th>Description</th></tr></thead><tbody><tr><td><strong>D1</strong></td><td><p><img src="https://4054096626-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYbyVjpgEQX9nfCkpYoFP%2Fuploads%2FYzvApeLCp7tTKcee4NxN%2Fimage.png?alt=media&amp;token=28a48eba-7eab-4793-8d7d-f0a68a7cd54a" alt=""> Switch closed (line connected)</p><p><img src="https://4054096626-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYbyVjpgEQX9nfCkpYoFP%2Fuploads%2F6TWPhu7Ch2DzlZ3oka3Q%2Fimage.png?alt=media&amp;token=7bb03004-a4de-4382-b7c6-68a2d04cc48d" alt=""> Switch open (line disconnected)</p></td></tr><tr><td><strong>D2</strong></td><td><p><img src="https://4054096626-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYbyVjpgEQX9nfCkpYoFP%2Fuploads%2FcQM0GjMtGLyqU8cX3p5w%2Fimage.png?alt=media&amp;token=4c47b1ce-ddbe-4228-a852-a67960dcb6ea" alt=""> Switch closed (line connected)</p><p><img src="https://4054096626-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYbyVjpgEQX9nfCkpYoFP%2Fuploads%2FEOUQ4sNK6t6t0QiwApr0%2Fimage.png?alt=media&amp;token=376c4859-654d-44a7-89a7-71365789ab09" alt=""> Switch open (line disconnected)</p></td></tr><tr><td><strong>Damping</strong></td><td><p><img src="https://4054096626-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYbyVjpgEQX9nfCkpYoFP%2Fuploads%2F4ziRdtQRqoVE900PRhNS%2Fimage.png?alt=media&amp;token=288071c7-dc74-406e-b829-92ded1f13855" alt="">The generator is equipped with rotor damper windings</p><p><img src="https://4054096626-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYbyVjpgEQX9nfCkpYoFP%2Fuploads%2Fn3M82DLpzWPNBCx2jwZc%2Fimage.png?alt=media&amp;token=cb62e0d6-c0bf-4b30-ba17-84e54a58776b" alt="">The generator is not equipped with rotor damper windings.</p></td></tr><tr><td><strong>Oscillating</strong></td><td><p><img src="https://4054096626-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYbyVjpgEQX9nfCkpYoFP%2Fuploads%2FhG5UqG4qt7F5Jbna433q%2Fimage.png?alt=media&amp;token=76950798-5351-4092-bb44-1d2a0cf68ce6" alt="">The system is oscillating.</p><p><img src="https://4054096626-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYbyVjpgEQX9nfCkpYoFP%2Fuploads%2FA0gRh0bVp7UJWHfMa8SO%2Fimage.png?alt=media&amp;token=921e6ef7-b4ed-4613-88c3-4c82246cd3ef" alt="">The system is not oscillating.</p></td></tr><tr><td><strong>Stability</strong></td><td><p><img src="https://4054096626-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYbyVjpgEQX9nfCkpYoFP%2Fuploads%2FytZ8uUcx3EWaTVogpYPq%2Fimage.png?alt=media&amp;token=98d84d33-e7e4-45f5-abc4-aa98f149d3ce" alt="">The system is stable.</p><p><img src="https://4054096626-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYbyVjpgEQX9nfCkpYoFP%2Fuploads%2FynpUHoxxeQeRq0fKT7LF%2Fimage.png?alt=media&amp;token=a94a3d8d-a2a6-4ed9-b467-b8874098d361" alt="">The system is not stable.</p></td></tr><tr><td><strong>PSS</strong></td><td><p><img src="https://4054096626-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYbyVjpgEQX9nfCkpYoFP%2Fuploads%2FKivgMPmn99v6EYtUU3d6%2Fimage.png?alt=media&amp;token=4d741e6e-da2d-49eb-ac83-074a6abe8887" alt="">The PSS is enabled.</p><p><img src="https://4054096626-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYbyVjpgEQX9nfCkpYoFP%2Fuploads%2F3P8Vy85TwFouL9HZQLsk%2Fimage.png?alt=media&amp;token=28888d9b-7a77-4ebf-8862-32b3d0c50099" alt="">The PSS is no longer enabled.</p></td></tr><tr><td><strong>Recording</strong></td><td><p><img src="https://4054096626-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYbyVjpgEQX9nfCkpYoFP%2Fuploads%2FuWxtMxzPheENNRhULIwh%2Fleds-red.png?alt=media&amp;token=e019671b-a787-4aad-909a-de09e852ab97" alt="" data-size="original">Data is being saved.</p><p><img src="https://4054096626-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYbyVjpgEQX9nfCkpYoFP%2Fuploads%2FynpUHoxxeQeRq0fKT7LF%2Fimage.png?alt=media&amp;token=a94a3d8d-a2a6-4ed9-b467-b8874098d361" alt="">No data is being saved.</p></td></tr></tbody></table>

## Tab descriptions <a href="#id-3.3-tab-descriptions" id="id-3.3-tab-descriptions"></a>

The panel shown in Figure.1 contains several tabs selectable by the user

The Panel tab contains all simulator dashboard components and two additional tabs, Display 1 and Display 2 are oscilloscope tabs that the user can select to change display pages:

* Oscilloscope tabs “Display1” and “Display 2”: On tab “Display1” the signals are displayed continuously and on tab “Display 2” the signals are saved and displayed for 6 seconds after the initiation of a fault on the power system. Also, those signals are updated each time a new fault occurs.
* “Help” tab: located in the top left corner of the dashboard screen, this page contains information about the exercises.

### Display of measurement devices and oscilloscopes waveforms <a href="#id-3.4-display-of-measurement-devices-and-oscilloscopes-waveforms" id="id-3.4-display-of-measurement-devices-and-oscilloscopes-waveforms"></a>

Table 4: Measurement device display modules

<table data-search="false"><thead><tr><th width="120">Sections</th><th width="120.2000732421875">Display</th><th width="100.5999755859375">Label</th><th>Measurement displayed</th></tr></thead><tbody><tr><td><strong>Bus 1</strong></td><td>Display<sub>1</sub></td><td>mag</td><td>Voltage magnitude at bus 1</td></tr><tr><td></td><td>Display<sub>2</sub></td><td>ang</td><td>Voltage angle at bus 1 [degree]</td></tr><tr><td> <strong>Bus 2</strong></td><td>Display<sub>1</sub></td><td>mag</td><td>Voltage magnitude at bus 2</td></tr><tr><td></td><td>Display<sub>2</sub></td><td>ang</td><td>Voltage angle at bus 2 [degree]</td></tr><tr><td></td><td>Display<sub>3</sub></td><td>P</td><td>Active power at bus 2 [MW]</td></tr><tr><td></td><td>Display<sub>4</sub></td><td>Q</td><td>Reactive power at bus 2 [MVar]</td></tr><tr><td><strong>Bus 3</strong></td><td>Display<sub>1</sub></td><td>mag</td><td>Voltage magnitude at bus 3</td></tr><tr><td></td><td>Display<sub>2</sub></td><td>ang</td><td>Voltage angle at bus 3 [degree]</td></tr><tr><td><strong>Bus 4</strong></td><td>Display<sub>1</sub></td><td>mag</td><td>Voltage magnitude at bus 4</td></tr><tr><td></td><td>Display<sub>2</sub></td><td>ang</td><td>Voltage angle at bus 4 [degree]</td></tr><tr><td></td><td>Display<sub>3</sub></td><td>P</td><td>Active power bus 4 [MW]</td></tr><tr><td></td><td>Display<sub>4</sub></td><td>Q</td><td>Reactive power at bus 4 [MVar]</td></tr><tr><td></td><td>Display<sub>5</sub></td><td>delta</td><td>Generator rotor mechanical angle [degree]</td></tr></tbody></table>

Table 5: Waveforms and oscilloscope settings

<table data-search="false"><thead><tr><th width="120">Tab</th><th width="140.39996337890625">Oscilloscopes</th><th>Waveforms displayed on the oscilloscopes</th></tr></thead><tbody><tr><td><strong>Display1</strong></td><td>Oscilloscope 1</td><td><p>“Generator mechanical angle (degree)”.</p><p>Mechanical angle of generator delta in degrees.</p></td></tr><tr><td></td><td>Oscilloscope 2</td><td><p>“BUS 4 magnitude voltage (pu)”.</p><p>Voltage magnitude in pu of phase A on bus 4.</p></td></tr><tr><td></td><td>y-axis scale</td><td>Setting the y-axis scale on the oscilloscope displaying the rotor mechanical angle.</td></tr><tr><td></td><td>y-axis offset</td><td>Setting y-axis offset on the oscilloscope displaying the rotor mechanical angle.</td></tr><tr><td><strong>Display 2</strong></td><td>Oscilloscope 1</td><td><p>“Generator mechanical angle (degree)”.</p><p>Generator mechanical angle delta in degrees for 6 seconds, when a fault occurs and trigger “Trig-Acq.Gr. 2” is active.</p></td></tr><tr><td></td><td>Oscilloscope 2</td><td><p>“BUS 4 magnitude voltage (pu)”.</p><p>Voltage magnitude in pu of phase A on bus 4 over a period of 6 seconds when a fault occurs and trigger “Trig-Acq.Gr. 2” is active.</p></td></tr><tr><td></td><td>y-axis scale</td><td>Setting the y-axis scale on the oscilloscope displaying the rotor mechanical angle</td></tr><tr><td></td><td>y-axis offset</td><td>Setting the y-axis offset on the oscilloscope displaying the rotor mechanical angle.</td></tr><tr><td></td><td>delta_file</td><td>File number for delta angle data saved during fault.</td></tr><tr><td></td><td>voltage_file</td><td>File number for bus 4 voltage data saved during fault.</td></tr></tbody></table>


---

# 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/courseware/electric-courseware/electric-machines-courseware/understanding-transient-stability-using-real-time-simulation-laboratories/panels-overview.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.
