> 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/smart-power-simulation-software-sps/blocks-functions-tools/machines/blocks/machines-control/synchronous-machines-control/generic-power-system-stabilizer.md).

# Generic Power System Stabilizer

## Description

<figure><img src="https://799605156-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FdlNg8IbOdahCpFCyzxSN%2Fuploads%2Fgit-blob-e4be295c3f644fc2742bb94b657020547c0ebd41%2Fgeneric_power_sys_stab_block.png?alt=media" alt=""><figcaption></figcaption></figure>

The **generic Power System Stabilizer** block, located in the **OPAL-RT SPS Software/Electrical Machines/ Synchronous Machine** library, implements a generic power system stabilizer for synchronous machine.

{% hint style="info" %}
This block requires that you have a Control System Toolbox™ license. Otherwise, trying to simulate a model containing this block produces an error.
{% endhint %}

The Generic Power System Stabilizer (PSS) block can be used to add damping to the rotor oscillations of the synchronous machine by controlling its excitation. The disturbances occurring in a power system induce electromechanical oscillations of the electrical generators. These oscillations, also called power swings, must be effectively damped to maintain the system stability. The output signal of the PSS is used as an additional input (`vstab`) to the Excitation System block. The PSS input signal can be either the machine speed deviation, dw, or its acceleration power, Pa = Pm - Peo (difference between the mechanical power and the electrical power).

The Generic Power System Stabilizer is modeled by the following nonlinear system:

<figure><img src="https://799605156-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FdlNg8IbOdahCpFCyzxSN%2Fuploads%2Fgit-blob-3c2fe2a0598f7883740da4fd43099aaf0ce691de%2Fgeneric_power_sys_stab_model.png?alt=media" alt=""><figcaption></figcaption></figure>

To ensure a robust damping, the PSS should provide a moderate phase advance at frequencies of interest in order to compensate for the inherent lag between the field excitation and the electrical torque induced by the PSS action.

The model consists of a low-pass filter, a general gain, a washout high-pass filter, a phase-compensation system, and an output limiter. The general gain K determines the amount of damping produced by the stabilizer. The washout high-pass filter eliminates low frequencies that are present in the dw signal and allows the PSS to respond only to speed changes. The phase-compensation system is represented by a cascade of two first-order lead-lag transfer functions used to compensate the phase lag between the excitation voltage and the electrical torque of the synchronous machine.

## Ports

### Input

<table data-header-hidden><thead><tr><th width="250.33331298828125"></th><th></th></tr></thead><tbody><tr><td><strong>In</strong> — Synchronous machine speed deviation or acceleration power<br>Scalar</td><td><p>Input port that accepts one of these two inputs:</p><ul><li>The synchronous machine speed deviation dw signal (in pu)</li><li>The synchronous machine acceleration power Pa = Pm - Peo, which is the difference between the machine mechanical power and output electrical power (in pu)</li></ul></td></tr></tbody></table>

### Output

<table data-header-hidden><thead><tr><th width="249.77777099609375"></th><th></th></tr></thead><tbody><tr><td><strong>Vstab</strong> — Stabilization voltage<br>Scalar</td><td>Stabilization voltage, in per unit. Connect this output port to the <strong>Vstab</strong> input port of the<a href="https://www.opal-rt.com/docs/smart-power-simulation-software-sps/blocks-functions-tools/machines/blocks/machines-control/synchronous-machines-control/excitation-systems.md"> Excitation System</a> block that you use to control the terminal voltage of the synchronous machine.</td></tr></tbody></table>

## Parameters

To edit block parameters interactively, use the Property Inspector. From the Simulink<sup>®</sup> Toolstrip, on the **Simulation** tab, in the **Prepare** gallery, select **Property Inspector**.

<table data-header-hidden><thead><tr><th width="250.22222900390625"></th><th></th></tr></thead><tbody><tr><td><strong>Sensor time constant</strong> — Sensor time constant<br>30e-3 (default) | positive scalar</td><td>Time constant, in seconds (s), of the first-order low-pass filter used to filter the block input signal.</td></tr><tr><td><strong>Gain</strong> — Gain of generic power system stabilizer<br>20 (default)</td><td>Overall gain K of the generic power system stabilizer.</td></tr><tr><td><strong>Wash-out time constant</strong> — Wash-out time constant<br>2 (default) | positive scalar</td><td>Time constant, in seconds (s), of the first-order high-pass filter used by the washout system of the model.</td></tr><tr><td><strong>Lead-lag #1 time constants: [Tnum Tden]</strong> — Numerator and denominator time constants 1<br>[50e-3 20e-3] (default) | vector of two positive scalars</td><td>Numerator time constant T1n and denominator time constant T1d, in seconds (s), of the first lead-lag transfer function.</td></tr><tr><td><strong>Lead-lag #2 time constants: [Tnum Tden]</strong> — Numerator and denominator time constants 2<br>[3 5.4] (default) | vector of two positive scalars</td><td>Numerator time constant T2n and denominator time constant T2d, in seconds (s), of the second lead-lag transfer function.</td></tr><tr><td><strong>Output limits: [Vsmin Vsmax]</strong> — Output limits<br>[-0.15 0.15] (default) | vector of two scalars</td><td>Limits VSmin and VSmax, in pu, imposed on the output of the stabilizer.</td></tr><tr><td><strong>Initial input</strong> — Initial DC voltage input<br>0 (default)</td><td>Initial DC voltage, in pu, of the block input signal. Specification of this parameter is required to initialize all states and start the simulation in steady state with <code>vstab</code> set to zero.</td></tr><tr><td><strong>Plot frequency response</strong> — Plot frequency response<br>off (default) | on</td><td>Select this option to display a plot of the frequency response of the stabilizer when you click the <strong>Apply</strong> button.</td></tr><tr><td><strong>Magnitude in dB</strong> — Plot magnitude of frequency response<br>on (default) | off</td><td>Select this option to plot the magnitude of the frequency response to plot, in dB.<br><strong>Dependencies</strong> To enable this parameter, select the <strong>Plot frequency response</strong> parameter.</td></tr><tr><td><strong>Frequency range</strong> — Frequency range<br>logspace(-2,2,500) (default)</td><td>Frequency range used to plot the frequency response of the stabilizer.<br><strong>Dependencies</strong> To enable this parameter, select the <strong>Plot frequency response</strong> parameter.</td></tr></tbody></table>

## Examples

See the help text of the [Performance of Three PSS for Interarea Oscillations](https://www.opal-rt.com/docs/smart-power-simulation-software-sps/example-models/power-transmission-and-distribution/performance-of-three-pss-for-interarea-oscillations.md) (power\_PSS) example model.

## References

\[1] Kundur, P., *Power System Stability and Control*, McGraw-Hill, 1994, Section 12.5.


---

# 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/smart-power-simulation-software-sps/blocks-functions-tools/machines/blocks/machines-control/synchronous-machines-control/generic-power-system-stabilizer.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.
