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

# Asynchronous Machine

## Description

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

The **Asynchronous Machine** block, located in the **Network Machines** library, models squirrel-cage (single- or double-cage) and wound-rotor machines using a Norton equivalent that interfaces directly with network elements. It supports independent d- and q-axis saturation, unequal mutual inductances on the d and q axes, star (wye) or delta stator winding connections with an optional neutral, coupling between cages for double-cage machines, and stator–rotor coil transformation ratios.

In load-flow studies, the asynchronous machine behaves as a constant positive impedance that depends on slip; provide the initial slip corresponding to the machine steady state.

### Model equations

The equations below describe the double cage machine with mutual coupling between the two cages (due to leakage flux), in the arbitrary reference frame dq0 and where all parameters and variables are referred on the stator side.

## **Electrical Equations**

$$
v\_{q s}=R\_{s} i\_{q s}+\omega \psi\_{d s}+\frac{d \psi\_{q s}}{d t} \\\[8pt]
v\_{d s}=R\_{s} i\_{d s}-\omega \psi\_{q s}+\frac{d \psi\_{d s}}{d t} \\\[8pt]
v\_{0 s}=R\_{s} i\_{0 s}+\frac{d \psi\_{0 s}}{d t}
$$

## **Electrical Equations of the Rotor Cage**

$$
\v\_{d r1}=R\_{r 1} i\_{d r 1}-\left(\omega-\omega\_{r}\right) \psi\_{q r 1}+\frac{d \psi\_{d r 1}}{d t} \\\[8pt]
v\_{d r2}=R\_{r 2} i\_{d r 2}-\left(\omega-\omega\_{r}\right) \psi\_{q r 2}+\frac{d \psi\_{d r 2}}{d t} \\\[8pt]
v\_{q r1}=R\_{1} i\_{q r 1}+\left(\omega-\omega\_{r}\right) \psi\_{d r 1}+\frac{d \psi\_{q r 1}}{d t} \\\[8pt]
v\_{q r2}=R\_{r 2} i\_{q r 2}+\left(\omega-\omega\_{r}\right) \psi\_{d r 2}+\frac{d \psi\_{q r 2}}{d t}
$$

## Stator flux equations

$$
{\psi\_{q s}=L\_{s q} i\_{q s}+L\_{m q} i\_{q r 1}+L\_{m q} i\_{q r 2}} \\\[8pt]
{\psi\_{d s}=L\_{s d} i\_{d s}+L\_{m d} i\_{d r 1}+L\_{m d} i\_{d r2}} \\\[8pt]
{\psi\_{0 s}=l\_{\sigma s} i\_{0 s}}
$$

## Rotor flux equations

$$
{\psi\_{q r 1}=L\_{r q 1} i\_{q r 1}+L\_{m q} i\_{q r 2}+L\_{m q} i\_{q s}+L\_{m r}\left(i\_{q r 1}+i\_{q r 2}\right)} \\\[8pt]
{\psi\_{d r 1}=L\_{r d 1} i\_{d r 1}+L\_{m d} i\_{d r 2}+L\_{m d} i\_{d s}+L\_{m r}\left(i\_{d r 1}+i\_{d r 2}\right)} \\\[8pt]
{\psi\_{q r 2}=L\_{r q 2} i\_{q r 2}+L\_{m q} i\_{q r 1}+L\_{m q} i\_{q s}+L\_{m r}\left(i\_{q r 1}+i\_{q r 2}\right)} \\\[8pt]
{\psi\_{d r 2}=L\_{r d 2} i\_{d r 2}+L\_{m d} i\_{d r 1}+L\_{m d} i\_{d s}+L\_{m r}\left(i\_{d r 1}+i\_{d r 2}\right)}
$$

where

$$\begin{array}{l} {L\_{s q}=L\_{m q}+l\_{\sigma s}} \ {L\_{s d}=L\_{m d}+l\_{\sigma s}} \ {L\_{r q 1}=L\_{m q}+l\_{\sigma r 1}} \ {L\_{r d 1}=L\_{m d}+l\_{\sigma r 1}} \ {L\_{r q 2}=L\_{m q}+l\_{\sigma r 2}} \ {L\_{r d 2}=L\_{m d}+l\_{\sigma r 2}} \end{array}$$

## The electromagnetic torque and the mechanical equations

