> 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/asynchronous-machine.md).

# Asynchronous Machine

## Description

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

The **Asynchronous Machine** SI Units and Asynchronous Machine pu Units block, located in the **OPAL-RT SPS Software/Electrical Machines** library, implement a three-phase asynchronous machine (wound rotor, squirrel cage, or double squirrel cage) modeled in a selectable *dq* reference frame (rotor, stator, or synchronous).

Stator and rotor windings are connected in wye to an internal neutral point. The block operates in either generator or motor mode. The mode of operation is dictated by the sign of the mechanical torque:

* If **Tm** is positive, the machine acts as a motor.
* If **Tm** is negative, the machine acts as a generator. The electrical part of the machine is represented by a fourth-order (or sixth-order for the double squirrel-cage machine) state-space model, and the mechanical part by a second-order system. All electrical variables and parameters are referred to the stator, which is indicated by the prime signs in the following machine equations. All stator and rotor quantities are in the arbitrary two-axis reference frame (*dq* frame). The subscripts used are defined in this table.

<table data-header-hidden><thead><tr><th width="197"></th><th></th></tr></thead><tbody><tr><td><strong>Subscript</strong></td><td><strong>Definition</strong></td></tr><tr><td><em>d</em></td><td><em>d</em>-axis quantity</td></tr><tr><td><em>q</em></td><td><em>q</em>-axis quantity</td></tr><tr><td><em>r</em></td><td>Rotor quantity (wound-rotor or single-cage)</td></tr><tr><td><em>r1</em></td><td>Cage 1 rotor quantity (double-cage)</td></tr><tr><td><em>r2</em></td><td>Cage 2 rotor quantity (double-cage)</td></tr><tr><td><em>s</em></td><td>Stator quantity</td></tr><tr><td><em>l</em></td><td>Leakage inductance</td></tr><tr><td><em>m</em></td><td>Magnetizing inductance</td></tr></tbody></table>

### Electrical System of the Wound-Rotor or Squirrel-Cage Machine

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

$$
V\_{qs} = R\_s i\_{qs} + \frac{d\varphi\_{qs}}{dt} + \omega \varphi\_{ds} \\\[8pt]

V\_{ds} = R\_s i\_{ds} + \frac{d\varphi\_{ds}}{dt} + \omega \varphi\_{qs} \\\[8pt]

V'*{qr} = R'*r i'*{qr} + \frac{d\varphi'*{qr}}{dt} + (\omega - \omega\_r)\varphi'\_{dr} \\\[8pt]

V'*{dr} = R'*r i'*{dr} + \frac{d\varphi'*{dr}}{dt} - (\omega - \omega\_r)\varphi'\_{qr} \\\[8pt]

T\_e = 1.5,p,(\varphi\_{ds} i\_{qs} - \varphi\_{qs} i\_{ds})
$$

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

$$\omega$$ — Reference frame angular velocity

$$\omega\_r$$— Electrical angular velocity

$$
\varphi\_{qs} = L\_s i\_{qs} + L\_m i'*{qr} \\\[8pt]
\varphi*{ds} = L\_s i\_{ds} + L\_m i'*{dr} \\\[8pt]
\varphi'*{qr} = L'*r i'*{qr} + L\_m i\_{qs} \\\[8pt]
\varphi'*{dr} = L'*r i'*{dr} + L\_m i*{ds} \\\[8pt]
L\_s = L\_{ls} + L\_m \\\[8pt]
L'*r = L'*{lr} + L\_m
$$

### Electrical System of the Double Squirrel-Cage Machine

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

