> 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-pu-fundamental.md).

# Synchronous Machine (pu Fundamental)

## Description

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

The **Synchronous Machine (SM)** block, located in the **Network Machines** library, models a synchronous machine using a Norton equivalent (non-iterative) representation with electrical parameters specified in per unit. The machine is controlled externally via the mechanical power or mechanical torque input and the excitation input.

Features include:

* **up to three damper windings** (one on the d-axis and two on the q-axis),
* **magnetic saturation** (total, independent, or d-axis only),
* **stator connections** (wye with neutral, wye grounded, or delta),
* and **up to six masses including the exciter mass**.

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

The synchronous machine participates in load flow as a source behind an impedance and can operate as a swing bus, PV node, or PQ node.

{% hint style="info" %}
**This model does not take into account hysteresis.** Under certain conditions some models of the machine may differ since the model of the synchronized machine-implemented is non-iterative.
{% endhint %}

### Base values for per-unit conversion

| Base value                                                               | Description                                     |
| ------------------------------------------------------------------------ | ----------------------------------------------- |
| $$S\_{base} = S\_{rated}$$                                               | Base power                                      |
| $$V\_{base\_stator} = \sqrt{\frac{2}{3}},V\_{LL}$$                       | Base stator voltage (peak) for wye connection   |
| $$V\_{base\_stator} = \sqrt{2}, V\_{LL}$$                                | Base stator voltage (peak) for delta connection |
| $$I\_{base\_stator} = \frac{S\_{base}}{3, V\_{base\_stator}}$$           | Base stator current (peak)                      |
| $$T\_{base} = \frac{3}{2}, \frac{p}{2}, \frac{S\_{base}}{\omega\_{sm}}$$ | Base mechanical torque                          |
| $$\Psi\_{base} = \frac{V\_{base\_stator}}{\omega\_{s}}$$                 | Base flux (peak)                                |

### Model equations

The Park transform is defined as follows:

$$
T = \frac{2}{3} \begin{bmatrix} \cos \theta\_{s} & \cos \left(\theta\_{s}-\frac{2 \pi}{3}\right) & \cos \left(\theta\_{s}+\frac{2 \pi}{3}\right) \\\[6pt] -\sin \theta\_{s} & -\sin \left(\theta\_{s}-\frac{2 \pi}{3}\right) & -\sin \left(\theta\_{s}+\frac{2 \pi}{3}\right) \\\[6pt]\ \frac{1}{2} & \frac{1}{2} & \frac{1}{2} \end{bmatrix}
$$

where $$\theta\_s$$ is the angle between phase a and the d-axis.

## Electrical system (p.u. and generating convention) equations

$$
v\_{q} = -r\_{s} i\_{q} + \frac{\omega\_{r}}{\omega\_{s}} \psi\_{d} + \frac{1}{\omega\_{s}} \frac{d \psi\_{q}}{dt} \\\[8pt] v\_{d} = -r\_{s} i\_{d} - \frac{\omega\_{r}}{\omega\_{s}} \psi\_{q} + \frac{1}{\omega\_{s}} \frac{d \psi\_{d}}{dt}  \\\[8pt] v\_{0} = -r\_{s} i\_{0} + \frac{1}{\omega\_{s}} \frac{d \psi\_{0}}{dt}  \\\[8pt] 0 = r\_{D1} i\_{D1} + \frac{1}{\omega\_{s}} \frac{d \psi\_{D1}}{dt}  \\\[8pt]
0 = r\_{D2} i\_{D2} + \frac{1}{\omega\_{s}} \frac{d \psi\_{D2}}{dt}  \\\[8pt]
0 = r\_{Q1} i\_{Q1} + \frac{1}{\omega\_{s}} \frac{d \psi\_{Q1}}{dt}  \\\[8pt]
0 = r\_{Q2} i\_{Q2} + \frac{1}{\omega\_{s}} \frac{d \psi\_{Q2}}{dt}
$$

## Flux current (pu)