$$
{T\_{e m}=\frac{3}{2}\left(\frac{p}{2}\right)\left(\psi\_{q r} i\_{d r}-\psi\_{d r} i\_{q r}\right)} \\\[8pt] {J \frac{d \omega\_{m}}{d t}=T\_{e m}-T\_{l o a d}-K\_{D} \omega\_{m}}
$$

In the case of a one-cage or wound rotor machine the equations for the second cage are not used and the mutual induction between cages is zero. The d and q axis rotor voltages 1 are zero and not zero respectively for the one-cage and wound rotor machine.

In the Saturation tab, specify points of the saturation curve when saturation is enabled. For independent d- and q-axis saturation, each table represents the positive part of the curve (the negative part is deduced by symmetry), and the number of points in each axis may differ. For total saturation, only the d-axis table is used.

## Mask parameters

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

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

<table><thead><tr><th width="206">Parameter</th><th>Description</th></tr></thead><tbody><tr><td><strong>Base power</strong></td><td>Nominal power (kVA)</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>Rotor type</strong></td><td>Wound rotor or cage rotor (single or double)</td></tr><tr><td><strong>DQ speed reference</strong></td><td>dq-axis reference frame of the machine</td></tr><tr><td><strong>Stator connection</strong></td><td>Stator winding connection (wye or delta)</td></tr><tr><td><strong>Rs</strong></td><td>Stator resistance (Ohm)</td></tr><tr><td><strong>Lls</strong></td><td>Stator leakage inductance (Henry)</td></tr><tr><td><strong>Rr1</strong></td><td>Cage 1 rotor resistance (Ohm)</td></tr><tr><td><strong>Llr1</strong></td><td>Cage 1 leakage inductance (Henry)</td></tr><tr><td><strong>Rr2</strong></td><td>Cage 2 rotor resistance (Ohm)</td></tr><tr><td><strong>Llr2</strong></td><td>Cage 2 leakage inductance (Henry)</td></tr><tr><td><strong>Lmq</strong></td><td>q-axis mutual inductance (Henry)</td></tr><tr><td><strong>Lmd</strong></td><td>d-axis mutual inductance (Henry)</td></tr><tr><td><strong>Lmr</strong></td><td>d- and q-axis rotor cage mutual inductance (Henry)</td></tr><tr><td><strong>Initial slip</strong></td><td>Initial slip for steady-state initialization</td></tr></tbody></table>
{% endtab %}

{% tab title="Mechanical data" %}

<table><thead><tr><th width="211">Parameter</th><th>Description</th></tr></thead><tbody><tr><td><strong>Moment of Inertia J</strong></td><td>Moment of inertia (kgm<sup>2</sup>)</td></tr><tr><td><strong>Friction Kd</strong></td><td>Viscous friction coefficient (Nm.s)</td></tr><tr><td><strong>Mechanical torque</strong></td><td>Select whether the mechanical torque characteristic is internal or external</td></tr><tr><td><strong>Tmec</strong></td><td>Torque points for the mechanical torque versus speed characteristic (Nm)</td></tr><tr><td><strong>Wmec</strong></td><td>Speed points for the mechanical torque versus speed characteristic (rad/s)</td></tr></tbody></table>
{% endtab %}

{% tab title="Saturation" %}

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

{% hint style="info" %}
**The first point of each saturation curve must be nonzero**. For independent saturation, this point corresponds to the machine’s linear inductance.
{% endhint %}
{% endtab %}
{% endtabs %}

## Conserving ports

<table><thead><tr><th width="201">Port</th><th>Description</th></tr></thead><tbody><tr><td><strong>S</strong></td><td>AC-side stator connector (supports only 3-phase connections). Used on cage and wound-rotor machines.</td></tr><tr><td><strong>N</strong></td><td>AC-side neutral connector (supports only single-phase connections). Used on cage machines.</td></tr></tbody></table>

## Inputs

