> 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/steam-turbine-and-governor.md).

# Steam Turbine and Governor

## Description

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

The **Steam Turbine and Governor** block, located in the **OPAL-RT SPS Software/Electrical Machines** library, implements a complete tandem-compound steam prime mover, including a speed governing system, a four-stage steam turbine, and a shaft with up to four masses.

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

The speed governing system consists of a proportional regulator, a speed relay, and a servomotor controlling the gate opening. It is similar to one of the models proposed in \[1].

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

The steam turbine has four stages, each modeled by a first-order transfer function. The first stage represents the steam chest while the three other stages represent either reheaters or crossover piping. The boiler is not modeled and boiler pressure is constant at 1.0 pu. Fractions F2 to F5 are used to distribute the turbine power to the various shaft stages:

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

The shaft models a four-mass system, which is coupled to the mass in the Synchronous Machine model for a total of five masses. The machine’s mass is labeled mass #1. The mass in the Steam Turbine and Governor block, which is closest to the machine’s mass, is mass #2, while the mass farthest from the machine is mass #5. The shaft is characterized by mass inertias H, damping factors D, and rigidity coefficients K. If you choose to simulate a single-mass shaft, the entire four-mass shaft subsystem in the Steam Turbine and Governor block is disabled and all the torque from the turbine is added together and applied to the machine’s mass:

## Ports

### Input

<table data-header-hidden><thead><tr><th width="229.822265625"></th><th></th></tr></thead><tbody><tr><td><strong>wref</strong> — Reference speed<br>Scalar</td><td>Reference speed, in pu. It is normally connected to a Constant block with the value set to 1.0 pu.</td></tr><tr><td><strong>Pref</strong> — Reference electrical power<br>Scalar</td><td>Reference electrical power in pu. It is set to a constant value corresponding to the initial active power drawn from the Synchronous Machine block connected to the Steam Turbine and Governor block.</td></tr><tr><td><strong>wm</strong> — Generator speed<br>Scalar</td><td>Generator speed, in pu. This is one of the signals in the last output of the Synchronous Machine model (internal variables).</td></tr><tr><td><strong>d_theta</strong> — Generator power angle deviation<br>Scalar</td><td>Generator power angle deviation. It is also one of the signals in the last output of the Synchronous Machine model (internal variables).</td></tr></tbody></table>

### Output

<table data-header-hidden><thead><tr><th width="229.99993896484375"></th><th></th></tr></thead><tbody><tr><td><strong>dw_5-2</strong> — Speed deviations of masses Vector</td><td>Speed deviations, in pu, of masses 5, 4, 3, and 2.</td></tr><tr><td><strong>Tr5-2</strong> — Torques transmitted by masses<br>Vector</td><td>Torques, in pu, transmitted by masses 5, 4, 3, and 2.</td></tr><tr><td><strong>gate</strong> — Gate opening<br>Scalar</td><td>Gate opening, in pu.</td></tr><tr><td><strong>Pm</strong> — Mechanical power<br>Scalar</td><td>Mechanical power Pm for the Synchronous Machine block, in pu.</td></tr></tbody></table>

### Parameters

