> 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/library-blocks-reference/network-machines/synchronous-machine-hydraulic.md).

# Synchronous Machine (Hydraulic)

## Description

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

The **Synchronous Machine (Hydraulic)** block, located in the **Network Machines** library, models a hydroelectric synchronous generator with integrated excitation system, power system stabilizer, speed regulator, hydraulic turbine, and shaft dynamics.

It includes **a generic synchronous generator** implementing Park-axis equations, **a generic speed regulator** for hydraulic plants, **a generic hydraulic turbine** and **shaft** models.

The block participates in load flow by using the network steady-state solution to initialize machine parameters.

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

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

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

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

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

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

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

## Mask parameters

<figure><img src="https://3623212549-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLxgTpoh7kyPmQ5vuyqD7%2Fuploads%2Fgit-blob-f3d68bae0d922a012914dd4121159b207746eb71%2Fh.jpg?alt=media" alt=""><figcaption></figcaption></figure>

{% tabs %}
{% tab title="General Controls" %}

<table><thead><tr><th width="217">Parameter</th><th>Description</th></tr></thead><tbody><tr><td><strong>Description</strong></td><td>Free-form description of the component.</td></tr><tr><td><strong>Nominal electrical power of generator</strong></td><td>Base nominal electrical power of the three-phase generator (MVA)</td></tr><tr><td><strong>Nominal mechanical power of turbine</strong></td><td>Base nominal mechanical power of the turbine(MW)</td></tr><tr><td><strong>Voltage (rms LL)</strong></td><td>Base line-to-line RMS voltage (kV)</td></tr><tr><td><strong>Angular frequency</strong></td><td>Base angular frequency (rad/s)</td></tr><tr><td><strong>Voltage</strong></td><td>Voltage reference (pu)</td></tr><tr><td><strong>Voltage reference selection</strong></td><td>Select voltage reference: Vref or Vref = Vt.</td></tr><tr><td><strong>Power filter</strong></td><td>Power reference filter time constant (s)</td></tr><tr><td><strong>Active power</strong></td><td>Active power reference (MW)</td></tr><tr><td><strong>Speed</strong></td><td>Speed reference (pu)</td></tr><tr><td><strong>Reactive power</strong></td><td>Reactive power reference (only if Vref = Vt) (Mvar).</td></tr></tbody></table>
{% endtab %}

{% tab title="Synchronous Generator" %}

<table><thead><tr><th width="200">Parameter</th><th>Description</th></tr></thead><tbody><tr><td><strong>Xd</strong></td><td>Direct-axis synchronous reactance (pu)</td></tr><tr><td><strong>X’d</strong></td><td>Direct-axis transient reactance (pu)</td></tr><tr><td><strong>X’’d</strong></td><td>Direct-axis sub-transient reactance (pu)</td></tr><tr><td><strong>T’do</strong></td><td>Direct-axis transient time constant (s)</td></tr><tr><td><strong>T’’do</strong></td><td>Direct-axis sub-transient time constant (s)</td></tr><tr><td><strong>Xq</strong></td><td>Quadrature-axis synchronous reactance (pu)</td></tr><tr><td><strong>X’q</strong></td><td>Quadrature-axis transient reactance (pu)</td></tr><tr><td><strong>X’’q</strong></td><td>Quadrature-axis sub-transient reactance (pu)</td></tr><tr><td><strong>T’q</strong></td><td>Quadrature-axis transient time constant(s)</td></tr><tr><td><strong>T’’q</strong></td><td>Quadrature-axis sub-transient time constant(s)</td></tr><tr><td><strong>Saturation</strong></td><td>Enable or disable saturation (On/Off).</td></tr><tr><td><strong>EU</strong></td><td>Voltage upper saturation limit (pu)</td></tr><tr><td><strong>EL</strong></td><td>Voltage lower saturation limit (pu)</td></tr><tr><td><strong>SGU</strong></td><td>Saturation coefficient (upper).</td></tr><tr><td><strong>SGL</strong></td><td>Saturation coefficient (lower).</td></tr><tr><td><strong>Ra</strong></td><td>Armature resistance (pu)</td></tr><tr><td><strong>XI</strong></td><td>Armature leakage reactance (pu)</td></tr><tr><td><strong>Xtfo</strong></td><td>Transformer leakage reactance (set to 0 if the generator output is regulated) (pu)</td></tr><tr><td><strong>Rtfo</strong></td><td>Transformer copper resistance (set to 0 if the generator output is regulated) (pu)</td></tr><tr><td><strong>Tdif</strong></td><td>Differentiation time constant(s)</td></tr><tr><td><strong>Lower limit of the field current</strong></td><td>Lower limit of the field current (pu)</td></tr><tr><td><strong>Upper limit of the field current</strong></td><td>Upper limit of the field current (pu)</td></tr><tr><td><strong>Initial voltage angle of external impedance</strong></td><td>Initial voltage angle of external impedance (degree)</td></tr><tr><td><strong>Frequency setting time</strong></td><td>Frequency setting time (s)</td></tr></tbody></table>
{% endtab %}