<table><thead><tr><th width="210">Input</th><th>Description</th></tr></thead><tbody><tr><td><strong>Tmec_i</strong></td><td>Load torque signal when load control is external (Nm)</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="210">Signal</th><th>Description</th></tr></thead><tbody><tr><td><strong>Flux0r1</strong></td><td>Zero-sequence rotor flux of cage 1 (V.s)</td></tr><tr><td><strong>Flux0s</strong></td><td>Zero-sequence stator flux (V.s)</td></tr><tr><td><strong>Fluxdr1</strong></td><td>d-axis rotor flux of cage 1 (V.s)</td></tr><tr><td><strong>Fluxdr2</strong></td><td>d-axis rotor flux of cage 2 (V.s)</td></tr><tr><td><strong>Fluxds</strong></td><td>d-axis stator flux (V.s)</td></tr><tr><td><strong>Fluxm</strong></td><td>Mutual magnetization flux (V.s)</td></tr><tr><td><strong>Fluxmd</strong></td><td>d-axis mutual magnetization flux (V.s)</td></tr><tr><td><strong>Fluxmq</strong></td><td>q-axis mutual magnetization flux (V.s)</td></tr><tr><td><strong>Fluxqr1</strong></td><td>q-axis rotor flux of cage 1 (V.s)</td></tr><tr><td><strong>Fluxqr2</strong></td><td>q-axis rotor flux of cage 2 (V.s)</td></tr><tr><td><strong>Fluxqs</strong></td><td>d-axis stator flux (V.s)</td></tr><tr><td><strong>I0r1</strong></td><td>Zero-sequence rotor current of cage 1 (A)</td></tr><tr><td><strong>I0s</strong></td><td>Zero-sequence stator current (A)</td></tr><tr><td><strong>Iar1</strong></td><td>Phase A rotor current (cage 1) (A)</td></tr><tr><td><strong>Iar2</strong></td><td>Phase A rotor current (cage 2) (A)</td></tr><tr><td><strong>Ias</strong></td><td>Phase A stator current (A)</td></tr><tr><td><strong>Ibr1</strong></td><td>Phase B rotor current (cage 1) (A)</td></tr><tr><td><strong>Ibr2</strong></td><td>Phase B rotor current (cage 2) (A)</td></tr><tr><td><strong>Ibs</strong></td><td>Phase B stator current (A)</td></tr><tr><td><strong>Icr1</strong></td><td>Phase C rotor current (cage 1) (A)</td></tr><tr><td><strong>Icr2</strong></td><td>Phase C rotor current (cage 2) (A)</td></tr><tr><td><strong>Ics</strong></td><td>Phase C stator current (A)</td></tr><tr><td><strong>Idr1</strong></td><td>d-axis rotor current of cage 1 (A)</td></tr><tr><td><strong>Idr2</strong></td><td>d-axis rotor current of cage 2 (A)</td></tr><tr><td><strong>Ids</strong></td><td>d-axis stator current (A)</td></tr><tr><td><strong>Im</strong></td><td>Magnetization current (A)</td></tr><tr><td><strong>Imd</strong></td><td>d-axis magnetization current (A)</td></tr><tr><td><strong>Imq</strong></td><td>q-axis magnetization current (A)</td></tr><tr><td><strong>Iqr1</strong></td><td>q-axis rotor current of cage 1 (A)</td></tr><tr><td><strong>Iqr2</strong></td><td>q-axis rotor current of cage 2 (A)</td></tr><tr><td><strong>Iqs</strong></td><td>q-axis stator current (A)</td></tr><tr><td><strong>Ps</strong></td><td>Active power (W)</td></tr><tr><td><strong>Qs</strong></td><td>Reactive power (VAr)</td></tr><tr><td>Slip</td><td>Slip</td></tr><tr><td><strong>Tmec</strong></td><td>Mechanical torque (Nm)</td></tr><tr><td><strong>V0r1</strong></td><td>Zero-sequence rotor voltage of cage 1 (V)</td></tr><tr><td><strong>V0s</strong></td><td>Zero-sequence stator voltage (V)</td></tr><tr><td><strong>Vdr1</strong></td><td>d-axis rotor voltage of cage 1 (not used for squirrel-cage machines; useful for wound-rotor) (V)</td></tr><tr><td><strong>Vds</strong></td><td>d-axis stator voltage (V)</td></tr><tr><td><strong>Vqr1</strong></td><td>q-axis rotor voltage of cage 1 (not used for squirrel-cage machines; useful for wound-rotor) (V)</td></tr><tr><td><strong>Vqs</strong></td><td>q-axis stator voltage (V)</td></tr><tr><td><strong>Wm</strong></td><td>Mechanical speed (rad/s)</td></tr><tr><td><strong>Wr</strong></td><td>Electrical speed (rad/s)</td></tr><tr><td><strong>Wrpm</strong></td><td>Mechanical speed (rpm)</td></tr></tbody></table>

## References

Analysis of Electric Machinery and Drive Systems, 2nd edition, Paul C. Krause, Oleg Wasynczuk, Scott D. Sudhoff


---

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