$$
\psi\_{q} = -x\_{q} i\_{q} + x\_{mq} i\_{Q1} + x\_{mq} i\_{Q2}\\\[8pt]
\psi\_{d} = -x\_{d} i\_{d} + x\_{md} i\_{D1} + x\_{md} i\_{D2} + \psi\_{f}\\\[8pt] \psi\_{0} = -x\_{0} i\_{0}\\\[8pt]
\psi\_{D1} = -x\_{md} i\_{d} + x\_{D1} i\_{D1} + x\_{md} i\_{D2} + \psi\_{f}\\\[8pt]
\psi\_{D2} = -x\_{md} i\_{d} + x\_{D2} i\_{D2} + x\_{md} i\_{D1} + \psi\_{f}\\\[8pt]
\psi\_{Q1} = -x\_{mq} i\_{q} + x\_{Q1} i\_{Q1} + x\_{mq} i\_{Q2}\\\[8pt]
\psi\_{Q2} = -x\_{mq} i\_{q} + x\_{Q2} i\_{Q2} + x\_{mq} i\_{Q1}
$$

\
where $$\omega\_r$$ is the electric speed (rad / s) and $$\psi\_f$$ the flux produced by the permanent magnets (pu).

## Reactance relationships (pu)

Since the flux equations are in per-unit, any reactance can be equivalently specified as an inductance.

$$
x\_{d} = x\_{md} + x\_{l} \\\[8pt]
x\_{q} = x\_{mq} + x\_{l} \\\[8pt]
x\_{D1} = x\_{md} + x\_{lD1} \\\[8pt]
x\_{D2} = x\_{md} + x\_{lD2}\\\[8pt]
x\_{Q1} = x\_{mq} + x\_{lQ1} \\\[8pt]
x\_{Q2} = x\_{mq} + x\_{lQ2}
$$

## Electromagnetic torque (pu)

$$
t\_{em} = \psi\_{d} i\_{q} - \psi\_{q} i\_{d}
$$

## Mechanical equations (mass i)

$$
2 H\_{i} \frac{d \omega\_{im}}{dt} = \\\[8pt]
T\_{im} - T\_{em} - K\_{di} \omega\_{im} - D\_{i}(\omega\_{im} - \omega\_{sm}) - D\_{i,i-1}(\omega\_{im} - \omega\_{(i-1)m}) - D\_{i,i+1}(\omega\_{im} - \omega\_{(i+1)m})\\\[8pt] - K\_{i,i-1}(\delta\_{im} - \delta\_{(i-1)m}) - K\_{i,i+1}(\delta\_{im} - \delta\_{(i+1)m})\\\[10pt]
\frac{d \delta\_{im}}{dt} = \omega\_{im} - \omega\_{sm}
$$

Where: $$T\_{im}$$ is the mechanical torque developed on the i-th mass (Nm); $$T\_{em}$$ is the electromagnetic torque developed by the PMSM (Nm); $$\omega\_{im}$$ is the mechanical speed of mass i (rad/s); $$\omega\_{sm}$$ is the mechanical synchronous speed (rad/s); $$\delta\_{im}$$ is the mechanical angle of mass i; $$K\_{di}$$ is the absolute damping coefficient (Nm/rad/s); $$D\_{i}$$ is the self damping coefficient (Nm/rad/s); $$D\_{i,j}$$ is the mutual damping coefficient (Nm/rad/s); $$K\_{i,j}$$ is the angular stiffness (Nm/rad); $$H\_{i}$$ is the inertia constant (s).

## No-load rotor voltage (pu), seen from the stator

$$
E\_{fd} = \varpi\_{r},L^{uns}*{md},\frac{v{f}}{r*{f}}
$$

## Field voltage independent of speed deviation

$$
V\_{fd} = L^{uns}*{md},\frac{v{f}}{r*{f}}
$$

## Field voltage dependent on speed deviation

$$
E\_{fd} = \varpi\_{r},V\_{fd}
$$

## At steady state and fundamental frequency (ωr = 1):

$$
E\_{fd} = V\_{fd}
$$

{% hint style="info" %}
When the machine operates as a motor, the mechanical torque is negative; it is positive in generator mode.
{% endhint %}

## Mask parameters

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

{% tabs %}
{% tab title="Electrical parameters" %}