{% tab title="Exciter" %}

<table><thead><tr><th width="200">Parameter</th><th>Description</th></tr></thead><tbody><tr><td><strong>Excitation circuit</strong></td><td>Enable or disable the excitation circuit (On/Off).</td></tr><tr><td><strong>Modelling of excitation circuit</strong></td><td>Select internal or external (input pins) excitation model.</td></tr><tr><td><strong>Kp</strong></td><td>Excitation proportional gain on voltage limit.</td></tr><tr><td><strong>Tr</strong></td><td>Voltage measurement time constant (s)</td></tr><tr><td><strong>Ka</strong></td><td>Voltage regulator gain.</td></tr><tr><td><strong>Ta</strong></td><td>Voltage regulator time constant (s)</td></tr><tr><td><strong>Kf</strong></td><td>Damping filter feedback gain.</td></tr><tr><td><strong>Tf</strong></td><td>Exciter damping filter feedback time constant (s)</td></tr><tr><td><strong>ex_Efdfix</strong></td><td>Constant excitation voltage (pu)</td></tr><tr><td><strong>ex_Vtmin</strong></td><td>Minimum static limit of voltage measurement (pu)</td></tr><tr><td><strong>ex_Vtmax</strong></td><td>Maximum static limit of voltage measurement (pu)</td></tr><tr><td><strong>ex_Vrmin</strong></td><td>Minimum static limit of excitation voltage (pu)</td></tr><tr><td><strong>ex_Vrmax</strong></td><td>Maximum static limit of excitation voltage (pu)</td></tr></tbody></table>
{% endtab %}

{% tab title="Stabilizer" %}

<table><thead><tr><th width="200">Parameter</th><th>Description</th></tr></thead><tbody><tr><td><strong>Stabilizer circuit</strong></td><td>Enable or disable the stabilizer (On/Off).</td></tr><tr><td><strong>Modelling of stabilizer circuit</strong></td><td>Select internal or external (input pins) stabilizer model.</td></tr><tr><td><strong>Kap</strong></td><td>Gain on electric power.</td></tr><tr><td><strong>Kag</strong></td><td>Gain on gate opening.</td></tr><tr><td><strong>Tap</strong></td><td>Time constant on electric power (s)</td></tr><tr><td><strong>Tag</strong></td><td>Time constant on gate opening (s)</td></tr><tr><td><strong>Ks</strong></td><td>Stabilizer gain.</td></tr><tr><td><strong>Vsmin</strong></td><td>Minimum stabilizer voltage limit (pu)</td></tr><tr><td><strong>Vsmax</strong></td><td>Maximum stabilizer voltage limit (pu)</td></tr><tr><td><strong>Tw1</strong></td><td>Gate opening time constant 1 (s)</td></tr><tr><td><strong>Tw2</strong></td><td>Gate opening time constant 2 (s)</td></tr><tr><td><strong>T1</strong></td><td>Stabilizer time constant 1 (s)</td></tr><tr><td><strong>T2</strong></td><td>Stabilizer time constant 2 (s)</td></tr><tr><td><strong>T3</strong></td><td>Stabilizer time constant 3 (s)</td></tr><tr><td><strong>T4</strong></td><td>Stabilizer time constant 4 (s)</td></tr><tr><td><strong>T5</strong></td><td>Stabilizer time constant 5 (s)</td></tr><tr><td><strong>T6</strong></td><td>Stabilizer time constant 6 (s)</td></tr></tbody></table>
{% endtab %}