<table data-header-hidden><thead><tr><th width="230.22216796875"></th><th></th></tr></thead><tbody><tr><td><strong>Generator type</strong> — Rotor type<br>Tandem-compound (multi-mass) (default) | Tandem-compound (single mass)</td><td>Rotor type: single mass or multimass tandem-compound. If you choose a single-mass system, the multimass shaft subsystem in the Steam Turbine and Governor block is disabled and the turbine's output torques are summed together and applied to the single mass in the Synchronous Machine block.</td></tr><tr><td><strong>Regulator gain, perm. droop, dead zone [ Kp Rp(pu) Dz(pu) ]</strong> — Gain, permanent droop, and dead-zone width<br>[ 1 0.05 0 ] (default) | vector of three nonnegative elements</td><td>Gain Kp, permanent droop Rp (pu), and dead-zone width Dz (pu). Set gain to 3 if you want to use the steam flow feedback loop. Otherwise, set gain to 1.</td></tr><tr><td><strong>Speed relay and servo-motor time constants [ Tsr Tsm ] (s)</strong> — Speed relay and gate servomotor time constants<br>[ 0.001 0.15 ] (default) | vector of two nonnegative elements</td><td>Speed relay and gate servomotor time constants Tsr (s) and Tsm (s).</td></tr><tr><td><strong>Gate opening limits [ vgmin,vgmax (pu/s) gmin,gmax (pu)]</strong> — Gate opening limits<br>[ -0.1 0.1 0 4.496] (default) | vector of four elements</td><td>Minimum and maximum gate opening speed vgmin and vgmax (both in pu/s), and minimum and maximum gate opening gmin and gmax (both in pu).</td></tr><tr><td><strong>Nominal speed of synchronous machine (rpm)</strong> — Synchronous speed of generator<br>3600 (default) | nonnegative scalar</td><td>Synchronous speed of the generator driven by the steam turbine (rpm).</td></tr><tr><td><strong>Steam turbine time constants [ T2 T3 T4 T5 ] (s)</strong> — Turbine time constants<br>[ 0 10 3.3 0.5 ] (default) | vector of four nonnegative elements</td><td>Turbine time constants T2 to T5 (s). Numbered consistently with turbine torque fractions and mass numbers; i.e., T5 is the time constant of the first turbine stage, which models the steam chest.</td></tr><tr><td><strong>Turbine torque fractions [ F2 F3 F4 F5 ]</strong> — Turbine torque fractions<br>[ 0.5 0.5 0 0 ] (default) | vector of four nonnegative elements</td><td>Turbine torque fractions F2 to F5. Must total 1, otherwise an error message appears. Fraction numbers correspond to mass numbers; i.e., F2 is the fraction of torque to be applied to mass #2 of the multimass shaft.</td></tr><tr><td><strong>Coeff. of inertia [ H2 H3 H4 H5 ] (s)</strong> — Coefficients of inertia<br>[ 1.5498 0.24894 0 0 ] (default) | vector of four nonnegative elements</td><td><div data-gb-custom-block data-tag="hint" data-style="info" class="hint hint-info"><p>Coefficients of inertia H2 to H5 (s) are associated with the masses of the multimass shaft.</p><p><strong>Dependencies</strong> To enable this parameter, set <strong>Generator type</strong> to Tandem-compound (multi-mass)If you do not want to simulate all four masses in the multimass shaft, simply set the inertia of unwanted masses to 0. The rigidity coefficient and damping factor corresponding to omitted masses are not considered. When masses are not simulated, the remaining system is “compressed” toward the generator; i.e., if only two masses are used (excluding the generator), they are masses #2 and #3. The input data for the masses considered are shifted accordingly.</p><p>In any case, inertias must be consistent with torque fractions. You cannot set an inertia to 0 and set the corresponding torque fraction to a nonzero value. However, you can set a torque fraction to 0 and set the corresponding mass inertia to a nonzero value.</p></div></td></tr><tr><td><strong>Stiffness coeff. [ K12 K23 K34 K45 ] (pu/rad)</strong> — Stiffness coefficients<br>[ 83.47 42.702 0 0 ] (default) | vector of four nonnegative elements</td><td><p>Stiffness coefficients K12 to K45 (pu/rad), associated with the masses of the multimass shaft. K12 corresponds to the rigidity coefficient between masses #1 and #2, and so on.</p><p><strong>Dependencies</strong> To enable this parameter, set <strong>Generator type</strong> to Tandem-compound (multi-mass).</p></td></tr><tr><td><strong>Damping factors [ D2 D3 D4 D5 ] (pu T/pu dw)</strong> — Daming factors<br>[ 0.3104 0.05 0 0 ]*8 (default) | vector of four nonnegative elements</td><td><p>Damping factors D2 to D5 (pu torque / puspeed deviation) associated with the masses of the multimass shaft.</p><p><strong>Dependencies</strong> To enable this parameter, set <strong>Generator type</strong> to Tandem-compound (multi-mass).</p></td></tr><tr><td><strong>Initial power and generator rotor angle [ Pm0 (pu) th0(deg) ]</strong> — Initial power and generator rotor angle<br>[2.7247e-008,-120.13] (default) | vector of two elements</td><td><p>Initial mechanical power Pm0 (pu) and initial generator angle Θe0 (degrees). Initial mechanical power is automatically updated by the load flow utility of the Powergui block. Initial angle is also computed by the load flow utility and is written in the associated Synchronous Machine block dialog box.</p><p><strong>Dependencies</strong> To enable this parameter, set <strong>Generator type</strong> to Tandem-compound (multi-mass).</p></td></tr><tr><td><strong>Initial power Pm0 (pu)</strong> — Initial mechanical power<br>250.35/555 (default) | scalar</td><td><p>Initial mechanical power. Initial mechanical power is automatically updated by the load flow utility of the Powergui block. Initial angle is also computed by the load flow utility and is written in the associated Synchronous Machine block dialog box.</p><p><strong>Dependencies</strong> To enable this parameter, set <strong>Generator type</strong> to Tandem-compound (single mass).</p></td></tr></tbody></table>

### Examples <a href="#examples" id="examples"></a>

The [Subsyncronous Resonance in Steam Turbine and Governor System](https://www.opal-rt.com/docs/smart-power-simulation-software-sps/example-models/machines/subsyncronous-resonance-in-steam-turbine-and-governor-system.md) (power\_thermal) example illustrates the use of the Steam Turbine and Governor block.

### References <a href="#references" id="references"></a>

\[1] IEEE committee report, “Dynamic models for steam and hydro turbines in power system studies,” *IEEE Transactions on Power Apparatus and Systems*, Vol. PAS-92, No. 6, 1973, pp. 1904-1915.

\[2] IEEE Subsynchronous resonance working group, “Second benchmark model for computer simulation of subsynchronous resonance,” *IEEE Transactions on Power Apparatus and Systems*, Vol. PAS-104, No. 5, 1985, pp. 1057-1066.


---

# 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/steam-turbine-and-governor.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.