<table><thead><tr><th width="210">Parameter</th><th>Description</th></tr></thead><tbody><tr><td><strong>Base power</strong></td><td>Nominal power (MVA)</td></tr><tr><td><strong>Base voltage</strong></td><td>Nominal line-to-line voltage (kV)</td></tr><tr><td><strong>Frequency</strong></td><td>Nominal frequency (Hz)</td></tr><tr><td><strong>Number of poles</strong></td><td>Number of poles</td></tr><tr><td><strong>d-axis damper</strong></td><td>Number of dampers on d-axis (up to 1)</td></tr><tr><td><strong>q-axis damper</strong></td><td>Number of dampers on q-axis (up to 2)</td></tr><tr><td><strong>Stator connection</strong></td><td>Stator winding connection (wye or delta)</td></tr><tr><td><strong>Field current</strong></td><td>Field current that produces 1 pu air-gap voltage, used to compute the pu values of the saturation table currents (A) (not available in the current version)</td></tr><tr><td><strong>Rs</strong></td><td>Stator resistance (pu)</td></tr><tr><td><strong>Xl</strong></td><td>Stator leakage reactance (pu)</td></tr><tr><td><strong>X0</strong></td><td>Zero-sequence reactance (pu)</td></tr><tr><td><strong>Xc</strong></td><td>Canay reactance (pu)</td></tr><tr><td><strong>Xd</strong></td><td>d-axis synchronous reactance (pu)</td></tr><tr><td><strong>Xq</strong></td><td>q-axis synchronous reactance (pu)</td></tr><tr><td><strong>Xf</strong></td><td>Field reactance (pu)</td></tr><tr><td><strong>Rf</strong></td><td>Field resistance (pu)</td></tr><tr><td><strong>XD</strong></td><td>D-damper reactance (pu) (required when d-axis damper is included; ignored otherwise)</td></tr><tr><td><strong>RD</strong></td><td>D-damper resistance (pu) (required when d-axis damper is included; ignored otherwise)</td></tr><tr><td><strong>XQ1</strong></td><td>Q1-damper reactance (pu) (required when one q-axis damper is included; ignored otherwise)</td></tr><tr><td><strong>RQ1</strong></td><td>Q1-damper resistance (pu) (required when one q-axis damper is included; ignored otherwise)</td></tr><tr><td><strong>XQ2</strong></td><td>Q2-damper reactance (pu) (required when two q-axis dampers are included; ignored otherwise)</td></tr><tr><td><strong>RQ2</strong></td><td>Q2-damper resistance (pu) (required when two q-axis dampers are included; ignored otherwise)</td></tr></tbody></table>
{% endtab %}

{% tab title="Mechanical data" %}

<table><thead><tr><th width="175">Parameter</th><th>Description</th></tr></thead><tbody><tr><td><strong>Number of mass</strong></td><td>Number of masses on the shaft</td></tr><tr><td><strong>H</strong></td><td>Inertia constants (s). The sequence depends on the number of masses: Generator, Low Pressure Turbine B (LPB), Low Pressure Turbine A (LPA), Intermediate Pressure (IP) Turbine, High Pressure (HP) Turbine.</td></tr><tr><td><strong>Kd</strong></td><td>Absolute damping coefficients (Nm/rad/s) for: Generator, Turbine LPB, Turbine LPA, Turbine IP, Turbine HP.</td></tr><tr><td><strong>Kij</strong></td><td>Stiffness coefficients (Nm/rad) for: Generator–Turbine LPB, LPB–Turbine LPA, Turbine LPA–Turbine IP, Turbine IP–Turbine HP.</td></tr><tr><td><strong>D</strong></td><td>Self damping coefficients (Nm/rad/s) for: Generator, Turbine LPB, Turbine LPA, Turbine IP, Turbine HP.</td></tr><tr><td><strong>Dij</strong></td><td>Mutual speed deviation damping coefficients (Nm/rad/s) for: Generator–Turbine LPB, LPB–Turbine LPA, Turbine LPA–Turbine IP, Turbine IP–Turbine HP.</td></tr><tr><td><strong>F</strong></td><td>Fractions of the total external torque applied to each mass in order: LPB turbine, LPA turbine, IP turbine, HP turbine. The sum of all fractions must equal 1.</td></tr><tr><td><strong>Exciter Type</strong></td><td>Type of exciter (rotating or static)</td></tr><tr><td><strong>H (Exciter)</strong></td><td>Exciter inertia constant (s)</td></tr><tr><td><strong>Kd (Exciter)</strong></td><td>Exciter absolute damping coefficient (Nm/rad/s)</td></tr><tr><td><strong>D (Exciter)</strong></td><td>Exciter self damping coefficient (Nm/rad/s)</td></tr><tr><td><strong>D (Generator–Exciter)</strong></td><td>Mutual speed deviation damping coefficient between generator and exciter (Nm/rad/s)</td></tr><tr><td><strong>K (Generator–Exciter)</strong></td><td>Stiffness coefficient between generator and exciter (Nm/rad)</td></tr></tbody></table>