$$
V\_{qs} = R\_s i\_{qs} + \frac{d\varphi\_{qs}}{dt} + \omega \varphi\_{ds} \\\[8pt]
V\_{ds} = R\_s i\_{ds} + \frac{d\varphi\_{ds}}{dt} + \omega \varphi\_{qs} \\\[8pt]
0 = R'*{r1} i'*{qr1} + \frac{d\varphi'*{qr1}}{dt} + (\omega - \omega\_r)\varphi'*{dr1} \\\[8pt]
0 = R'*{r1} i'*{dr1} + \frac{d\varphi'*{dr1}}{dt} - (\omega - \omega\_r)\varphi'*{qr1} \\\[8pt]
0 = R'*{r2} i'*{qr2} + \frac{d\varphi'*{qr2}}{dt} + (\omega - \omega\_r)\varphi'*{dr2} \\\[8pt]
0 = R'*{r2} i'*{dr2} + \frac{d\varphi'*{dr2}}{dt} - (\omega - \omega\_r)\varphi'*{qr2} \\\[8pt]
T\_e = 1.5,p,(\varphi\_{ds} i\_{qs} - \varphi\_{qs} i\_{ds})
$$

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

$$
\begin{aligned}
\varphi\_{qs} &= L\_s i\_{qs} + L\_m,(i'*{qr1} + i'*{qr2}) \\\[8pt]
\varphi\_{ds} &= L\_s i\_{ds} + L\_m,(i'*{dr1} + i'*{dr2}) \\\[8pt]
\varphi'*{qr1} &= L'*{r1} i'*{qr1} + L\_m i*{qs} \\\[8pt]
\varphi'*{dr1} &= L'*{r1} i'*{dr1} + L\_m i*{ds} \\\[8pt]
\varphi'*{qr2} &= L'*{r2} i'*{qr2} + L\_m i*{qs} \\\[8pt]
\varphi'*{dr2} &= L'*{r2} i'*{dr2} + L\_m i*{ds} \\\[8pt]
L\_s &= L\_{ls} + L\_m \\\[8pt]
L'*{r1} &= L'*{lr1} + L\_m \\\[8pt]
L'*{r2} &= L'*{lr2} + L\_m
\end{aligned}
$$

### Mechanical System

$$
\begin{aligned}
\frac{d}{dt}\omega\_m &= \frac{1}{2H},(T\_e - F\omega\_m - T\_m) \\\[8pt]
\frac{d}{dt}\theta\_m &= \omega\_m
\end{aligned}
$$

The Asynchronous Machine block parameters are defined in the table. All quantities are referred to the stator.

<table data-header-hidden><thead><tr><th width="318">Parameters Common to All Models</th><th>Definition</th></tr></thead><tbody><tr><td><strong>Parameters Common to All Models</strong></td><td><strong>Definition</strong></td></tr><tr><td><span class="math">Rs, L_{ls}</span></td><td>Stator resistance and leakage inductance</td></tr><tr><td><span class="math">L_m</span></td><td>Magnetizing inductance</td></tr><tr><td><span class="math">L_s</span></td><td>Total stator inductance</td></tr><tr><td><span class="math">V_{qs}, i_{qs}</span><span class="math">V_{qs], i_{qs}</span></td><td><em>q</em>-axis stator voltage and current</td></tr><tr><td><span class="math">V_{ds}, i_{ds}</span></td><td><em>d</em>-axis stator voltage and current</td></tr><tr><td><span class="math">\varphi_{qs}, \varphi_{ds}</span></td><td>Stator <em>q</em>-axis and <em>d</em>-axis fluxes</td></tr><tr><td><span class="math">\omega_m</span></td><td>Angular velocity of the rotor</td></tr><tr><td><span class="math">\theta_m</span></td><td>Rotor angular position</td></tr><tr><td>p</td><td>Number of pole pairs</td></tr><tr><td><span class="math">\omega_r</span></td><td>Electrical angular velocity (ωm× p)</td></tr><tr><td><span class="math">\theta_r</span></td><td>Electrical rotor angular position (Θm × p)</td></tr><tr><td><span class="math">T_e</span></td><td>Electromagnetic torque</td></tr><tr><td><span class="math">T_m</span></td><td>Shaft mechanical torque</td></tr><tr><td><span class="math">J</span></td><td>Combined rotor and load inertia coefficient. Set to infinite to simulate locked rotor.</td></tr><tr><td><span class="math">H</span></td><td>Combined rotor and load inertia constant. Set to infinite to simulate locked rotor.</td></tr><tr><td><span class="math">F</span></td><td>Combined rotor and load viscous friction coefficient</td></tr></tbody></table>

<table data-header-hidden><thead><tr><th width="326"></th><th></th></tr></thead><tbody><tr><td><strong>Parameters Specific to Single-Cage or Wound Rotor</strong></td><td><strong>Definition</strong></td></tr><tr><td><span class="math">L'_r</span></td><td>Total rotor inductance</td></tr><tr><td><span class="math">R'_r, L'_{lr}</span></td><td>Rotor resistance and leakage inductance</td></tr><tr><td><span class="math">V'_{qr}, i'_{qr}</span></td><td><em>q</em>-axis rotor voltage and current</td></tr><tr><td><span class="math">V'_{dr}, i'_{dr}</span></td><td><em>d</em>-axis rotor voltage and current</td></tr><tr><td><span class="math">\varphi’_{qr}, \varphi’_{dr}</span><span class="math">\arphi</span></td><td>Rotor <em>q</em>-axis and d axis fluxes</td></tr></tbody></table>

<table data-header-hidden><thead><tr><th width="338"></th><th></th></tr></thead><tbody><tr><td><strong>Parameters Specific to Double-Cage Rotor</strong></td><td><strong>Definition</strong></td></tr><tr><td><span class="math">R’_{r1}, L’_{lr1}</span></td><td>Rotor resistance and leakage inductance of cage 1</td></tr><tr><td><span class="math">R’_{r2}, L’_{lr2}</span></td><td>Rotor resistance and leakage inductance of cage 2</td></tr><tr><td><span class="math">L’_{r1}, L’_{r2}</span></td><td>Total rotor inductances of cage 1 and 2</td></tr><tr><td><span class="math">i’_{qr1}, i’_{qr2}</span></td><td><em>q</em>-axis rotor current of cage 1 and 2</td></tr><tr><td><span class="math">i’_{dr1}, i’_{dr2}</span></td><td><em>d</em>-axis rotor current of cage 1 and 2</td></tr><tr><td><span class="math">\varphi’_{qr1}, \varphi’_{dr1}</span></td><td><em>q</em>-axis and <em>d</em>-axis rotor fluxes of cage 1</td></tr><tr><td><span class="math">\varphi’_{qr2}, \varphi’_{dr2}</span></td><td><em>q</em>-axis and <em>d</em>-axis rotor fluxes of cage 2</td></tr></tbody></table>

## Assumptions and Limitations

* The Asynchronous Machine blocks do not include a representation of the saturation of leakage fluxes. Be careful when you connect ideal sources to the stator of the machine. If you choose to supply the stator via a three-phase, Y-connected infinite voltage source, you must use three sources connected in Y. However, if you choose to simulate a delta source connection, you must use only two sources connected in series.

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

* When you use Asynchronous Machine blocks in discrete systems, 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 optimum resistive load is proportional to the sample time. 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 asynchronous 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 is sufficient.

## Ports

### Input

<table data-header-hidden><thead><tr><th width="227"></th><th></th></tr></thead><tbody><tr><td><strong>Tm</strong> — Mechanical torque<br>Scalar</td><td>Mechanical torque at the machine's shaft, specified as a scalar. When the input is positive, the asynchronous machine behaves as a motor. When the input is negative, the asynchronous machine behaves as a generator. When you use the Asynchronous Machine SI Units block, the input is a signal in N.m. When you use the Asynchronous Machine pu Units block, the input is a signal in pu.<br><strong>Dependencies</strong> To enable this port, in the <strong>Configuration</strong> tab, set the <strong>Mechanical input</strong> parameter to Torque Tm.</td></tr><tr><td><strong>w</strong> — Machine speed<br>Scalar</td><td>Machine speed in rad/s (for the Asynchronous Machine SI Units block) or in pu (for the Asynchronous Machine pu Units block), specified as a scalar.<br><strong>Dependencies</strong> To enable this port, in the <strong>Configuration</strong> tab, set the <strong>Mechanical input</strong> parameter to <code>Speed w</code>.</td></tr></tbody></table>

### Output

<table data-header-hidden><thead><tr><th width="228"></th><th></th></tr></thead><tbody><tr><td><strong>m</strong> — Measurement signal<br>28-element vector</td><td>Measurement signals, returned as a vector. You can demultiplex these signals by using the Bus Selector block. The units are in SI or pu, depending on whether you use the Asynchronous Machine SI Units or Asynchronous Machine pu Units block.</td></tr></tbody></table>

The cage 2 rotor signals return a null signal when the **Rotor type** parameter on the **Configuration** tab is set to **Wound or Squirrel-cage :**

<table data-header-hidden><thead><tr><th width="228"></th><th width="418"></th></tr></thead><tbody><tr><td>Name</td><td>Definition</td></tr><tr><td>iar</td><td>Rotor current ir_a (A or pu)</td></tr><tr><td>ibr</td><td>Rotor current ir_b (A or pu)</td></tr><tr><td>icr</td><td>Rotor current ir_c (A or pu)</td></tr><tr><td>iqr</td><td>Rotor current iq (A or pu)</td></tr><tr><td>idr</td><td>Rotor current id (A or pu)</td></tr><tr><td>phiqr</td><td>Rotor flux phir_q (V.s or pu)</td></tr><tr><td>phidr</td><td>Rotor flux phir_d (V.s or pu)</td></tr><tr><td>vqr</td><td>Rotor voltage Vr_q (V or pu)</td></tr><tr><td>vdr</td><td>Rotor voltage Vr_d (V or pu)</td></tr><tr><td>iar2</td><td>Cage 2 rotor current ir_a (A or pu)</td></tr><tr><td>ibr2</td><td>Cage 2 rotor current ir_b (A or pu)</td></tr><tr><td>icr2</td><td>Cage 2 rotor current ir_c (A or pu)</td></tr><tr><td>iqr2</td><td>Cage 2 rotor current iq (A or pu)</td></tr><tr><td>idr2</td><td>Cage 2 rotor current id (A or pu)</td></tr><tr><td>phiqr2</td><td>Cage 2 rotor flux phir_q (V.s or pu)</td></tr><tr><td>phidr2</td><td>Cage 2 rotor flux phir_d (V.s or pu)</td></tr><tr><td>ias</td><td>Stator current is_a (A or pu)</td></tr><tr><td>ibs</td><td>Stator current is_b (A or pu)</td></tr><tr><td>ics</td><td>Stator current is_c (A or pu)</td></tr><tr><td>iqs</td><td>Stator current is_q (A or pu)</td></tr><tr><td>ids</td><td>Stator current is_d (A or pu)</td></tr><tr><td>phiqs</td><td>Stator flux phis_q (V.s or pu)</td></tr><tr><td>phids</td><td>Stator flux phis_d (V.s or pu)</td></tr><tr><td>vqs</td><td>Stator voltage vs_q (V or pu)</td></tr><tr><td>vds</td><td>Stator voltage vs_d (V or pu)</td></tr><tr><td>w</td><td>Rotor speed (rad/S)</td></tr><tr><td>Te</td><td>Electromagnetic torque Te</td></tr><tr><td>theta</td><td>Rotor angle thetam (rad)</td></tr></tbody></table>

### Conserving

<table data-header-hidden><thead><tr><th width="240"></th><th></th></tr></thead><tbody><tr><td><strong>A</strong> — Phase A stator terminal<br>SPS electrical</td><td>SPS electrical conserving port associated with the phase A stator terminal.</td></tr><tr><td><strong>B</strong> — Phase B stator terminal<br>SPS electrical</td><td>SPS electrical conserving port associated with the phase B stator terminal.</td></tr><tr><td><strong>C</strong> — Phase C stator terminal<br>SPS electrical</td><td>SPS electrical conserving port associated with the phase C stator terminal.</td></tr><tr><td><strong>a</strong> — Phase a rotor terminal<br>SPS electrical</td><td>SPS electrical conserving port associated with the phase a rotor terminal.<br><strong>Dependencies</strong> This port applies only to the Asynchronous Machine SI Units block.</td></tr><tr><td><strong>b</strong> — Phase b rotor terminal<br>SPS electrical</td><td>SPS electrical conserving port associated with the phase b rotor terminal.<br><strong>Dependencies</strong> This port applies only to the Asynchronous Machine SI Units block.</td></tr><tr><td><strong>c</strong> — Phase c rotor terminal<br>SPS electrical</td><td>SPS electrical conserving port associated with the phase c rotor terminal.<br><strong>Dependencies</strong> This port applies only to the Asynchronous Machine SI Units block.</td></tr><tr><td><strong>S</strong> — Machine rotor shaft<br>mechanical</td><td>Mechanical rotational conserving port associated with the machine rotor.<br><strong>Dependencies</strong> To enable this port, in the <strong>Configuration</strong> tab, set the <strong>Mechanical input</strong> parameter to Mechanical rotational port.</td></tr></tbody></table>

## Parameters

### Configuration

<table data-header-hidden><thead><tr><th width="246"></th><th></th></tr></thead><tbody><tr><td><strong>Rotor type</strong> — Rotor type<br>Wound | Squirrel-cage | Double squirrel-cage</td><td>Type of rotor. For the Asynchronous Machine SI Units block, the default value is Wound. For the Asynchronous Machine pu Units block, the default value is Squirrel-cage.</td></tr><tr><td><strong>Squirrel-cage preset model</strong> — Electrical and mechanical parameters<br>No (default) | 01: 5 HP 460 V 60Hz 1750 RPM | 02: 10 HP 460 V 60Hz 1760 RPM | ...</td><td><p>Set of predetermined electrical and mechanical parameters for various asynchronous machine ratings of power (HP), phase-to-phase voltage (V), frequency (Hz), and rated speed (rpm) for single squirrel-cage machines. Select one of the preset models to load the corresponding electrical and mechanical parameters. The preset models do not include predetermined saturation parameters. Choices are:</p><ul><li>01: 5 HP 460 V 60Hz 1750 RPM</li><li>02: 10 HP 460 V 60Hz 1760 RPM</li><li>03: 20 HP 460 V 60Hz 1760 RPM</li><li>04: 50 HP 460 V 60Hz 1780 RPM</li><li>05: 100 HP 460 V 60Hz 1780 RPM</li><li>06: 150 HP 460 V 60Hz 1785 RPM</li><li>07: 200 HP 460 V 60Hz 1785 RPM</li><li>08: 5 HP 575 V 60Hz 1750 RPM</li><li>09: 10 HP 575 V 60Hz 1760 RPM</li><li>10: 20 HP 575 V 60Hz 1765 RPM</li><li>11: 50 HP 575 V 60Hz 1775 RPM</li><li>12: 100 HP 575 V 60Hz 1780 RPM</li><li>13: 150 HP 575 V 60Hz 1785 RPM</li><li>14: 200 HP 575 V 60Hz 1785 RPM</li><li>15: 5.4 HP (4KW) 400 V 50Hz 1430 RPM</li><li>16: 10 HP (7.5KW) 400 V 50Hz 1440 RPM</li><li>17: 20 HP (15KW) 400 V 50Hz 1460 RPM</li><li>18: 50 HP (37KW) 400 V 50Hz 1480 RPM</li><li>19: 100 HP (75KW) 400 V 50Hz 1484 RPM</li><li>20: 150 HP (110KW) 400 V 50Hz 1487 RPM</li><li>21: 215 HP (160KW) 400 V 50Hz 1487 RPM</li></ul><p>Select No if you do not want to use a preset model, or if you want to modify some of the parameters of a preset model. When you select a preset model, the electrical and mechanical parameters in the <strong>Parameters</strong> tab are dimmed. To start from a preset model and then modify machine parameters:</p><ul><li>Select the preset model for which 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><p><strong>Dependencies</strong> To enable this parameter, set <strong>Rotor type</strong> to <strong>Squirrel-cage</strong>.</p></td></tr><tr><td><strong>Double squirrel-cage preset model</strong> — Preset models<br>button</td><td>Click <strong>Open parameter estimator</strong> to open an interface to the power_AsynchronousMachineParams function that gives you access to preset models for double-cage asynchronous machines.</td></tr><tr><td><strong>Mechanical input</strong> — Mechanical input<br>Torque Tm (default) | Speed w | Mechanical rotational port</td><td><p>Whether to represent the torque applied to the shaft or the rotor speed as a Simulink input of the block, or to represent the machine shaft by a Simscape™ rotational mechanical port. Select <code>Torque Tm</code> to specify a torque input, in N.m or in pu, and expose the <strong>Tm</strong> port. The machine speed is determined by the machine inertia <em>J</em> (for the SI machine) or inertia constant <em>H</em> (for the pu machine) and by the difference between the applied mechanical torque <em>Tm</em>, and the internal electromagnetic torque, <em>Te</em>. When the speed is positive, a positive torque signal indicates motor mode and a negative signal indicates generator mode. Select <code>Speed w</code> to specify a speed input, in rad/s or in pu, and expose the <strong>w</strong> port. The machine speed is imposed and the mechanical part of the model (the machine inertia <em>J</em>) is ignored. Using the speed as the mechanical input allows you to model a mechanical coupling between two machines. The figure indicates how to model a stiff shaft interconnection in a motor-generator set when friction torque is ignored in machine 2. The speed output of machine 1 (the motor) is connected to the speed input of machine 2 (the generator), while machine 2 electromagnetic torque output <em>Te</em> is applied to the mechanical torque input <em>Tm</em> of machine 1. The Kw factor takes into account the speed units of both machines (rad/s or pu) and gear box ratio w2/w1. The KT factor takes into account the torque units of both machines (N.m or pu) and 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 Simscape mechanical rotational port, <strong>S</strong>, that allows you to connect the machine shaft to other Simscape blocks that have mechanical rotational ports. The figure indicates how to connect an Ideal Torque Source block from the Simscape library to the machine shaft to represent the machine in motor mode or in generator</p><p>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-53af9211ce153fe1389247a89df5d7d00fea27a2%2Fasynch_machine_ideal_torque_source_connexion.png?alt=media" alt=""></p></td></tr><tr><td><strong>Reference frame</strong> — Reference frame for converting<br>Rotor (default) | Stationary | Synchronous</td><td><p>Reference frame that is used to convert input voltages (abc reference frame) to the dq reference frame, and output currents (dq reference frame) to the abc reference frame. Choose from the following reference frame transformations:</p><ul><li>Rotor — Park transformation</li><li>Stationary — Clarke or αβ transformation</li><li>Synchronous</li></ul><p>The following relationships describe the abc-to-dq reference frame transformations applied to the asynchronous machine phase-to-phase voltages.<br><span class="math">\begin{aligned} \begin{bmatrix} V_{qs} \\[4pt] V_{ds} \end{bmatrix} &#x26;= \frac{1}{3} \begin{bmatrix} 2\cos\theta &#x26; \cos\theta + \sqrt{3}\sin\theta \\[4pt] 2\sin\theta &#x26; \sin\theta - \sqrt{3}\cos\theta \end{bmatrix} \begin{bmatrix} V_{abs} \\[4pt] V_{bcs} \end{bmatrix} \\[8pt] \begin{bmatrix} V'_{qr} \\[4pt] V'_{dr} \end{bmatrix} &#x26;= \frac{1}{3} \begin{bmatrix} 2\cos\beta &#x26; \cos\beta + \sqrt{3}\sin\beta \\[4pt] 2\sin\beta &#x26; \sin\beta - \sqrt{3}\cos\beta \end{bmatrix} \begin{bmatrix} V'_{abr} \\[4pt] V'_{bcr} \end{bmatrix} \end{aligned}</span><br>In the preceding equations, Θ is the angular position of the reference frame, while <em>β</em> = <em>θ</em> – <em>θ</em><sub><em>r</em></sub> is the difference between the position of the reference frame and the position (electrical) of the rotor. Because the machine windings are connected in a three-wire Y configuration, there is no homopolar (0) component. This configuration also justifies that two line-to-line input voltages are used inside the model instead of three line-to-neutral voltages. The following relationships describe the dq-to-abc reference frame transformations applied to the asynchronous machine phase currents.<br><span class="math">\begin{aligned} \begin{bmatrix} i_{as} \\[4pt] i_{bs} \end{bmatrix} &#x26;= \begin{bmatrix} \cos\theta &#x26; \sin\theta \\[4pt] \dfrac{-\cos\theta + \sqrt{3}\sin\theta}{2} &#x26; \dfrac{-\sqrt{3}\cos\theta - \sin\theta}{2} \end{bmatrix} \begin{bmatrix} i_{qs} \\[4pt] i_{ds} \end{bmatrix} \\[8pt] \begin{bmatrix} i'_{ar} \\[4pt] i'_{br} \end{bmatrix} &#x26;= \begin{bmatrix} \cos\beta &#x26; \sin\beta \\[4pt] \dfrac{-\cos\beta + \sqrt{3}\sin\beta}{2} &#x26; \dfrac{-\sqrt{3}\cos\beta - \sin\beta}{2} \end{bmatrix} \begin{bmatrix} i'_{qr} \\[4pt] i'_{dr} \end{bmatrix} \\[8pt] i_{cs} &#x26;= -i_{as} - i_{bs} \\[8pt] i'_{cr} &#x26;= -i'_{ar} - i'_{br} \end{aligned}</span></p><p>The table shows the values taken by Θ and β in each reference frame (Θ<sub>e</sub> is the position of the synchronously rotating reference frame).</p><p>The choice of reference frame affects the waveforms of all dq variables. It also affects the simulation speed, and in certain cases, the accuracy of the results. The following guidelines are suggested in [1]:</p><ul><li>Use the stationary reference frame if the stator voltages are either unbalanced or discontinuous and the rotor voltages are balanced (or 0).</li><li>Use the rotor reference frame if the rotor voltages are either unbalanced or discontinuous and the stator voltages are balanced.</li><li>Use either the stationary or synchronous reference frames if all voltages are balanced and continuous.</li></ul><p>In the following situations, the <strong>Reference frame</strong> parameter is not editable and is set internally:</p><p>Rotor: <span class="math">\theta=\theta_r, \space \beta=0</span><br>Stationary: <span class="math">\theta=0, \space \beta=-\theta_r</span></p><p>Synchronous: <span class="math">\theta=\theta_e, \space \beta=\theta_e-\theta_r</span></p><p><strong>Dependencies</strong> To enable this parameter, in the powergui block, set <strong>Simulation type</strong> to Continuous or Discrete and clear <strong>Automatically handle Discrete solver and Advanced tab solver settings of blocks</strong>. Additionally, on the <strong>Advanced</strong> tab, set <strong>Discrete solver model</strong> to Trapezoidal non iterative or Trapezoidal iterative (alg. loop).</p></td></tr><tr><td><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. 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. The labels contain nonalphanumeric characters that are incompatible with some Simulink applications.</p></td></tr></tbody></table>

**The choice of reference frame affects the waveforms of all dq variables**. It also affects the simulation speed, and in certain cases, the accuracy of the results.

The following guidelines are suggested in \[1]:

* Use the stationary reference frame if the stator voltages are either unbalanced or discontinuous and the rotor voltages are balanced (or 0).
* Use the rotor reference frame if the rotor voltages are either unbalanced or discontinuous and the stator voltages are balanced.
* Use either the stationary or synchronous reference frames if all voltages are balanced and continuous.

In the following situations, the **Reference frame** parameter is not editable and is set internally:

| **powergui Block Setting**                                                                                                                                | **Asynchronous Machine Block Setting**                                           | **Reference frame Parameter** |
| --------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------- | ----------------------------- |
| **Simulation type** is set to Phasor or Discrete Phasor                                                                                                   | —                                                                                | Synchronous                   |
| **Simulation type** is set to Discrete and the **Automatically handle Discrete solver and Advanced tab solver settings of blocks** parameter is selected. | —                                                                                | Rotor                         |
| **Simulation type** is set to Discrete                                                                                                                    | Θ**Discrete solver model** is set to Trapezoidal robust or Backward Euler robust | Rotor                         |

**Dependencies**

To enable this parameter, in the powergui block, set **Simulation type** to Continuous or Discrete and clear **Automatically handle Discrete solver and Advanced tab solver settings of blocks**. Additionally, on the **Advanced** tab, set **Discrete solver model** to Trapezoidal non iterative or Trapezoidal iterative (alg. loop).

### Parameters for Asynchronous Machine SI Units Block

{% hint style="info" %}
This tab contains the electrical parameters of the machine. To estimate the electrical parameters of a double-cage asynchronous machine based on standard manufacturer specifications, use the [power\_AsynchronousMachineParams](https://opal-rt.atlassian.net/wiki/spaces/PSPS/pages/1551730935/power_AsynchronousMachineParams) function.
{% endhint %}

<table data-header-hidden><thead><tr><th width="271"></th><th></th></tr></thead><tbody><tr><td><strong>Nominal power, voltage (line-line), and frequency [ Pn(VA),Vn(Vrms),fn(Hz) ]</strong> — Nominal power, voltage, and frequency<br>[1.845e+04 400 50] (default) | three-element vector</td><td>Nominal apparent power <em>Pn</em> (VA), RMS line-to-line voltage <em>Vn</em> (V), and frequency <em>fn</em> (Hz).</td></tr><tr><td><strong>Vrotor/Vstator voltage ratio</strong> — Voltage ratio<br>1 (default) | positive scalar</td><td>Vrotor/Vstator voltage ratio of the wound-rotor asynchronous machine when the rotor is at standstill. Specifying this parameter allows you to get the desired rotor voltage without connecting a transformer at the rotor terminals.<strong>Dependencies</strong> To enable this parameter, in the <strong>Configuration</strong> tab, set <strong>Rotor type</strong> to Wound.</td></tr><tr><td><strong>Stator resistance and inductance[ Rs(ohm) Lls(H) ]</strong> — Stator resistance and leakage inductance<br>[0.5968 0.0003495] (default) | two-element vector</td><td>Stator resistance <em>Rs</em> (Ω) and leakage inductance <em>Lls</em> (H).</td></tr><tr><td><strong>Rotor resistance and inductance [ Rr'(ohm) Llr'(H) ]</strong> — Rotor resistance and leakage inductance<br>[0.6258 0.005473] (default) | two-element vector</td><td><p>Rotor resistance <em>Rr</em>' (Ω) and leakage inductance <em>Llr</em>' (H), both referred to the stator.</p><p><strong>Dependencies</strong> To enable this parameter, in the <strong>Configuration</strong> tab, set <strong>Rotor type</strong> to Wound or Squirrel-cage.</p></td></tr><tr><td><strong>Cage 1 resistance and inductance [ Rr1' (ohm) Llr1' (H) ]</strong> — Rotor resistance and leakage inductance<br>[0.4155 0.002066] (default) | two-element vector</td><td><p>Rotor resistance <em>Rr1</em>' (Ω) and leakage inductance <em>Llr1</em>' (H), both referred to the stator.</p><p><strong>Dependencies</strong> To enable this parameter, in the <strong>Configuration</strong> tab, set <strong>Rotor type</strong> to Double squirrel-cage.</p></td></tr><tr><td><strong>Cage 2 resistance and inductance [ Rr2' (ohm) Llr2' (H) ]</strong> — Rotor resistance and leakage inductance<br>[0.4168 0.0003495] (default) | two-element vector</td><td><p>Rotor resistance <em>Rr2</em>' (Ω) and leakage inductance <em>Llr2</em>' (H), both referred to the stator.</p><p><strong>Dependencies</strong> To enable this parameter, in the <strong>Configuration</strong> tab, set <strong>Rotor type</strong> to Double squirrel-cage.</p></td></tr><tr><td><strong>Mutual inductance Lm (H)</strong> — Magnetizing inductance<br>0.0354 (default) | scalar</td><td>Magnetizing inductance <em>Lm</em> (H).</td></tr><tr><td><strong>Inertia, friction factor, pole pairs [ J(kg.m^2) F(N.m.s) p() ]</strong> — Inertia, friction factor, pole pairs<br>[0.05 0.005879 2] (default) | three-element vector</td><td>Combined machine and load inertia coefficient <em>J</em> (kg.m<sup>2</sup>), combined viscous friction coefficient <em>F</em> (N.m.s), and pole pairs <em>p</em>. The friction torque <em>Tf</em> is proportional to the rotor speed <em>ω</em>, (Tf = F.ω). <em>Tf</em> is expressed in N.m, <em>F</em> in N.m.s, and <em>ω</em> in rad/s.</td></tr><tr><td><strong>Initial conditions</strong> — Initial slip <em>s</em>, electrical angle, stator current magnitude, phase angles, rotor current magnitude, and phase angles<br>[0 0 0 0 0 0 0 0] (default) | eight-element vector</td><td>Initial slip_s_, electrical angle Θe (degrees), stator current magnitude (A), and phase angles (degrees):[slip, th, ias, ibs, ics, phaseas, phasebs, phasecs] If the <strong>Rotor type</strong> parameter (in the <strong>Configuration</strong> tab) is set to Wound, you can also specify optional initial values for the rotor current magnitude (A), and phase angles (degrees):[slip, th, ias, ibs, ics, phaseas, phasebs, phasecs, iar, ibr, icr, phasear, phasebr, phasecr] When the <strong>Rotor type</strong> parameter (in the <strong>Configuration</strong> tab) is set to Squirrel-cage, the initial conditions can be computed by the <strong>Load Flow</strong> tool or the <strong>Machine Initialization</strong> tool in the powergui block.</td></tr><tr><td><strong>Simulate saturation</strong> — Simulate magnetic saturation<br>off (default) | on</td><td>Whether to simulate magnetic saturation of the rotor and stator iron. Select this check box to provide the matrix of parameters for simulating the saturation. Clear this check box to not model saturation in your simulation. In this case, the relationship between the stator current and the stator voltage is linear.</td></tr><tr><td><strong>[ i(Arms) ; v(VLL rms)]</strong> — No-load saturation curve parameters<br>[14.03593122, 27.81365428, 53.79336849, 72.68890987, 97.98006896, 148.6815601, 215.7428561, 302.9841135, 428.7778367 ; 230, 322, 414, 460, 506, 552, 598, 644, 690] (default) | matrix</td><td>No-load saturation curve parameters. The magnetic saturation of the stator and rotor iron (the saturation of the mutual flux) is modeled by a piecewise linear relationship specifying points of the no-load saturation curve. The first row of this matrix contains the values of stator currents. The second row contains values of corresponding terminal voltages (stator voltages). The first point (first column of the matrix) must be different from [0,0]. This point corresponds to the point where the effect of saturation begins. Click <strong>Plot</strong> to view the specified no-load saturation curve.<strong>Dependencies</strong> To enable this parameter, select <strong>Simulate saturation</strong>.</td></tr></tbody></table>

#### Parameters for Asynchronous Machine pu Units Block

{% hint style="info" %}
This tab contains the electrical parameters of the machine. To estimate the electrical parameters of a double-cage asynchronous machine based on standard manufacturer specifications, use the [power\_AsynchronousMachineParams](https://opal-rt.atlassian.net/wiki/spaces/PSPS/pages/1551730935/power_AsynchronousMachineParams) function.
{% endhint %}

<table data-header-hidden><thead><tr><th width="229"></th><th></th></tr></thead><tbody><tr><td><strong>Nominal power, voltage (line-line), and frequency [ Pn(VA),Vn(Vrms),fn(Hz) ]</strong> — Nominal power, voltage, and frequency<br>[3730 460 60] (default) | three-element vector</td><td>Nominal apparent power <em>Pn</em> (VA), RMS line-to-line voltage <em>Vn</em> (V), and frequency <em>fn</em> (Hz).</td></tr><tr><td><strong>Vrotor/Vstator voltage ratio</strong> — Voltage ratio<br>1 (default) | positive scalar</td><td>Vrotor/Vstator voltage ratio of the wound-rotor asynchronous machine when the rotor is at standstill. Specifying this parameter allows you to get the desired rotor voltage without connecting a transformer at the rotor terminals.<strong>Dependencies</strong> To enable this parameter, in the <strong>Configuration</strong> tab, set <strong>Rotor type</strong> to Wound.</td></tr><tr><td><strong>Stator resistance and inductance [ Rs,Lls ] (pu)</strong> — Stator resistance and leakage inductance<br>[0.01965 0.0397] (default) | two-element vector</td><td>Stator resistance <em>Rs</em> (pu) and leakage inductance <em>Lls</em> (pu).</td></tr><tr><td><strong>Rotor resistance and inductance [ Rr',Llr' ] (pu)</strong> — Rotor resistance and leakage inductance<br>[0.01909 0.0397] (default) | two-element vector</td><td>Rotor resistance <em>Rr</em>' (pu) and leakage inductance <em>Llr</em>' (pu), both referred to the stator.<strong>Dependencies</strong> To enable this parameter, in the <strong>Configuration</strong> tab, set <strong>Rotor type</strong> to Wound or Squirrel-cage.</td></tr><tr><td><strong>Cage 1 resistance and inductance [ Rr1',Llr1' ] (pu)</strong> — Rotor resistance and leakage inductance<br>[0.01909 0.0397] (default) | two-element vector</td><td>Rotor resistance <em>Rr1</em>' (pu) and leakage inductance <em>Llr1</em>' (pu), both referred to the stator.<strong>Dependencies</strong> To enable this parameter, in the <strong>Configuration</strong> tab, set <strong>Rotor type</strong> to Double squirrel-cage.</td></tr><tr><td>**Cage 2 resistance and inductance [**<strong>Rr2',Llr2' ] (pu)</strong> — Rotor resistance and leakage inductance<br>[0.01909 0.0397] (default) | two-element vector</td><td><p>Rotor resistance <em>Rr2</em>' (pu) and leakage inductance <em>Llr2</em>' (pu), both referred to the stator.</p><p><strong>Dependencies</strong> To enable this parameter, in the <strong>Configuration</strong> tab, set <strong>Rotor type</strong> to Double squirrel-cage.</p></td></tr><tr><td><strong>Mutual inductance Lm (pu)</strong> — Magnetizing inductance<br>1.354 (default) | scalar</td><td>Magnetizing inductance <em>Lm</em> (pu).</td></tr><tr><td><strong>Inertia constant, friction factor, pole pairs [ H(s) F(pu) p() ]</strong> — Inertia constant, friction factor, pole pairs<br>[0.09526 0.05479 2] (default) | three-element vector</td><td>Inertia constant <em>H</em> (s), combined viscous friction coefficient <em>F</em> (pu), and pole pairs <em>p</em>.</td></tr><tr><td><strong>Initial conditions</strong> — Initial slip <em>s</em>, electrical angle, stator current magnitude, phase angles, rotor current magnitude, and phase angles<br>[ 1,0 0,0,0 0,0,0 ] (default) | eight-element vector</td><td>Initial slip <em>s</em>, electrical angle Θe (degrees), stator current magnitude (pu), and phase angles (degrees): [slip, th, i<sub>as</sub>, i<sub>bs</sub>, i<sub>cs</sub>, phase<sub>as</sub>, phase<sub>bs</sub>, phase<sub>cs</sub>] If the <strong>Rotor type</strong> parameter (in the <strong>Configuration</strong> tab) is set to Wound, you can also specify optional initial values for the rotor current magnitude (pu), and phase angles (degrees): [slip, th, i<sub>as</sub>, i<sub>bs</sub>, i<sub>cs</sub>, phase<sub>as</sub>, phase<sub>bs</sub>, phase<sub>cs</sub>, i<sub>ar</sub>, i<sub>br</sub>, i<sub>cr</sub>, phase<sub>ar</sub>, phase<sub>br</sub>, phase<sub>cr</sub>] When the <strong>Rotor type</strong> parameter (in the <strong>Configuration</strong> tab) is set to Squirrel-cage, the initial conditions can be computed by the <strong>Load Flow</strong> tool or the <strong>Machine Initialization</strong> tool in the powergui block.</td></tr><tr><td><strong>Simulate saturation</strong> — Simulate magnetic saturation<br>off (default) | on</td><td>Whether to simulate the magnetic saturation of the rotor and stator iron. Select this check box to provide the matrix of parameters for simulating the saturation. Clear this check box to not model saturation in your simulation. In this case, the relationship between the stator current and the stator voltage is linear.</td></tr><tr><td><strong>[ i; v] (pu)</strong> — No-load saturation curve parameters<br>[0.212,0.4201,0.8125,1.0979,1.4799,2.2457,3.2586,4.5763,6.4763 ; 0.5,0.7,0.9,1,1.1,1.2 ,1.3,1.4,1.5] (default) | matrix</td><td>No-load saturation curve parameters. The magnetic saturation of the stator and rotor iron (the saturation of the mutual flux) is modeled by a piecewise linear relationship specifying points of the no-load saturation curve. The first row of this matrix contains the values of stator currents. The second row contains values of corresponding terminal voltages (stator voltages). The first point (first column of the matrix) must be different from [0,0]. This point corresponds to the point where the effect of saturation begins. Click <strong>Plot</strong> to view the specified no-load saturation curve.<strong>Dependencies</strong> To enable this parameter, select <strong>Simulate saturation</strong>.</td></tr></tbody></table>

### Advanced

To enable the **Advanced** tab, in the powergui block, set **Simulation type** to Discrete and clear **Automatically handle Discrete solver and Advanced tab solver settings of blocks**.

<table data-header-hidden><thead><tr><th width="240"></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 &#x26;ndash;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>Integration method used by the block when the <strong>Solver type</strong> parameter of the powergui block is set to Discrete. 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. The Trapezoidal non iterative and Trapezoidal iterative (alg. loop) methods are no longer recommended for discretizing the Asynchronous Machine blocks. Trapezoidal non iterative requires you to add a non-negligible shunt load 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. The Trapezoidal robust and Backward Euler robust methods allow you to eliminate the need to use parasitic loads and simulate a machine without loads. 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. The Trapezoidal robust method is slightly more accurate than the Backward Euler robust method, especially when the model is simulated at larger sample times. The Trapezoidal robust method may produce slightly damped numerical oscillations on machine voltage in no-load conditions, while the Backward Euler robust method prevents oscillations and maintains good accuracy.<br>For more information on what method you should 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>.</td></tr></tbody></table>

### Load Flow

The parameter on this tab is used by the **Load Flow** tool of the powergui block. These load flow parameter is used for model initialization only. It has no impact on the block model or on the simulation performance.

<table data-header-hidden><thead><tr><th width="151"></th><th></th></tr></thead><tbody><tr><td><strong>Mechanical power (W)</strong> — Mechanical power applied to machine shaft<br>scalar</td><td>Mechanical power applied to the machine shaft, in watts. When the machine operates in motor mode, specify a positive value. When the machine operates in generator mode, specify a negative value. For the Asynchronous Machine SI Units block, the default value is 1.492e+006. For the Asynchronous Machine pu Units block, the default value is 0.</td></tr></tbody></table>

## Examples

### Example 1: Use of the Asynchronous Machine Block in Motor Mode

The [Three-Phase Asynchronous Machine](https://www.opal-rt.com/docs/smart-power-simulation-software-sps/example-models/machines/three-phase-asynchronous-machine.md) (power\_pwm) example uses an Asynchronous Machine block in motor mode. The example consists of an asynchronous machine in an open-loop speed control system.

The machine rotor is short-circuited, and the stator is fed by a PWM inverter built with Simulink blocks and interfaced to the Asynchronous Machine block through the Controlled Voltage Source block. The inverter uses sinusoidal pulse-width modulation. The base frequency of the sinusoidal reference wave is set at 60 Hz and the triangular carrier wave frequency is set at 1980 Hz. This frequency corresponds to a frequency modulation factor mf of 33 (60 Hz x 33 = 1980).

The 3 HP machine is connected to a constant load of nominal value (11.9 N.m). It starts and reaches the set point speed of 1.0 pu at t = 0.9 seconds.

The parameters of the machine are the same as the Asynchronous Machine SI Units block, except for the stator leakage inductance, which is set to twice the normal value to simulate a smoothing inductor placed between the inverter and the machine. Also, the stationary reference frame was used to obtain the results shown.

Open the Three-Phase Asynchronous Machine example. In the simulation parameters, a small relative tolerance is required because of the high switching rate of the inverter.

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

Run the simulation and observe the machine’s speed and torque.

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

The first graph shows the machine’s speed going from 0 to 1725 rpm (1.0 pu). The second graph shows the electromagnetic torque developed by the machine. Because the stator is fed by a PWM inverter, a noisy torque is observed.

However, this noise is not visible in the speed because it is filtered out by the machine’s inertia, but it can be seen in the stator and rotor currents.

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

Look at the output of the PWM inverter. Because nothing of interest can be seen at the simulation time scale, the graph concentrates on the last moments of the simulation.

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

### Example 2: Effect of Saturation of the Asynchronous Machine Block

The [Saturation in Three-Phase Asynchronous Machine](https://www.opal-rt.com/docs/smart-power-simulation-software-sps/example-models/machines/saturation-in-three-phase-asynchronous-machine.md) (power\_asm\_sat) example illustrates the effect of saturation of the Asynchronous Machine block.

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

Two identical three-phase motors (50 HP, 460 V, and 1800 rpm) are simulated, with and without saturation, to observe the saturation effects on the stator currents. Two different simulations are realized in the example.

The first simulation is the no-load steady-state test. This table contains the values of the saturation parameters and the measurements obtained by simulating different operating points on the saturated motor (no-load and in steady-state).

| **Vsat (Vrms L-L)** | **Isat (peak A)** | **Vrms L-L** | **Is\_A (peak A)** |
| ------------------- | ----------------- | ------------ | ------------------ |
| -                   | -                 | 120          | 7.322              |
| 230                 | 14.04             | 230          | 14.03              |
| -                   | -                 | 250          | 16.86              |
| -                   | -                 | 300          | 24.04              |
| 322                 | 27.81             | 322          | 28.39              |
| -                   | -                 | 351          | 35.22              |
| -                   | -                 | 382          | 43.83              |
| 414                 | 53.79             | 414          | 54.21              |
| -                   | -                 | 426          | 58.58              |
| -                   | -                 | 449          | 67.94              |
| 460                 | 72.69             | 460          | 73.01              |
| -                   | -                 | 472          | 79.12              |
| -                   | -                 | 488          | 88.43              |
| 506                 | 97.98             | 506          | 100.9              |
| -                   | -                 | 519          | 111.6              |
| -                   | -                 | 535          | 126.9              |
| -                   | -                 | 546          | 139.1              |
| 552                 | 148.68            | 552          | 146.3              |
| -                   | -                 | 569          | 169.1              |
| -                   | -                 | 581          | 187.4              |
| 598                 | 215.74            | 598          | 216.5              |
| -                   | -                 | 620          | 259.6              |
| -                   | -                 | 633          | 287.8              |
| 644                 | 302.98            | 644          | 313.2              |
| -                   | -                 | 659          | 350                |
| -                   | -                 | 672          | 383.7              |
| -                   | -                 | 681          | 407.9              |
| 690                 | 428.78            | 690          | 432.9              |

The next graph illustrates these results and shows the accuracy of the saturation model. The measured operating points fit well the curve that is plotted from the saturation parameters data.

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

You can observe the other effects of saturation on the stator currents by running the simulation with a blocked rotor or with many different values of load torque.

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

\[1] Krause, P.C., O. Wasynczuk, and S.D. Sudhoff, *Analysis of Electric Machinery, IEEE® Press,* 2002.

\[2] Mohan, N., T.M. Undeland, and W\.P. Robbins, *Power Electronics: Converters, Applications, and Design*, John Wiley & Sons, Inc., New York, 1995, Section 8.4.1.


---

# 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/asynchronous-machine.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.