{% tab title="Speed Regulator" %}

<table><thead><tr><th width="201">Parameter</th><th>Description</th></tr></thead><tbody><tr><td><strong>Regulation mode</strong></td><td>Select regulation mode: gate opening or electrical power.</td></tr><tr><td><strong>Modelling of speed regulator</strong></td><td>Select internal or external (input pins) speed regulator model.</td></tr><tr><td><strong>Kg</strong></td><td>Regulator gain.</td></tr><tr><td><strong>Tp</strong></td><td>Time constant for permanent droop (s)</td></tr><tr><td><strong>sigma</strong></td><td>Permanent droop.</td></tr><tr><td><strong>delta</strong></td><td>Transient droop.</td></tr><tr><td><strong>Ts</strong></td><td>Time constant for servovalve (s)</td></tr><tr><td><strong>Tt</strong></td><td>Time constant for transient droop (s)</td></tr><tr><td><strong>Twatt</strong></td><td>Time constant for power measurements (s)</td></tr><tr><td><strong>xmin</strong></td><td>Lower gate opening limit (pu)</td></tr><tr><td><strong>xmax</strong></td><td>Upper gate opening limit (pu)</td></tr><tr><td><strong>vxmin</strong></td><td>Lower gate speed limit at closing (negative)(pu/s)</td></tr><tr><td><strong>vxmax</strong></td><td>Upper gate speed limit at closing (positive)(pu/s)</td></tr><tr><td><strong>Ta1</strong></td><td>Time constant on speed measurements 1 (s)</td></tr><tr><td><strong>Ta2</strong></td><td>Time constant on speed measurements 2 (s)</td></tr><tr><td><strong>T1</strong></td><td>Time constant for speed regulator 1 (s)</td></tr><tr><td><strong>T2</strong></td><td>Time constant for speed regulator 2 (s)</td></tr></tbody></table>
{% endtab %}

{% tab title="Hydraulic Turbine" %}

<table><thead><tr><th width="223">Parameter</th><th>Description</th></tr></thead><tbody><tr><td><strong>Turb_on</strong></td><td>Enable or disable turbine operation (On/Off).</td></tr><tr><td><strong>Beta</strong></td><td>Effect of speed variation on water height.</td></tr><tr><td><strong>Tw</strong></td><td>Water time response in the penstock (s)</td></tr></tbody></table>
{% endtab %}

{% tab title="Shaft" %}

<table><thead><tr><th width="221">Parameter</th><th>Description</th></tr></thead><tbody><tr><td><strong>Shaft_on</strong></td><td>Enable or disable shaft operation (On/Off).</td></tr><tr><td><strong>Turb_mod</strong></td><td>Turbine and shaft model: Internal or External (input pins).</td></tr><tr><td><strong>T Start</strong></td><td>Duration of turbine start-up (s)</td></tr><tr><td><strong>H</strong></td><td>Inertia constant of the shaft. Hmec is computed from H, BaseMVA, and BaseMW (see equation below) (s)</td></tr><tr><td><strong>Tgo</strong></td><td>Torque of mechanical losses of the shaft (pu/MW*s)</td></tr><tr><td><strong>wmin</strong></td><td>Minimum machine speed limit (pu)</td></tr><tr><td><strong>wmax</strong></td><td>Maximum machine speed limit (pu)</td></tr><tr><td><strong>KdStart</strong></td><td>Damping coefficient of turbine at start-up.</td></tr><tr><td><strong>Kd</strong></td><td>Damping coefficient of the shaft.</td></tr></tbody></table>
{% endtab %}

{% tab title="Load Flow" %}