{% hint style="info" %}
Number of mass allows adding up to five additional masses on the machine shaft. Selecting one mass simulates only the machine. Selecting two masses simulates the machine and the Low Pressure Turbine A; adding more masses follows the predefined order.
{% endhint %}
{% endtab %}

{% tab title="Control" %}

<table><thead><tr><th width="220">Parameter</th><th>Description</th></tr></thead><tbody><tr><td><strong>Excitation control</strong></td><td><p>The excitation can be:</p><ul><li>Constant: constant field voltage from load flow</li><li>External: Field voltage (Efd) from exciter</li><li>External: Field voltage (Vfd) from exciter</li></ul></td></tr><tr><td><strong>Mechanical control</strong></td><td><p>The mechanical input can be:</p><ul><li>Constant: constant mechanical power from load flow</li><li>Mechanical power: mechanical power from prime mover</li><li>Mechanical torque: mechanical torque from prime mover</li></ul></td></tr></tbody></table>
{% endtab %}

{% tab title="Saturation" %}

<table><thead><tr><th width="210">Parameter</th><th>Description</th></tr></thead><tbody><tr><td><strong>Saturation</strong></td><td>Enable or disable independent, total, or d-axis-only saturation</td></tr><tr><td><strong>d-axis saturation curve points</strong></td><td>Number of d-axis saturation curve points (maximum 10)</td></tr><tr><td><strong>Imd</strong></td><td>d-axis magnetizing current points of the saturation curve (pu)</td></tr><tr><td><strong>Fluxmd</strong></td><td>d-axis magnetizing flux points of the saturation curve (pu)</td></tr><tr><td><strong>q-axis saturation curve points</strong></td><td>Number of q-axis saturation curve points (maximum 10)</td></tr><tr><td><strong>Imq</strong></td><td>q-axis magnetizing current points of the saturation curve (pu)</td></tr><tr><td><strong>Fluxmq</strong></td><td>q-axis magnetizing flux points of the saturation curve (pu)</td></tr></tbody></table>

{% hint style="info" %}
The magnetizing current of d or q axes is defined in pu based on the rotor (exciter) current. For example, if a 1000 A field current produces 1 pu air-gap flux and a 1500 A field current produces 1.5 pu, then:

$$\frac{1500,\mathrm{A}}{1000,\mathrm{A}} = 1.5,\mathrm{pu}$$
{% endhint %}
{% endtab %}

{% tab title="Load flow" %}

<table><thead><tr><th width="210">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>Desired terminal voltage (pu)</td></tr><tr><td><strong>Angle</strong></td><td>Desired terminal voltage angle (deg)</td></tr><tr><td><strong>Active power</strong></td><td>Desired active power at the machine terminals (MW)</td></tr><tr><td><strong>Reactive power</strong></td><td>Desired reactive power at the machine terminals (MVAr)</td></tr><tr><td><strong>Minimum reactive power</strong></td><td>Minimum reactive power at the machine terminals (MVAr)</td></tr><tr><td><strong>Maximum reactive power</strong></td><td>Maximum reactive power at the machine terminals (MVAr)</td></tr></tbody></table>
{% endtab %}
{% endtabs %}

## Conserving ports

<table><thead><tr><th width="202">Port</th><th>Description</th></tr></thead><tbody><tr><td><strong>S</strong></td><td>AC stator connector (3-phase)</td></tr><tr><td><strong>N</strong></td><td>AC neutral connector (1-phase)</td></tr></tbody></table>

## Inputs

