> 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/synchronous-machine-pu-standard.md).

# Synchronous Machine pu Standard

## Description

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

The **Synchronous Machine pu Standard** block, located in the **OPAL-RT SPS Software/Electrical Machines** library, models a synchronous machine in generator or motor mode using standard parameters in pu units. The operating mode is dictated by the sign of the mechanical power (positive for generator mode or negative for motor mode).

The electrical part of the machine is represented by a sixth-order state-space model and the mechanical part is the same as in the Simplified Synchronous Machine block.

For more information on the pu units system, see [Per-Unit System of Units](https://www.opal-rt.com/docs/smart-power-simulation-software-sps/get-started/per-unit-system-of-units.md).

The model takes into account the dynamics of the stator, field, and damper windings. The equivalent circuit of the model is represented in the rotor reference frame (*qd* frame). Stator windings are connected in wye to an internal neutral point. All rotor parameters and electrical quantities are viewed from the stator and identified by primed variables. The subscripts are:

* *d,q* — *d*- and *q*-axis quantity
* *R,s* — Rotor and stator quantity
* *l,m* — Leakage and magnetizing inductance
* *f,k* — Field and damper winding quantity The electrical model of the machine is shown in these diagrams.

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

### Dynamic Model with Unequal Mutual Inductance

The conventional theory of synchronous machine modeling for stability analysis assumes that the mutual inductances between the armature, damper, and field on direct-axis windings are identical. Generally, damper windings are near the air gap, and as a result the flux linking damper circuits are almost equal to the flux linking armature.

This hypothesis produces acceptable outcomes for a wide range of stability studies, especially those on the side of the network.

However, when it comes to field current studies, there is considerable error. The equivalent circuit dynamic model of a synchronous machine may include an additional inductance representing the difference between field-damper and field-armature mutual inductances on the *D*-axis \[1].

This inductance is typically called *Canay inductance*. Canay inductance corresponds to the leakage flux, *ΦC*, in the following figure and is interpreted as a corrective element in an equivalent model that may have a negative value \[2].

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

The IEEE® standard 1110-2002 \[3] presents the direct and quadratic axes of the synchronous machine dynamic model as shown in the diagrams.

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

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

The relevant equations are:

$$
V\_d = -i\_d R\_s - \omega \psi\_q + \frac{d\psi\_d}{dt} \\\[8pt]
V\_q = -i\_q R\_s + \omega \psi\_d + \frac{d\psi\_q}{dt}\\\[8pt]
V\_0 = -i\_0 R\_0 + \frac{d\psi\_0}{dt}\\\[8pt]
V\_{fd} = \frac{d\psi\_{fd}}{dt} + R\_{fd} i\_{fd}\\\[8pt]
0 = \frac{d\psi\_{kq1}}{dt} + R\_{kq1} i\_{kq1}\\\[8pt]
0 = \frac{d\psi\_{kq2}}{dt} + R\_{kq2} i\_{kq2}
$$

$$
\begin{bmatrix}
\psi\_d \\
\psi\_{kd1} \\
\psi\_{fd}
\end{bmatrix}
=============

\begin{bmatrix}
L\_{md} + L\_l & L\_{md} & L\_{md} \\
L\_{md} & L\_{kd} + L\_{l,kd1} + L\_{md} & L\_{md} \\
L\_{md} & L\_{md} & L\_{f,1d} + L\_{l,f1d} + L\_{md}
\end{bmatrix}
\begin{bmatrix}
-i\_d \\
i\_{kd1} \\
i\_{fd}
\end{bmatrix}
$$

$$
\begin{bmatrix}
\psi\_q \\
\psi\_{kq1} \\
\psi\_{kq2}
\end{bmatrix}
=============

\begin{bmatrix}
L\_{mq} + L\_l & L\_{mq} & L\_{mq} \\
L\_{mq} & L\_{mq} + L\_{lkq1} & L\_{mq} \\
L\_{mq} & L\_{mq} & L\_{mq} + L\_{lkq2}
\end{bmatrix}
\begin{bmatrix}
-i\_q \\
i\_{kq1} \\
i\_{kq2}
\end{bmatrix}
$$

## Assumptions and Limitations

In discrete systems, when you set the **Discrete solver model** parameter of a Synchronous Machine block to Trapezoidal non iterative, you might have to connect a small parasitic resistive load at the machine terminals to avoid numerical oscillations.

Large sample times require larger loads. The minimum resistive load is proportional to the sample time.

As a rule of thumb, remember that with a 25 μs time step on a 60 Hz system, the minimum load is approximately 2.5% of the machine nominal power. For example, a 200 MVA synchronous machine in a power system discretized with a 50 μs sample time requires approximately 5% of resistive load or 10 MW. If the sample time is reduced to 20 μs, a resistive load of 4 MW should be sufficient.

However, if you set the **Discrete solver model** parameter of a Synchronous Machine block to Trapezoidal iterative (alg. loop), you can use a negligible parasitic load (below 0.1% of nominal power) while preserving numerical stability. This iterative model produces an algebraic loop and results in slower simulation speed.

## Ports

### Input

<table data-header-hidden><thead><tr><th width="250.48883056640625"></th><th></th></tr></thead><tbody><tr><td><strong>Pm</strong> — Mechanical power<br>Scalar</td><td><p>Mechanical power at the machine's shaft, in pu. In generator mode, this input can be a positive constant or function or the output of a prime mover block (see the <a href="https://www.opal-rt.com/docs/smart-power-simulation-software-sps/blocks-functions-tools/machines/blocks/machines-control/synchronous-machines-control/hydraulic-turbine-and-governor.md">Hydraulic Turbine and Governor</a> or <a href="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</a> blocks).</p><p>In motor mode, this input is usually a negative constant or function.</p><p><strong>Dependencies</strong> To enable this port, set the <strong>Mechanical input</strong> parameter (<strong>Configuration</strong> tab) to Mechanical power Pm.</p></td></tr><tr><td><strong>w</strong> — Machine speed<br>Scalar</td><td><p>Machine speed, in rad/s.</p><p><strong>Dependencies</strong> To enable this port, set the <strong>Mechanical input</strong> parameter (<strong>Configuration</strong> tab) to Speed w.</p></td></tr><tr><td><strong>Vf</strong> — Field voltage<br>Scalar</td><td><p>Field voltage, in pu. This voltage can be supplied by a voltage regulator in generator mode (see 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).</p><p>In motor mode, this value of this input is usually a constant.</p></td></tr></tbody></table>

#### Output

<table data-header-hidden><thead><tr><th width="249.88897705078125"></th><th></th></tr></thead><tbody><tr><td><strong>m</strong> — Measurement signal<br>24-element vector</td><td><p>Measurement signals, returned as a 24-element vector. You can demultiplex these signals by using the Bus Selector block.</p><p>The angular deviation of the rotor angle theta represents the electrical angle giving the instantaneous position of the rotor with respect to a common reference rotating at synchronous speed.</p><p>This angle is useful in stability studies to measure the relative positions of the rotors of different machines in a network.</p><p>The positions of the rotors are then measured with respect to the theta position of a given machine chosen as a reference.</p></td></tr></tbody></table>

<table data-header-hidden><thead><tr><th width="250.4444580078125"></th><th></th></tr></thead><tbody><tr><td><strong>Measurement signal name</strong></td><td><strong>Definition</strong></td></tr><tr><td><strong>ias</strong></td><td>Stator current is_a (pu)</td></tr><tr><td><strong>ibs</strong></td><td>Stator current is_b (pu)</td></tr><tr><td><strong>ics</strong></td><td>Stator current is_c (pu)</td></tr><tr><td><strong>iq</strong></td><td>Stator current iq (pu)</td></tr><tr><td><strong>id</strong></td><td>Stator current id (pu)</td></tr><tr><td><strong>ifd</strong></td><td>Field current ifd (pu)</td></tr><tr><td><strong>ikq1</strong></td><td>Damper winding current ikq1 (pu)</td></tr><tr><td><strong>Ikq2</strong></td><td>Damper winding current ikq2 (pu)</td></tr><tr><td><strong>ikd</strong></td><td>Damper winding current ikd (pu)</td></tr><tr><td><strong>phimq</strong></td><td>Mutual flux phimq (pu)</td></tr><tr><td><strong>phimd</strong></td><td>Mutual flux phimd (pu)</td></tr><tr><td><strong>vq</strong></td><td>Stator voltage vq (pu)</td></tr><tr><td><strong>vd</strong></td><td>Stator voltage vd (pu)</td></tr><tr><td><strong>lmq</strong></td><td>Lmq saturated inductance (pu)</td></tr><tr><td><strong>lmd</strong></td><td>Lmd saturated inductance (pu)</td></tr><tr><td><strong>dtheta</strong></td><td>Rotor angle deviation d_theta (rad)</td></tr><tr><td><strong>w</strong></td><td>Rotor speed wm (pu)</td></tr><tr><td><strong>Pe</strong></td><td>Electrical power Pe (pu)</td></tr><tr><td><strong>dw</strong></td><td>Rotor speed deviation dw (pu)</td></tr><tr><td><strong>theta</strong></td><td>Rotor mechanical angle theta (degree)</td></tr><tr><td><strong>Te</strong></td><td>Electromagnetic torque Te (pu)</td></tr><tr><td><strong>delta</strong></td><td>Load angle delta (degree)</td></tr><tr><td><strong>Pe0</strong></td><td>Output active power Peo (pu)</td></tr><tr><td><strong>Qe0</strong></td><td>Output reactive power Qeo (pu)</td></tr></tbody></table>

### Conserving

<table data-header-hidden><thead><tr><th width="221"></th><th></th></tr></thead><tbody><tr><td><strong>A</strong> — Phase A electric terminal<br>SPS electrical</td><td>SPS electrical conserving port associated with the phase A electrical terminal.</td></tr><tr><td><strong>B</strong> — Phase B electric terminal<br>SPS electrical</td><td>SPS electrical conserving port associated with the phase B electrical terminal.</td></tr><tr><td><strong>C</strong> — Phase C electric terminal<br>SPS electrical</td><td>SPS electrical conserving port associated with the phase C electrical terminal.</td></tr><tr><td><strong>S</strong> — Machine rotor shaft<br>Mechanical</td><td><p>Mechanical rotational conserving port associated with the machine rotor shaft.</p><p><strong>Dependencies</strong> To enable this port, set the <strong>Mechanical input</strong> parameter (<strong>Configuration</strong> tab) to Mechanical rotational port.</p></td></tr></tbody></table>

## Parameters

Specify standard parameters, also known as operational parameters, of the synchronous machine (such as steady-state, transient, and/or subtransient reactances and time constants) as inputs to the block. Typically, machine manufacturers provide operational parameters.

In power system analysis software, the synchronous machine equations are commonly solved using the direct-quadrature-zero transformation technique. A data translation technique calculates fundamental parameters from standard parameters \[2], \[3].

### Configuration

<table data-header-hidden><thead><tr><th width="250" valign="top"></th><th></th></tr></thead><tbody><tr><td valign="top"><strong>Preset model</strong> — Electrical and mechanical parameters<br>No (default) | 01: 50Hz 400V 8.1kVA 1500RPM | 02: 50Hz 400V 16kVA 1500RPM | ...</td><td><p>Set of predetermined electrical and mechanical parameters for various synchronous machine ratings of power (kVA), phase-to-phase voltage (V), frequency (Hz), and rated speed (rpm).</p><p>Select one of the preset models to load the corresponding electrical and mechanical parameters.</p><p>Choices are:</p><ul><li>01: 50Hz 400V 8.1kVA 1500RPM</li><li>02: 50Hz 400V 16kVA 1500RPM</li><li>03: 50Hz 400V 31.3kVA 1500RPM</li><li>04: 50Hz 400V 42.5kVA 1500RPM</li><li>05: 50Hz 400V 60kVA 1500RPM</li><li>06: 50Hz 400V 85kVA 1500RPM</li><li>07: 50Hz 400V 250kVA 1500RPM</li><li>08: 50Hz 400V 325kVA 1500RPM</li><li>09: 50Hz 400V 670kVA 1500RPM</li><li>10: 50Hz 400V 910kVA 1500RPM</li><li>11: 50Hz 400V 1320kVA 1500RPM</li><li>12: 50Hz 400V 2000kVA 1500RPM</li><li>13: 60Hz 460V 10.2kVA 1800RPM</li><li>14: 60Hz 460V 20kVA 1800RPM</li><li>15: 60Hz 460V 37.5kVA 1800RPM</li><li>16: 60Hz 460V 52.5kVA 1800RPM</li><li>17: 60Hz 460V 72.5kVA 1800RPM</li><li>18: 60Hz 460V 100kVA 1800RPM</li><li>19: 60Hz 460V 300kVA 1800RPM</li><li>20: 60Hz 460V 406kVA 1800RPM</li><li>21: 60Hz 460V 800kVA 1800RPM</li><li>22: 60Hz 460V 1075kVA 1800RPM</li><li>23: 60Hz 460V 1588kVA 1800RPM</li><li>24: 60Hz 460V 2500kVA 1800RPM</li></ul><p>Select No (default) if you do not want to use a preset model or if you want to modify some of the parameters of a preset model, as described below.</p><p>When you select a preset model, the electrical and mechanical parameters in the <strong>Parameters</strong> tab are dimmed.</p><p>To start from a preset model and then modify the machine parameters:</p><ul><li>Select the preset model you want to initialize the parameters.</li><li>Change the <strong>Preset model</strong> parameter to No. This action does not change the machine parameters, but breaks the connection with the preset model.</li><li>Modify the machine parameters as you want.</li></ul></td></tr><tr><td valign="top"><strong>Mechanical input</strong> — Mechanical input<br>Mechanical power Pm (default) | Speed w | Mechanical rotational port</td><td><p>Whether to represent the mechanical power applied to the shaft or the rotor speed as a Simulink<sup>®</sup> input of the block, or to represent the machine shaft with a SPS rotational mechanical port.</p><p>Select Mechanical power Pm to specify a mechanical power input, in pu, and expose the <strong>Pm</strong> port. The machine speed is determined by the inertia constant <em>H</em> and by the difference between the mechanical torque <em>Tm</em>, which results from the applied mechanical power <em>Pm</em>, and the internal electromagnetic torque <em>Te</em>.</p><p>When the speed is positive, a positive mechanical power signal indicates generator mode and a negative signal indicates motor mode.</p><p>Select Speed w to specify a speed input in pu and expose the <strong>w</strong> port. The machine speed is imposed and the mechanical part of the model (the inertia constant <em>H</em>) is ignored.</p><p>Using the speed as the mechanical input allows you to model a mechanical coupling between two machines.</p><p>The next figure indicates how to model a stiff shaft interconnection in a motor-generator set where both machines are synchronous machines.</p><p>The speed output of machine 1 (the motor) is connected to the speed input of machine 2 (the generator). In this figure, friction torque is ignored in machine 2.</p><p>Therefore, its electromagnetic torque output <strong>Te</strong> corresponds to the mechanical torque <em>Tm</em> applied to the shaft of machine 1.</p><p>The corresponding mechanical input power of machine 1 is computed as <em>Pm</em> = <em>Tm</em>*w. The Kw factor takes into account the speed units of both machines (pu) and the gear box ratio w2/w1.</p><p>The KT factor takes into account the torque units of both machines (pu) and the machine ratings. Also, because inertia <em>J2</em> is ignored in machine 2, <em>J2</em> refers to the speed of machine 1 and must be added to machine 1 inertia, <em>J1</em>.</p><p><img src="https://799605156-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FdlNg8IbOdahCpFCyzxSN%2Fuploads%2Fgit-blob-84cccbebaa4d47b9de68ec13115e867e00e02eb8%2FSSM_mechanical_input_model.png?alt=media" alt="" data-size="original"></p><p>Select Mechanical rotational port to expose a SPS mechanical rotational port, <strong>S</strong>, that allows you to connect of the machine shaft to another machine shaft or to other SPS blocks that have mechanical rotational ports.</p><p>The figure indicates how to connect an Ideal Torque Source block from the SPS library to the machine shaft port to represent the machine in motor mode or generator mode when the rotor speed is positive.<img src="https://799605156-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FdlNg8IbOdahCpFCyzxSN%2Fuploads%2Fgit-blob-99f081cc8fcf892b399b8cdd72b1e65b156b859e%2Fimage.png?alt=media" alt=""></p></td></tr><tr><td valign="top"><strong>Rotor type</strong> — Rotor type<br>Salient-pole (default) | Round</td><td><p>Specify the rotor type as either Salient-pole or Round (cylindrical).</p><p>The setting affects the number of rotor circuits in the <em>q</em>-axis (damper windings).</p></td></tr><tr><td valign="top"><strong>Use signal names to identify bus labels</strong> — How to identify bus labels<br>off (default) | on</td><td><p>When this check box is selected, the measurement output uses the signal names to identify the bus labels.</p><p>Select this option for applications that require bus signal labels to have only alphanumeric characters.</p><p>When this check box is cleared, the measurement output uses the signal definition to identify the bus labels.</p><p>The labels contain nonalphanumeric characters that are incompatible with some Simulink applications.</p></td></tr></tbody></table>

### Parameters

<table data-header-hidden><thead><tr><th width="249.77777099609375"></th><th></th></tr></thead><tbody><tr><td><strong>Nominal power, line-to-line voltage, frequency [ Pn(VA) Vn(Vrms) fn(Hz) ]</strong> — Nominal power, line-to-line voltage, and frequency<br>[6e+04 400 50] (default) | three-element vector</td><td><p>Total three-phase apparent power (VA), RMS line-to-line voltage (pu), frequency (Hz), and field current (pu).</p><p>This parameter is identical to the <strong>Nominal power, voltage, frequency, field current [ Pn(VA) Vn(Vrms) fn(Hz) ifn(A) ]</strong> parameter of the Synchronous Machine SI Fundamental block, except that you do not specify a nominal field current.</p><p>This value is not required because the Synchronous Machine pu Standard block does not need the transformation ratio. Because rotor quantities are viewed from the stator, they are converted to pu using the stator base quantities derived from the preceding three nominal parameters.</p></td></tr><tr><td><strong>Reactances [ Xd Xd' Xd'' Xq Xq'' Xl ] (pu)</strong> — Reactances<br>[2.24 0.17 0.12 1.02 0.13 0.08] (default) | six-element vector</td><td><p><em>d</em>-axis synchronous reactance <em>Xd</em>, transient reactance <em>Xd</em>', and subtransient reactance <em>Xd</em>''; the <em>q</em>-axis synchronous reactance <em>Xq</em> and subtransient reactance <em>Xq</em>''; and the leakage reactance <em>Xl</em> (all in pu).</p><p><strong>Dependencies</strong> To enable this parameter, set <strong>Rotor type</strong> to Salient-pole.</p></td></tr><tr><td><strong>Reactances [ Xd Xd' Xd'' Xq Xq' Xq'' Xl ] (pu)</strong> — Reactances<br>[ 1.81, 0.3, 0.23, 1.76, 0.65, 0.25, 0.15 ] (default)</td><td><p><em>d</em>-axis synchronous reactance <em>Xd</em>, transient reactance <em>Xd</em>', and subtransient reactance <em>Xd</em>''; the <em>q</em>-axis synchronous reactance <em>Xq</em>, transient reactance <em>Xq</em>', and subtransient reactance <em>Xq</em>''; and the leakage reactance <em>Xl</em> (all in pu).</p><p><strong>Dependencies</strong> To enable this parameter, set <strong>Rotor type</strong> to Round.</p></td></tr><tr><td><strong>d axis</strong> — <em>d</em>-axis time constant<br>Short-circuit (default) | Open-circuit</td><td>Time constant for the <em>d</em> axis.</td></tr><tr><td><strong>q axis</strong> — <em>q</em>-axis time constant<br>Short-circuit (default) | Open-circuit</td><td>Time constant for the <em>q</em> axis.</td></tr><tr><td><strong>[ Tdo' Tdo'' Tqo'' ] (s)</strong> — Time constants in s<br>[ 4.4849 0.0681 0.1 ] (default) | three-element vector</td><td><p>Time constants, all in s, for the following:</p><ul><li><em>d</em>-axis transient open-circuit (Tdo')</li><li><em>d</em>-axis subtransient open-circuit (Tdo'')</li><li><em>q</em>-axis subtransient open-circuit (Tqo'')</li></ul><p><strong>Dependencies</strong> To enable this parameter, set <strong>Rotor type</strong> to Salient-pole, <strong>d axis</strong> to Open-circuit, and <strong>q axis</strong> to Open-circuit.</p></td></tr><tr><td><strong>[ Tdo' Tdo'' Tqo' Tqo'' ] (s)</strong> — Time constants in s<br>[ 8.0, 0.03, 1.0, 0.07 ] (default) | four-element vector</td><td><p>Time constants, all in s, for the following:</p><ul><li><em>d</em>-axis transient open-circuit (Tdo')</li><li><em>d</em>-axis subtransient open-circuit (Tdo'')</li><li><em>q</em>-axis transient open-circuit (Tqo')</li><li><em>q</em>-axis subtransient open-circuit (Tqo'')</li></ul><p><strong>Dependencies</strong> To enable this parameter, set <strong>Rotor type</strong> to Round, <strong>d axis</strong> to Open-circuit, and <strong>q axis</strong> to Open-circuit.</p></td></tr><tr><td><strong>[ Tdo' Tdo'' Tq'' ] (s)</strong> — Time constants in s<br>[ 4.49 0.0681 0.0513 ] (default) | three-element vector</td><td><p>Time constants, all in s, for the following:</p><ul><li><em>d</em>-axis transient open-circuit (Tdo')</li><li><em>d</em>-axis subtransient open-circuit (Tdo'')</li><li><em>q</em>-axis subtransient short-circuit (Tq'')</li></ul><p><strong>Dependencies</strong> To enable this parameter, set <strong>Rotor type</strong> to Salient-pole, <strong>d axis</strong> to Open-circuit, and <strong>q axis</strong> to Short-circuit.</p></td></tr><tr><td><strong>[ Tdo' Tdo'' Tq' Tq'' ] (s)</strong> — Time constants in s<br>[ 8.0, 0.03, 0.3371, 0.0295 ] (default) | four-element vector</td><td><p>Time constants, all in s, for the following:</p><ul><li><em>d</em>-axis transient open-circuit (Tdo')</li><li><em>d</em>-axis subtransient open-circuit (Tdo'')</li><li><em>q</em>-axis transient short-circuit (Tq')</li><li><em>q</em>-axis subtransient short-circuit (Tq'')</li></ul><p><strong>Dependencies</strong> To enable this parameter, set <strong>Rotor type</strong> to Round, <strong>d axis</strong> to Open-circuit, and <strong>q axis</strong> to Short-circuit.</p></td></tr><tr><td><strong>[ Td' Td'' Tqo'' ] (s)</strong> — Time constants in s<br>[ 1.01, 0.053, 0.1 ] (default) | three-element vector</td><td><p>Time constants, all in s, for the following:</p><ul><li><em>d</em>-axis transient short-circuit (Td')</li><li><em>d</em>-axis subtransient short-circuit (Td'')</li><li><em>q</em>-axis subtransient open-circuit (Tqo'')</li></ul><p><strong>Dependencies</strong> To enable this parameter, set <strong>Rotor type</strong> to <code>Salient-pole</code>, <strong>d axis</strong> to <code>Short-circuit</code>, and <strong>q axis</strong> to <code>Open-circuit</code>.</p></td></tr><tr><td><strong>[ Td' Td'' Tqo' Tqo'' ] (s)</strong> — Time constants in s<br>[ 1.3201, 0.023, 1.0, 0.07 ] (default) | four-element vector</td><td><p>Time constants, all in s, for the following:</p><ul><li><em>d</em>-axis transient short-circuit (Td')</li><li><em>d</em>-axis subtransient short-circuit (Td'')</li><li><em>q</em>-axis transient open-circuit (Tqo')</li><li><em>q</em>-axis subtransient open-circuit (Tqo'')</li></ul><p><strong>Dependencies</strong> To enable this parameter, set <strong>Rotor type</strong> to Round, <strong>d axis</strong> to Short-circuit, and <strong>q axis</strong> to Open-circuit.</p></td></tr><tr><td><strong>[ Td' Td'' Tq'' ] (s)</strong> — Time constants in s<br>[0.012 0.003 0.003] (default) | three-element vector</td><td><p>Time constants, all in s, for the following:</p><ul><li><em>d</em>-axis transient short-circuit (Td')</li><li><em>d</em>-axis subtransient short-circuit (Td'')</li><li><em>q</em>-axis subtransient short-circuit (Tq'')</li></ul><p><strong>Dependencies</strong> To enable this parameter, set <strong>Rotor type</strong> to Salient-pole, <strong>d axis</strong> to Short-circuit, and <strong>q axis</strong> to Short-circuit.</p></td></tr><tr><td><strong>[ Td' Td'' Tq' Tq'' ] (s)</strong> — Time constants in s<br>[ 1.3201, 0.0231, 0.3371, 0.0295 ] (default) | four-element vector</td><td><p>Time constants, all in s, for the following:</p><ul><li><em>d</em>-axis transient short-circuit (Td')</li><li><em>d</em>-axis subtransient short-circuit (Td'')</li><li><em>q</em>-axis transient short-circuit (Tq')</li><li><em>q</em>-axis subtransient short-circuit (Tq'')</li></ul><p><strong>Dependencies</strong> To enable this parameter, set <strong>Rotor type</strong> to Round, <strong>d axis</strong> to Short-circuit, and <strong>q axis</strong> to Short-circuit.</p></td></tr><tr><td><strong>Stator resistance Rs (pu)</strong> — Stator resistance<br>0.037875 (default) | positive scalar</td><td>Stator resistance <em>Rs</em>, in pu.</td></tr><tr><td><strong>Inertia coefficient, friction factor, pole pairs [ H(s) F(pu) p()]</strong> — Inertia coefficient, friction factor, and pole pairs<br>[0.1028 0.02056 2] (default) | three-element vector</td><td><p>Inertia constant <em>H</em> (s), which is the ratio of energy stored in the rotor at nominal speed over the nominal power of the machine, friction factor <em>F</em> (pu torque/pu speed), and the number of pole pairs <em>p</em>. Friction torque <em>Tf</em> is proportional to rotor speed <em>ω</em> (Tf = F.ω, where all quantities are expressed in pu).</p><p><strong>Dependencies</strong> To enable this parameter, set <strong>Mechanical input</strong> to Mechanical power Pm or Mechanical rotational port.</p></td></tr><tr><td><strong>Pole pairs p ()</strong> — Pole pairs<br>20 (default) | positive integer</td><td><p>Number of pole pairs of the synchronous machine.</p><p><strong>Dependencies</strong> To enable this parameter, set <strong>Mechanical input</strong> to Speed w.</p></td></tr><tr><td><strong>Initial conditions [ dw(%) th(deg) ia,ib,ic(pu) pha,phb,phc(deg) Vf(pu) ]</strong> — Initial conditions<br>[ 0 0 0 0 0 0 0 0 1 ] (default) | nine-element vector</td><td>Initial speed deviation <em>Δω</em> (percent of nominal speed), electrical angle of the rotor <em>Θe</em> (degrees), line current magnitudes <em>ia</em>, <em>ib</em>, <em>ic</em> (pu) and phase angles <em>pha</em>, <em>phb</em>, <em>phc</em> (degrees), and the initial field voltage <em>Vf</em> (pu). You can compute these values automatically by using the Load Flow tool or the Machine Initialization tool of the <a href="https://www.opal-rt.com/docs/smart-power-simulation-software-sps/blocks-functions-tools/machines/blocks/synchronous-machine-pu-standard.md">powergui</a> block.</td></tr><tr><td><strong>Simulate saturation</strong> — Simulate magnetic saturation<br>on (default) | off</td><td><p>Whether the magnetic saturation of the rotor and stator iron is simulated. Select this check box to provide the matrix of parameters for simulating the saturation.</p><p>Clear this check box to not model saturation in your simulation. In this case, the relationship between the <em>ifd</em> and <em>Vt</em> is linear (no saturation).</p></td></tr><tr><td><strong>[ ifd; vt] (pu)</strong> — No-load saturation curve parameters<br>[0.6404,0.7127,0.8441,0.9214,0.9956,1.082,1.19,1.316,1.457;0.7,0.7698,0.8872,0.9466,0.9969,1.046,1.1,1.151,1.201] (default) | vector</td><td><p>No-load saturation curve parameters.</p><p>The magnetic saturation of the stator and rotor iron is modeled by a piecewise linear relationship specifying points on the no-load saturation curve.</p><p>The first row of this matrix contains the values of field currents (in pu). The second row contains values of corresponding terminal voltages (in pu).</p><p>The first point (first column of the matrix) must be different from [0,0].</p><p>This point corresponds to the point where the effect of saturation begins.</p><p>For saturation, the nominal field current and nominal RMS line-to-line voltage are the base values for the field current and terminal voltage, respectively.</p><p>Click <strong>Plot</strong> to view the no-load saturation curve.</p><p><strong>Dependencies</strong> To enable this parameter, select <strong>Simulate saturation</strong>.</p></td></tr></tbody></table>

### Advanced

<table data-header-hidden><thead><tr><th width="276"></th><th></th></tr></thead><tbody><tr><td><strong>Sample time (-1 for inherited)</strong> — Sample time for block<br>-1 (default) | scalar</td><td>Sample time used by the block. To inherit the sample time specified in the powergui block, set this parameter to −1.</td></tr><tr><td><strong>Discrete solver model</strong> — Integration method<br>Trapezoidal non iterative (default) | Trapezoidal iterative (alg. loop) | Trapezoidal robust | Backward Euler robust</td><td><p>Integration method used by the block when the <strong>Solver type</strong> parameter of the powergui block is set to Discrete.</p><p>The <strong>Discrete solver model</strong> is automatically set to Trapezoidal robust when you select the <strong>Automatically handle Discrete solver and Advanced tab solver settings of blocks</strong> parameter of the powergui block.</p><p>The Trapezoidal non iterative and Trapezoidal iterative (alg. loop) methods are no longer recommended for discretizing the Synchronous Machine pu Standard block. Trapezoidal non iterative requires you to add non-negligible shunt loads at the machine terminals to guarantee simulation stability, and Trapezoidal iterative (alg. loop) may fail to converge and cause the simulation to stop when the number of machines increases in the model.</p><p>The Trapezoidal robust and Backward Euler robust methods allow you to eliminate the need to use parasitic loads and simulate a machine without loads.</p><p>To eliminate topological errors of machines connected to an inductive circuit (for example, a circuit breaker connected in series with the machine); the machine models a negligible internal load of 0.01% of nominal power.</p><p>The Trapezoidal robust method is slightly more accurate than the Backward Euler robust method, especially when the model is simulated at larger sample times.</p><p>The Trapezoidal robust method may produce slight damped numerical oscillations on machine voltage at no-load conditions, while the Backward Euler robust method prevents oscillations and maintains good accuracy.</p><p>For more information on what method to use in your application, see <a href="https://www.opal-rt.com/docs/smart-power-simulation-software-sps/simulation-and-analysis/simulate-discretized-electrical-systems.md">Simulating Discretized Electrical Systems</a>.</p></td></tr></tbody></table>

### Load Flow

<table data-header-hidden><thead><tr><th width="285"></th><th></th></tr></thead><tbody><tr><td><strong>Generator type</strong> — Machine generator type<br>PV (default) | swing | PQ</td><td><p>Generator type of the machine. Choice are:</p><ul><li>swing — Implements a generator controlling magnitude and phase angle of its terminal voltage. The reference voltage magnitude and angle are specified by the <strong>Swing bus or PV bus voltage</strong> and <strong>Swing bus voltage angle</strong> parameters of the Load Flow Bus block connected to the machine terminals.</li><li>PV — Implements a generator controlling its output active power <em>P</em> and voltage magnitude <em>V</em>.</li><li><em>P</em> is specified by the <strong>Active power generation P (W)</strong> parameter of the block. <em>V</em> is specified by the <strong>Swing bus or PV bus voltage</strong> parameter of the Load Flow Bus block connected to the machine terminals. You can control the minimum and maximum reactive power generated by the block by using the <strong>Minimum reactive power Qmin (var)</strong> and <strong>Maximum reactive power Qmax (var)</strong> parameters.</li><li>PQ — Implements a generator controlling its output active power <em>P</em> and reactive power <em>Q</em>. <em>P</em> and <em>Q</em> are specified by the <strong>Active power generation P (W)</strong> and <strong>Reactive power generation Q (var)</strong> parameters of the block, respectively.</li></ul></td></tr><tr><td><strong>Active power generation P (W)</strong> — Active power generated by machine<br>0 (default) | scalar</td><td><p>Active power that you want generated by the machine, in watts. When the machine operates in motor mode, you specify a negative value.</p><p><strong>Dependencies</strong> To enable this parameter, set <strong>Generator type</strong> to PV or PQ.</p></td></tr><tr><td><strong>Reactive power generation Q (var)</strong> — Reactive power generated by machine<br>0 (default) | scalar</td><td><p>Reactive power that you want generated by the machine, in vars. A negative value indicates that the reactive power is absorbed by the machine.</p><p><strong>Dependencies</strong> To enable this parameter, set <strong>Generator type</strong> to PQ.</p></td></tr><tr><td><strong>Minimum reactive power Qmin (var)</strong> — Minimum reactive power generated by machine<br>-inf (default) | scalar</td><td><p>Minimum reactive power that can be generated by the machine while keeping the terminal voltage at its reference value.</p><p>This reference voltage is specified by the <strong>Swing bus or PV bus voltage</strong> parameter of the Load Flow Bus block connected to the machine terminals.</p><p>The default value is -inf, which means that there is no lower limit on the reactive power output.</p><p><strong>Dependencies</strong> To enable this parameter, set <strong>Generator type</strong> to PV.</p></td></tr><tr><td><strong>Maximum reactive power Qmax (var)</strong> — Maximum reactive power generated by machine<br>inf (default) | scalar</td><td><p>Maximum reactive power that can be generated by the machine while keeping the terminal voltage at its reference value.</p><p>This reference voltage is specified by the <strong>Swing bus or PV bus voltage</strong> parameter of the Load Flow Bus block connected to the machine terminals.</p><p>The default value is inf, which means that there is no upper limit on the reactive power output.</p><p><strong>Dependencies</strong> To enable this parameter, set <strong>Generator type</strong> to PV.</p></td></tr></tbody></table>

## Examples

#### Model Sub-Synchronous Resonance in Steam Turbine and Governor on Series-Compensated Network

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 uses the Synchronous Machine pu Standard block to model sub-synchronous resonance (SSR) in a steam turbine and governor on a series-compensated network.

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

\[1] Canay, I.M. “Causes of Discrepancies on Calculation of Rotor Quantities and Exact Equivalent Diagrams of the Synchronous Machine.” *IEEE Transactions on Power Apparatus and Systems*. PAS-88, no. 7 (1969): 1114–1120.

\[2] Moeini, A., et al. “Synchronous Machine Stability model, an Update to IEEE Std 1110-2002 Data Translation Technique.” *IEEE standards panel sessions*. 2018.

\[3] *IEEE Guide for Synchronous Generator Modeling Practices and Applications in Power System Stability Analyses.*&#x49;EEE Std 1110-2002 (Revision of IEEE Std 1110-1991 \[2003]): 1–72.

\[4] Krause, P.C. *Analysis of Electric Machinery*. Section 12.5. New York: McGraw-Hill, 1986.

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


---

# 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/synchronous-machine-pu-standard.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.