<table><thead><tr><th width="242">Parameter</th><th>Description</th></tr></thead><tbody><tr><td><strong>Type of bus</strong></td><td>Bus type: Swing, PV, or PQ.</td></tr><tr><td><strong>Voltage</strong></td><td>Bus voltage magnitude (pu)</td></tr><tr><td><strong>Angle</strong></td><td>Bus voltage angle (degree)</td></tr><tr><td><strong>Reactive power minimum</strong></td><td>Minimum reactive power (Mvar)</td></tr><tr><td><strong>Reactive power maximum</strong></td><td>Maximum reactive power (Mvar)</td></tr><tr><td><strong>Active power</strong></td><td>Active power (MW)</td></tr><tr><td><strong>Reactive power</strong></td><td>Reactive power (Mvar)</td></tr></tbody></table>
{% endtab %}
{% endtabs %}

## Inputs

<table><thead><tr><th width="209">Input</th><th>Description</th></tr></thead><tbody><tr><td><strong>Efd_i</strong></td><td>Field voltage.</td></tr><tr><td><strong>Pef_i</strong></td><td>Filtered measured electrical power.</td></tr><tr><td><strong>Vstab_i</strong></td><td>Stabilizer voltage.</td></tr><tr><td><strong>w_i</strong></td><td>Angular speed.</td></tr><tr><td><strong>x_i</strong></td><td>Gate opening.</td></tr></tbody></table>

## Outputs

This block has no outputs.

## Signals available for monitoring and external I/O connections (via sensors form)

All block inputs and outputs are available as signals for monitoring and for external I/O connections.

Additional signals are also available and are listed below with their descriptions.

<table><thead><tr><th width="206">Signal</th><th>Description</th></tr></thead><tbody><tr><td><strong>Ed</strong></td><td>D-axis voltage in front of an external reactance (Xext) (pu)</td></tr><tr><td><strong>Edreg</strong></td><td>D-axis field voltage (pu)</td></tr><tr><td><strong>Efdgen</strong></td><td>Field voltage; now obsolete, replaced by Efd_label (pu)</td></tr><tr><td><strong>Eq</strong></td><td>Q-axis voltage in front of an external reactance (Xext) (pu)</td></tr><tr><td><strong>Eqreg</strong></td><td>Q-axis field voltage (pu)</td></tr><tr><td><strong>Ia</strong></td><td>Generator phase A current (pu)</td></tr><tr><td><strong>Ib</strong></td><td>Generator phase B current (pu)</td></tr><tr><td><strong>Ic</strong></td><td>Generator phase C current (pu)</td></tr><tr><td><strong>Id</strong></td><td>D-axis current (pu)</td></tr><tr><td><strong>Ifd</strong></td><td>Field current (pu)</td></tr><tr><td><strong>Iq</strong></td><td>Q-axis current (pu)</td></tr><tr><td><strong>Pe</strong></td><td>Active power (pu/MVA)</td></tr><tr><td><strong>Pef</strong></td><td>Filtered measured electrical power (pu/MVA)</td></tr><tr><td><strong>Pm</strong></td><td>Turbine mechanical power (pu/MW)</td></tr><tr><td><strong>Qe</strong></td><td>Reactive power (pu/MVA)</td></tr><tr><td><strong>Te</strong></td><td>Electrical torque (pu/MW*s)</td></tr><tr><td><strong>Tm</strong></td><td>Mechanical torque (pu/MW*s)</td></tr><tr><td><strong>Va</strong></td><td>Power system phase A voltage (pu)</td></tr><tr><td><strong>Vb</strong></td><td>Power system phase B voltage (pu)</td></tr><tr><td><strong>Vc</strong></td><td>Power system phase C voltage (pu)</td></tr><tr><td><strong>Vstab</strong></td><td>Stabilizer output voltage (pu)</td></tr><tr><td><strong>Vt</strong></td><td>Terminal voltage (pu)</td></tr><tr><td><strong>Vtd</strong></td><td>D-axis terminal voltage (pu)</td></tr><tr><td><strong>Vtq</strong></td><td>Q-axis terminal voltage (pu)</td></tr><tr><td><strong>w</strong></td><td>Angular speed (pu)</td></tr><tr><td><strong>x</strong></td><td>Gate opening (pu)</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/hypersim/library-blocks-reference/network-machines/synchronous-machine-hydraulic.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.
