> 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/conventional-generation/sub-synchronous-resonance-ieee-2.md).

# Sub synchronous Resonance IEEE 2

## Description

The **Subsynchronous Resonance IEEE 2** example, located in **File > Open an Example File > Conventional Generation**, is based on the IEEE Second Benchmark Model for Computer Simulation of Subsynchronous Resonance.

The objective is to demonstrate subsynchronous resonance (SSR) in a multi-mass synchronous machine connected to a series-compensated network, highlight the shaft oscillation modes, and illustrate post-fault resonance behavior using loadflow initialization.

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

## Requirements

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

## Detailed explanation

This model is developed in HYPERSIM from the IEEE Transactions on Power Apparatus and Systems benchmark for SSR.

A multi-mass synchronous machine is connected to a series-compensated transmission network. The series capacitor reduces 55% of the nominal line inductance to lower the line voltage drop. The shaft system is critically damped.

Network disturbances can excite the shaft’s natural frequencies, producing oscillations that may cause severe mechanical stress and damage to the shaft and turbine.

The damping of mass #1 is 1.408. It was temporarily increased to reach steady state; replace it with 1.408 before applying the fault.

System #1, Case #1A is reproduced. The exciter mass is included in the generator mass.

The steam turbine includes multiple pressure stages for efficiency: Exciter mass #1; Generator mass #2; Turbine LP mass #3; Exciter HP mass #4.

The three theoretical shaft oscillation modes, obtained from the eigenvalues of the shaft system matrix, are 24.65 Hz, 32.39 Hz, and 51.10 Hz.

Loadflow results are applied to set the initial conditions of the model.

## Simulation and results

Loadflow results for initialization

{% tabs %}
{% tab title="Generation buses" %}

| Pgen (MW)    | Qgen (MW) | Bus     |
| ------------ | --------- | ------- |
| 540.000      | 14.070    | Bus22kV |
| -526.867     | 118.312   | BusGen  |
| {% endtab %} |           |         |

{% tab title="Internal voltages at generation buses" %}

| 39.863        | 97.861 | Buss22kV |
| ------------- | ------ | -------- |
| 520.218       | -8.828 | BusGen   |
| {% endtab %}  |        |          |
| {% endtabs %} |        |          |

In this scenario, a fault is applied at t = 0.0223 s. The system is stable in steady state prior to the fault. At the fault, current peaks occur and current frequency components begin oscillating in resonance with the shaft system. After the fault is cleared at t = 0.0393 s, the system continues to oscillate, which can be critical for mechanical integrity.

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

Over a 5 s window after the fault is cleared, the generator angular speed and the spectral density of the speed deviation from nominal show a dominant peak at approximately 24.6 Hz, close to the first theoretical oscillation mode. This indicates the onset of mechanical resonance.

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

## References

\[1] "Second Benchmark Model for Computer Simulation of Subsynchronous Resonance," in *IEEE Transactions on Power Apparatus and Systems*, vol. PAS-104, no. 5, pp. 1057-1066, May 1985, doi: 10.1109/TPAS.1985.323456.


---

# 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/conventional-generation/sub-synchronous-resonance-ieee-2.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.
