> 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/exercises.md).

# Exercises

## Objective <a href="#id-4.1-objective" id="id-4.1-objective"></a>

The objective of this exercise is to understand and analyze the response of the power system to the following perturbations:

* [**Part 1:**](#id-4.3.1-part1-short-circuit-in-bus-1-without-damping-windings-inlineextension) A three-phase short circuit on bus 1, the generator does not have rotor damper windings (D = 0).
* [**Part 2:**](#id-4.3.2-part-2-short-circuit-in-bus-1-with-damping-windings-inlineextension) A three-phase short circuit on bus 1, the generator has rotor damper windings.
* [**Part 3:**](#id-4.3.3-part-3-short-circuit-in-bus-3-without-damping-windings-inlineextension) A three-phase short circuit on bus 3, the generator does not have rotor damper windings (D = 0).

Simulations are first run in phasor mode, then in time-domain mode.

## &#x20;Initializing the Setup <a href="#id-4.2-initializing-the-setup" id="id-4.2-initializing-the-setup"></a>

Once the simulator is started in phasor mode, the steady state power flow values are displayed in the “Measurements” section. These values must correspond to the values obtained in the preliminary calculations.

## Exercise <a href="#id-4.3-exercise" id="id-4.3-exercise"></a>

### Part1: Short-circuit in bus 1 without damping windings <a href="#id-4.3.1-part1-short-circuit-in-bus-1-without-damping-windings-inlineextension" id="id-4.3.1-part1-short-circuit-in-bus-1-without-damping-windings-inlineextension"></a>

1. Enter the duration of the fault on bus 1 in the “Duration of the fault 1” field in the main panel (in the field below switch $$P\_{3}$$ ).
2. Go to the “Display 1” tab and click on switch $$K\_{6}$$ to activate the signals on the rotor oscillation frequency.
3. Go to the “Display 2” tab and click on switch $$K\_{7}$$ to set the oscilloscopes to record signals for a period of 6 seconds. The first oscilloscope displays the generator rotor’s mechanical angle on bus 4 and the second displays the voltage Va on the bus. Signal data is also saved in MATLAB (Note: if you do not want to overwrite the previous saved data, remember to change the file numbers in the “delta\_file” and “voltage\_file” fields, for each fault before saving). The panel is completely deactivated during the recording and the “Recording” light turns to red. You must wait for the light to return to green before proceeding to the next exercises. The data files are saved in the following location: \
   C:\OPAL-RT\TestDrive\v2.9.0.16\Models\TransientStabilityTD\_Model\TransientStabilityTD\_Model\_SM\_Master\OpNTtarget
4. Click on switch $$K\_{3}$$ to start a fault on bus 1.
5. In the “Display 1” tab, observe the waveforms displayed on the “generator mechanical angle” and “BUS 4 magnitude voltage” oscilloscopes. There are potentiometers to the left of oscilloscope 1 to adjust the signals.
6. In the “Display 2” tab, the oscilloscopes display the system response 6 seconds *after* the fault insertion. Use the potentiometers to the left to find the maximum rotor angle value. Use the data recorded in MATLAB to more accurately determine the value for this angle.
7. Click on the PSS switch $$K\_{1}$$ to damp system oscillations. During the stabilization, the “PSS” indicator turns green. It is imperative to wait until the indicator returns to off (gray) before continuing to the next exercises.

{% hint style="info" %}

### **Note about the PSS**

To damp the generator rotor oscillations, we can control its inductor current (excitation current) to instantly produce an adequately resistant torque component. The PSS detects the power oscillations and sends a signal to adjust the voltage controller setpoint in the generator’s field current. In the model implemented on the simulator, the PSS can be used to damp power oscillations. Once properly damped, the PSS automatically deactivates.
{% endhint %}

8. Wait until power oscillations stop (the “Oscillations” indicator will turn off).
9. Determine the critical clearance time for the fault by repeating procedures from steps a) to h) with fault durations as close as possible to analytically determined values.

### Part 2: Short-circuit in bus 1 with damping windings <a href="#id-4.3.2-part-2-short-circuit-in-bus-1-with-damping-windings-inlineextension" id="id-4.3.2-part-2-short-circuit-in-bus-1-with-damping-windings-inlineextension"></a>

1. Click on switch $$K\_{2}$$ to activate the damper windings in the rotor of the generator.
2. Repeat steps a) to f) from Part 1. Note that PSS use is not needed. Comment.
3. Find the maximum duration that the system can support before becoming unstable by repeating procedures from steps a) to h) from Part 1 with fault duration as close as possible to analytically determined values.
4. When the exercise is complete, deactivate switch $$K\_{2}$$ to reset the synchronous generator damper to zero.

### Part 3: Short-circuit in bus 3 without damping windings <a href="#id-4.3.3-part-3-short-circuit-in-bus-3-without-damping-windings-inlineextension" id="id-4.3.3-part-3-short-circuit-in-bus-3-without-damping-windings-inlineextension"></a>

1. Enter the fault duration for bus 3 in the “Duration of the fault 3” field in the main panel (in the field below switch $$K\_{4}$$ ).
2. Go to the “Display1” tab, click on switch $$K\_{6}$$ to activate the signal on the rotor’s oscillation frequency.
3. Go to the “Display2” tab, click on switch $$K\_{7}$$ to set the oscilloscopes to record the 4 signals for 6 seconds.
4. Click on switch $$K\_{4}$$ to start the fault on bus 3.
5. Observe the waveforms displayed in the “Display1” tab oscilloscopes: “Generator mechanical angle” and “BUS 4 magnitude voltage”. Use potentiometers on the left to adjust oscilloscope 1.
6. In the “Display 2” tab, the oscilloscopes display the system response 6 seconds *after* fault insertion. Use the potentiometers to the left to find the maximum rotor angle value. Use the data recorded in MATLAB to more accurately determine the value for this angle.
7. Click on switch $$K\_{5}$$ to close circuit breakers D1 and D2. This reconnects the line between buses 1 and 3, and between buses 3 and 2.
8. &#x20;Click on switch $$K\_{1}$$ to damp system oscillations.
9. Wait until oscillations stop; the “Oscillations” indicator will turn off.
10. Find the maximum duration that the system can support before becoming unstable by repeating procedures from steps a) to i) from Part 1 with fault duration as close as possible to analytically determined values.

### Part 4: Time-domain simulation <a href="#id-4.3.4-part-4-time-domain-simulation" id="id-4.3.4-part-4-time-domain-simulation"></a>

1. Using the saved data files, repeat parts 1 to 3 in time-domain mode.
2. Do the results correspond to results from phasor mode simulation? Comment.


---

# 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/exercises.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.
