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

# Double Phase 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-27d87917e390bfbd70d3a37c3cba0e6ca70a56a6%2Fimage%20(341).png?alt=media" alt=""><figcaption></figcaption></figure>

The **Double Phase Asynchronous Machine** block, located in the **Network Machines** library, is modeled as a Norton equivalent with a direct interface to the network component. Specify all electrical parameters using SI units. Control is performed externally through either the mechanical speed or the mechanical torque. The double phase asynchronous machine does not participate in the load flow.

In the Saturation tab, specify saturation curve points when saturation is enabled. For independent saturation of the d and q axes, provide two tables that represent the positive part of each curve; the negative part is deduced by symmetry, and the number of points can differ between the two axes. For total saturation, only the d-axis table is used.

### Model equations

The equations below describe the 2-phase single cage asynchronous machine in the dq frame of reference and where all the parameters and variables are reported on the stator side.

## Electrical system equations

$$
v\_{qs} = R\_{qs} i\_{qs} + \frac{d \psi\_{qs}}{dt} \\\[8pt]
v\_{ds} = R\_{ds} i\_{ds} + \frac{d \psi\_{ds}}{dt} \\\[8pt]
v\_{dr} = R\_{dr} i\_{dr} + \omega\_{r} \frac{N\_{ds}}{N\_{qs}} \psi\_{qr} + \frac{d \psi\_{dr}}{dt} \\\[8pt]
v\_{qr} = R\_{qr} i\_{qr} - \omega\_{r} \frac{N\_{qs}}{N\_{ds}} \psi\_{dr} + \frac{d \psi\_{qr}}{dt} \\\[8pt]
\psi\_{qs} = L\_{qs} i\_{qs} + L\_{mq} i\_{qr} \\\[8pt]
\psi\_{ds} = L\_{ds} i\_{ds} + L\_{md} i\_{dr} \\\[8pt]
\psi\_{qr} = L\_{qr} i\_{qr} + L\_{mq} i\_{qs} \\\[8pt]
\psi\_{dr} = L\_{dr} i\_{dr} + L\_{md} i\_{ds}
$$

Where $$L\_{qs} = L\_{mq} + l\_{\sigma qs} ,\ L\_{ds} = L\_{md} + l\_{\sigma ds}, \ L\_{qr} = L\_{mq} + l\_{\sigma qr} \text{ and }\ L\_{dr} = L\_{md} + l\_{\sigma dr}$$

## Electromagnetic torque and the dynamic equations /

$$
T\_{m} = \frac{3}{2}\left(\frac{p}{2}\right)\left(\frac{N\_{ds}}{N\_{qs}} \psi\_{qr} i\_{dr} - \frac{N\_{qs}}{N\_{ds}} \psi\_{dr} i\_{qr}\right) \ \\\[8pt]J \frac{d \omega\_{m}}{dt} = T\_{em} - T\_{\text{load}} - K\_{D} \omega\_{m}
$$

{% hint style="info" %}
This model does not account for iron losses.
{% endhint %}

## Mask parameters

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

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

<table><thead><tr><th width="210">Parameter</th><th>Description</th></tr></thead><tbody><tr><td><strong>Base power</strong></td><td>Nominal power (kVA)</td></tr><tr><td><strong>Base voltage</strong></td><td>Nominal voltage, line-to-line (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>Rqs</strong></td><td>Main winding resistance (Ohm)</td></tr><tr><td><strong>Rds</strong></td><td>Auxiliary winding resistance (Ohm)</td></tr><tr><td><strong>Llqs</strong></td><td>Main winding leakage inductance (H)</td></tr><tr><td><strong>Llds</strong></td><td>Auxiliary winding leakage inductance (H)</td></tr><tr><td><strong>Lmd</strong></td><td>d-axis mutual inductance (H)</td></tr><tr><td><strong>Lmq</strong></td><td>q-axis mutual inductance (H)</td></tr><tr><td><strong>Rqr</strong></td><td>Rotor cage resistance, main winding (Ohm)</td></tr><tr><td><strong>Rdr</strong></td><td>Rotor cage resistance, auxiliary winding (Ohm)</td></tr><tr><td><strong>Llqr</strong></td><td>Rotor cage leakage inductance, main winding (H)</td></tr><tr><td><strong>Lldr</strong></td><td>Rotor cage leakage inductance, auxiliary winding (H)</td></tr><tr><td><strong>Initial slip</strong></td><td>Initial slip (-)</td></tr><tr><td><strong>Nds/Nqs</strong></td><td>Turn ratio between auxiliary and main windings (-)</td></tr></tbody></table>
{% endtab %}

{% tab title="Mechanical Data" %}

<table><thead><tr><th width="212">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>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 of the mechanical torque versus speed (Nm)</td></tr><tr><td><strong>Wmec</strong></td><td>Speed points of the mechanical torque versus speed (rad/s)</td></tr></tbody></table>
{% endtab %}

{% tab title="Saturation" %}

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

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

## Conserving ports

<table><thead><tr><th width="210">Port</th><th>Description</th></tr></thead><tbody><tr><td><strong>M+</strong></td><td>Stator main winding input connector. Supports single-phase connection.</td></tr><tr><td><strong>M</strong></td><td>Stator main winding output connector. Supports single-phase connection.</td></tr><tr><td><strong>A+</strong></td><td>Stator auxiliary winding input connector. Supports single-phase connection.</td></tr><tr><td><strong>A</strong></td><td>Stator auxiliary winding output connector. Supports single-phase connection.</td></tr></tbody></table>

## Inputs

| Input               | Description                                              |
| ------------------- | -------------------------------------------------------- |
| **Torque or speed** | External control input for torque or speed (Nm or rad/s) |

## 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>Fluxdr1</strong></td><td>d-axis rotor flux, auxiliary winding (V.s)</td></tr><tr><td><strong>Fluxds</strong></td><td>d-axis stator flux, auxiliary winding (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, auxiliary winding (V.s)</td></tr><tr><td><strong>Fluxmq</strong></td><td>q-axis mutual magnetization flux, main winding (V.s)</td></tr><tr><td><strong>Fluxqr1</strong></td><td>q-axis rotor flux, main winding (V.s)</td></tr><tr><td><strong>Fluxqs</strong></td><td>d-axis stator flux, main winding (V.s)</td></tr><tr><td><strong>Iar1</strong></td><td>Phase A rotor current (A)</td></tr><tr><td><strong>Ibr1</strong></td><td>Phase B rotor current (A)</td></tr><tr><td><strong>Idr1</strong></td><td>d-axis rotor current, auxiliary winding (A)</td></tr><tr><td><strong>Ids</strong></td><td>d-axis stator current, auxiliary winding (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, main winding (A)</td></tr><tr><td><strong>Iqs</strong></td><td>q-axis stator current, main winding (A)</td></tr><tr><td><strong>Ps</strong></td><td>Active power (W)</td></tr><tr><td><strong>Slip</strong></td><td>Slip</td></tr><tr><td><strong>ThetaR</strong></td><td>Electrical angle of the rotor (rad)</td></tr><tr><td><strong>Tmec</strong></td><td>Mechanical torque (Nm)</td></tr><tr><td><strong>Tmec_i</strong></td><td>Load torque (Nm)</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, 2<sup>nd</sup> 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/double-phase-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.