<table><thead><tr><th width="200">Input</th><th>Description</th></tr></thead><tbody><tr><td><strong>Vfd_i</strong></td><td>Speed-independent field voltage</td></tr><tr><td><strong>Tm_i</strong></td><td>Mechanical torque</td></tr><tr><td><strong>Pm_i</strong></td><td>Mechanical power</td></tr><tr><td><strong>Efd_i</strong></td><td>Speed-dependent field voltage</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="201">Signal</th><th>Description</th></tr></thead><tbody><tr><td><strong>Efd</strong></td><td>Speed-dependent field voltage (pu)</td></tr><tr><td><strong>Efd_i</strong></td><td>Speed-dependent field voltage of the exciter (pu)</td></tr><tr><td><strong>Efd_ss</strong></td><td>Exciter field voltage calculated during load flow; used to initialize the exciter blocks (pu)</td></tr><tr><td><strong>Flux0s</strong></td><td>Zero-sequence stator flux (pu)</td></tr><tr><td><strong>Fluxds</strong></td><td>d-axis stator flux (pu)</td></tr><tr><td><strong>Fluxm</strong></td><td>Mutual magnetization flux (pu)</td></tr><tr><td><strong>Fluxmd</strong></td><td>d-axis mutual magnetization flux (pu)</td></tr><tr><td><strong>Fluxmq</strong></td><td>q-axis mutual magnetization flux (pu)</td></tr><tr><td><strong>Fluxqs</strong></td><td>q-axis stator flux (pu)</td></tr><tr><td><strong>I0s</strong></td><td>Zero-sequence stator current (pu)</td></tr><tr><td><strong>ID</strong></td><td>d-axis damper current (pu)</td></tr><tr><td><strong>IQ1</strong></td><td>Q1-axis damper current (pu)</td></tr><tr><td><strong>IQ2</strong></td><td>Q2-axis damper current (pu)</td></tr><tr><td><strong>Ias</strong></td><td>Phase-A stator current (pu)</td></tr><tr><td><strong>Ibs</strong></td><td>Phase-B stator current (pu)</td></tr><tr><td><strong>Ics</strong></td><td>Phase-C stator current (pu)</td></tr><tr><td><strong>Ids</strong></td><td>d-axis stator current (pu)</td></tr><tr><td><strong>If</strong></td><td>Field current (pu)</td></tr><tr><td><strong>Im</strong></td><td>Magnetizing current (pu)</td></tr><tr><td><strong>Imd</strong></td><td>d-axis magnetizing current (pu)</td></tr><tr><td><strong>Imq</strong></td><td>q-axis magnetizing current (pu)</td></tr><tr><td><strong>Iqs</strong></td><td>q-axis stator current (pu)</td></tr><tr><td><strong>Pm_i</strong></td><td>Mechanical power of the turbine (pu)</td></tr><tr><td><strong>Pmec</strong></td><td>Mechanical power of the turbine (Nm)</td></tr><tr><td><strong>Pmec_pu</strong></td><td>Mechanical power of the turbine (pu)</td></tr><tr><td><strong>Pmec_ss</strong></td><td>Mechanical power of the turbine calculated during load flow; used to initialize the turbine blocks (pu)</td></tr><tr><td><strong>PowerAngle</strong></td><td>Machine load angle (rad)</td></tr><tr><td><strong>Ps</strong></td><td>Active power (W)</td></tr><tr><td><strong>Ps_pu</strong></td><td>Active power (pu)</td></tr><tr><td><strong>Qs</strong></td><td>Reactive power (VAr)</td></tr><tr><td><strong>RotorAngle</strong></td><td>Rotor angle relative to the synchronous reference frame (synchronous machine) (rad)</td></tr><tr><td><strong>RotorAngle_EXC</strong></td><td>Rotor angle relative to the synchronous reference frame (exciter mass) (rad)</td></tr><tr><td><strong>RotorAngle_HP</strong></td><td>Rotor angle relative to the synchronous reference frame (HP turbine mass) (rad)</td></tr><tr><td><strong>RotorAngle_IP</strong></td><td>Rotor angle relative to the synchronous reference frame (IP turbine mass) (rad)</td></tr><tr><td><strong>RotorAngle_LPA</strong></td><td>Rotor angle relative to the synchronous reference frame (LPA turbine mass) (rad)</td></tr><tr><td><strong>RotorAngle_LPB</strong></td><td>Rotor angle relative to the synchronous reference frame (LPB turbine mass) (rad)</td></tr><tr><td><strong>Tem</strong></td><td>Electromagnetic torque of the synchronous machine (Nm)</td></tr><tr><td><strong>Tem_pu</strong></td><td>Electromagnetic torque of the synchronous machine (pu)</td></tr><tr><td><strong>Texc</strong></td><td>Electromagnetic torque of the exciter (pu)</td></tr><tr><td><strong>ThetaS</strong></td><td>Electrical rotor angle (angle between phase-A axis and d axis) (rad)</td></tr><tr><td><strong>Tm_i</strong></td><td>Mechanical torque of the machine (Nm)</td></tr><tr><td><strong>Tmec</strong></td><td>Mechanical torque of the turbine (Nm)</td></tr><tr><td><strong>Tmec_GEN_EXC</strong></td><td>Mechanical torque between the synchronous machine mass and the exciter (pu)</td></tr><tr><td><strong>Tmec_HP</strong></td><td>Mechanical torque applied to the HP turbine mass (pu)</td></tr><tr><td><strong>Tmec_HP_IP</strong></td><td>Mechanical torque between HP and IP turbine masses (pu)</td></tr><tr><td><strong>Tmec_IP</strong></td><td>Mechanical torque applied to the IP turbine mass (pu)</td></tr><tr><td><strong>Tmec_IP_LPA</strong></td><td>Mechanical torque between IP and LPA turbine masses (pu)</td></tr><tr><td><strong>Tmec_LPA</strong></td><td>Mechanical torque applied to the LPA turbine mass (pu)</td></tr><tr><td><strong>Tmec_LPA_LPB</strong></td><td>Mechanical torque between LPA and LPB turbine masses (pu)</td></tr><tr><td><strong>Tmec_LPB</strong></td><td>Mechanical torque applied to the LPB turbine mass (pu)</td></tr><tr><td><strong>Tmec_LPB_GEN</strong></td><td>Mechanical torque between the LPB turbine mass and the synchronous machine (pu)</td></tr><tr><td><strong>Tmec_pu</strong></td><td>Mechanical torque of the turbine (pu)</td></tr><tr><td><strong>V0s</strong></td><td>Zero-sequence stator voltage (pu)</td></tr><tr><td><strong>Vds</strong></td><td>d-axis stator voltage (pu)</td></tr><tr><td><strong>Vqs</strong></td><td>q-axis stator voltage (pu)</td></tr><tr><td><strong>Vfd</strong></td><td>Speed-independent field voltage (pu)</td></tr><tr><td><strong>Vfd_i</strong></td><td>Speed-independent field voltage of the exciter (pu)</td></tr><tr><td><strong>Vt</strong></td><td>Terminal voltage of the machine (pu)</td></tr><tr><td><strong>Wm</strong></td><td>Mechanical or electrical speed of the machine (pu)</td></tr><tr><td><strong>Wm_EXC</strong></td><td>Mechanical or electrical speed of the exciter (pu)</td></tr><tr><td><strong>Wm_HP</strong></td><td>Mechanical or electrical speed of the HP turbine (pu)</td></tr><tr><td><strong>Wm_IP</strong></td><td>Mechanical or electrical speed of the IP turbine (pu)</td></tr><tr><td><strong>Wm_LPA</strong></td><td>Mechanical or electrical speed of the LPA turbine (pu)</td></tr><tr><td><strong>Wm_LPB</strong></td><td>Mechanical or electrical speed of the LPB turbine (pu)</td></tr><tr><td><strong>Wrpm</strong></td><td>Mechanical speed of the machine (r/min)</td></tr></tbody></table>

## References

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

\[2] G. Sybille, Tarik Zabaiou, "Emergency Diesel-Generator and Asynchronous Motor", Mathworks demo example, version: 2017B

\[3] *Power System Control and Stability*, 2<sup>nd</sup> edition, P. Mr. Anderson, A.A.Fouad, IEEE press 2003


---

# 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-pu-fundamental.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.
