> 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/rt-lab/simulink-blocks-reference/artemis-library/ssn-induction-and-doubly-fed-induction-machine.md).

# SSN Induction and Doubly fed Induction Machines

## Description

<figure><img src="https://96827845-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNRdpSk8kjn20gXAexnt6%2Fuploads%2Fgit-blob-38d4b84f9047ffd0848bc6d3664841fa8a9a1287%2FArtemis_induction_machines_block.png?alt=media" alt=""><figcaption></figcaption></figure>

The Induction **Machines (IM )** blocks, located in the **ARTEMiS/SSN/SSN rotating machines** library, implement three-phase asynchronous machines and are available in five configuration variants.

* **IM** with a squirrel-cage rotor, modeled in a fixed-stator d-q frame reference for use with the SSN solver. Both stator and rotor windings are connected in wye to an internal neutral point.
* **Doubly-fed induction machine (DFIM)** modeled in a fixed-stator d-q frame reference for use with the SSN solver. Both stator and rotor windings are connected in wye to an internal neutral point.
* **Induction Machine 6 terminals** with a squirrel-cage rotor modeled in a stationary or rotor-based d-q reference frame for use with the SSN solver. The model has 2 terminals per phase to allow wye or delta connection of the stator.
* **IM with internal breakers**, with a squirrel-cage rotor and modeled in a fixed-stator d-q frame reference for use with the SSN solver. Both stator and rotor windings are connected in wye to an internal neutral point. The breakers are connected directly in series with the stator terminals and are assumed to have null resistance when ON.
* **IM Constant Admittance** with a squirrel-cage rotor and modeled in a stationary or rotor-based d-q reference frame for use with the SSN solver. Both stator and rotor windings are connected in wye to an internal neutral point. This SSN machine can be inserted in a model directly or with V-type NIB.

The electrical model is 4<sup>th</sup> order; the mechanical model must be implemented externally to provide the rotor speed.

### Theory and working equations <a href="#ssninductionanddoubly-fedinductionmachine-theoryandworkingequations" id="ssninductionanddoubly-fedinductionmachine-theoryandworkingequations"></a>

The induction machine (IM) model with fixed d-q (Park) referential is used to obtain its SSN equations.\
The Park transformation used to express all quantities in the reference frame attached to the stator is given as in eq. 1 with $$\theta = 0$$ for stator quantities and $$θ = -\theta\_{rotor}$$ for rotor quantities.

<p align="center"><span class="math">T = S \cdot \sqrt{\dfrac{2}{3}} \begin{bmatrix} 1 &#x26; -\dfrac{1}{2} &#x26; -\dfrac{1}{2} \ 0 &#x26; \dfrac{\sqrt{3}}{2} &#x26; -\dfrac{\sqrt{3}}{2} \end{bmatrix} \qquad (1a) \\[8pt]</span></p>

where:

$$
S = \begin{bmatrix} \cos(\theta) & \sin(\theta) \ -\sin(\theta) & \cos(\theta) \end{bmatrix} \qquad (1b) \\\[8pt]
$$

and leading to the following relations

$$Vdqs=T⋅VabcsV\_{dqs} = T \cdot V\_{abcs} \\\[8pt]$$\
$$Iabcs=Tt⋅IdqsI\_{abcs} = T^{t} \cdot I\_{dqs} \qquad (2a)\\\[8pt]$$

$$Vdqr=nsnr T⋅VabcrV\_{dqr} = \dfrac{n\_s}{n\_r} , T \cdot V\_{abcr} \\\[8pt]$$\
$$Iabcr=nsnr Tt⋅IdqrI\_{abcr} = \dfrac{n\_s}{n\_r} , T^{t} \cdot I\_{dqr} \qquad(2b) \\\[8pt]$$

The stator to rotor turn ratio $$n\_s / n\_r$$ is required in Eq. 2b to pass the rotor voltages and currents to and from the stator point of view. Additionally, indices s and r correspond to stator and rotor entities, respectively.

The machine equations are then equal to:

$$ψ˙=(−RL−1+Ω)ψ+Vdq\dot{\psi} = (-R L^{-1} + \Omega)\psi + V\_{dq} \qquad (3a) \\\[8pt]$$

$$I\_{dq}=L−1ψI\_{dq} = L^{-1}\psi \qquad(3b) \\\[8pt]$$

with $$V\_{dq} = \begin{bmatrix} V\_{sd} V\_{sq} V\_{rd} V\_{rq} \end{bmatrix}^t ,\space \psi = \begin{bmatrix} \psi\_{sd} \psi\_{sq} \psi'{rd} \psi'{rq} \end{bmatrix}^t ,\space R = \mathrm{diag}(R\_s, R\_s, R\_r, R\_r)\\\[8pt]$$

$$
\Omega =
\begin{bmatrix}
0 & 0 & 0 & 0 \\
0 & 0 & 0 & 0 \\
0 & 0 & 0 & -\omega\_e \\
0 & 0 & \omega\_e & 0
\end{bmatrix} \text{speed term} \\\[8pt]
$$

where $$\omega\_e$$ is the electric frequency of the rotor given by $$\omega\_e = pp \cdot \omega\_m$$ and $$\omega\_m$$ is the rotor speed in rad/s. Also note that $$L\_s = L\_m + L\_{sl}$$ (similarly for rotor), where $$L\_{sl}$$ is the stator leakage inductance.

$$
L^{-1} =
\frac{1}{L'\_r L\_s - L\_m^2 \space}
\begin{bmatrix}
L'\_r & 0 & -L\_m & 0 \\
0 & L'\_r & 0 & -L\_m \\

L\_m & 0 & L\_s & 0 \\
0 & -L\_m & 0 & L\_s
\end{bmatrix}\\\[8pt]
$$

with $$R\_s, L\_s, R'\_r, L'\_r, L\_m$$ being the stator resistance and inductance, the rotor resistance and inductance referred to the stator and mutual inductance.

Electric torque is, in turn, equal to:

$$
T\_e = pp \cdot (\psi\_d i\_q - \psi\_q i\_d) \qquad (3) \\\[8pt]
$$

The SSN discrete companion model equations are obtained from the phase-domain equations of the IM resulting in a time-variant phase-domain model for the IM with $$V\_{abc}$$ as input and $$I\_{abc}$$ as outputs. (Variant because of matrix } S \text{ for the rotor, speed terms and saturation effects in matrix L). Because the DCM is time-variant, it requires SSN to re-factorize the nodal admittance matrix at each time step.

{% hint style="info" %}
**The model does not include saturation effects**. An advanced user can modify the model to vary the magnetization inductance with current; this inductance is available inside the model.
{% endhint %}

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

In this model, the 2 grid-connected machines are driven at constant slip, then a fault is made near the grid and the DFIM is disconnected a while after. This model is designed to demonstrate that the DFIM can be simulated without any parasitic load even when running with open stator.

{% hint style="danger" %}
This block requires a valid RT-LAB license on the simulator with the feature ARTEMiS enabled. Refer to[ ARTEMiS Requirements](https://www.opal-rt.com/docs/rt-lab/model-and-simulation/power-systems-with-artemis/artemis-requirements.md) for details.
{% endhint %}

## Mask parameters

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

{% tabs %}
{% tab title="IM" %}

<table><thead><tr><th width="254.5999755859375">Parameter</th><th>Description</th></tr></thead><tbody><tr><td><strong>Stator resistance (Ohms)</strong></td><td>Stator resistance in Ohms.</td></tr><tr><td><strong>Stator leakage inductance (H)</strong></td><td>Stator leakage inductance in henries.</td></tr><tr><td><strong>Rotor resistance (Ohms)</strong></td><td>As seen from the stator.</td></tr><tr><td><strong>Rotor leakage inductance (H)</strong></td><td>As seen from the stator.</td></tr><tr><td><strong>Mutual inductance (H)</strong></td><td>As seen from the stator.</td></tr><tr><td><strong>Number of pairs of poles</strong></td><td>Number of pair of poles.</td></tr><tr><td><strong>Sample Time (s)</strong></td><td>Sample time of the model in seconds.</td></tr></tbody></table>
{% endtab %}

{% tab title="DFIM" %}

<table><thead><tr><th width="255.4000244140625">Parameter</th><th>Description</th></tr></thead><tbody><tr><td><strong>Stator resistance (Ohms)</strong></td><td>Stator resistance in Ohms.</td></tr><tr><td><strong>Stator leakage inductance (H)</strong></td><td>Stator leakage inductance in henries.</td></tr><tr><td><strong>Rotor resistance (Ohms)</strong></td><td>As seen from the stator.</td></tr><tr><td><strong>Rotor leakage inductance (H)</strong></td><td>As seen from the stator.</td></tr><tr><td><strong>Mutual inductance (H)</strong></td><td>As seen from the stator.</td></tr><tr><td><strong>Number of pairs of poles</strong></td><td>Number of pair of poles.</td></tr><tr><td><strong>Stator to Rotor turn ratio</strong></td><td>Ns/Nr; ratio of stator turns (Ns) to rotor turns (Nr). Only available for the DFIM. Useful to apply the correct voltage level on the rotor windings.</td></tr><tr><td><strong>Sample Time (s)</strong></td><td>Sample time of the model in seconds.</td></tr><tr><td><strong>Delay speed term</strong></td><td>When this option is enabled, the speed term of the machine equations is integrated into the input of the SSN state-space formulation, yielding symmetric nodal admittances and ensuring compatibility with the SSN LDLᵗ factorization.<br>In the DFIM, the speed term includes a 1-step prediction to improve accuracy.</td></tr></tbody></table>
{% endtab %}

{% tab title="6 terminals" %}

<table><thead><tr><th width="255.4000244140625">Parameter</th><th>Description</th></tr></thead><tbody><tr><td><strong>Stator resistance (Ohms)</strong></td><td>Stator resistance in Ohms.</td></tr><tr><td><strong>Stator leakage inductance (H)</strong></td><td>Stator leakage inductance in henries.</td></tr><tr><td><strong>Rotor resistance (Ohms)</strong></td><td>As seen from the stator.</td></tr><tr><td><strong>Rotor leakage inductance (H)</strong></td><td>As seen from the stator.</td></tr><tr><td><strong>Mutual inductance (H)</strong></td><td>As seen from the stator.</td></tr><tr><td><strong>Number of pairs of poles</strong></td><td>Number of pair of poles.</td></tr><tr><td><strong>Stator to Rotor turn ratio</strong></td><td>Ns/Nr; ratio of stator turns (Ns) to rotor turns (Nr). Only available for the DFIM. Useful to apply the correct voltage level on the rotor windings.</td></tr><tr><td><strong>Sample Time (s)</strong></td><td>Sample time of the model in seconds.</td></tr><tr><td><strong>Backward Euler discretization</strong></td><td>Check to enable</td></tr><tr><td><strong>Backward Euler discretization</strong></td><td>Select the d-q reference frame rotor or stationary</td></tr><tr><td><strong>Delay speed term</strong></td><td>When this option is enabled, the speed term of the machine equations is integrated into the input of the SSN state-space formulation, yielding symmetric nodal admittances and ensuring compatibility with the SSN LDLᵗ factorization.<br>In the DFIM, the speed term includes a 1-step prediction to improve accuracy.</td></tr></tbody></table>
{% endtab %}

{% tab title="with breakers" %}

<table><thead><tr><th width="255.4000244140625">Parameter</th><th>Description</th></tr></thead><tbody><tr><td><strong>Stator resistance (Ohms)</strong></td><td>Stator resistance in Ohms.</td></tr><tr><td><strong>Stator leakage inductance (H)</strong></td><td>Stator leakage inductance in henries.</td></tr><tr><td><strong>Rotor resistance (Ohms)</strong></td><td>As seen from the stator.</td></tr><tr><td><strong>Rotor leakage inductance (H)</strong></td><td>As seen from the stator.</td></tr><tr><td><strong>Mutual inductance (H)</strong></td><td>As seen from the stator.</td></tr><tr><td><strong>Number of pairs of poles</strong></td><td>Number of pair of poles.</td></tr><tr><td><strong>Stator to Rotor turn ratio</strong></td><td>Ns/Nr; ratio of stator turns (Ns) to rotor turns (Nr). Only available for the DFIM. Useful to apply the correct voltage level on the rotor windings.</td></tr><tr><td><strong>Sample Time (s)</strong></td><td>Sample time of the model in seconds.</td></tr><tr><td><strong>Backward Euler discretization</strong></td><td>Check to enable</td></tr><tr><td><strong>Breaker Roff (Ohms)</strong></td><td>The breakers are connected directly in series with the stator terminals and are assumed to have null resistance when ON.</td></tr></tbody></table>
{% endtab %}

{% tab title="constant admittance" %}

<table><thead><tr><th width="255.4000244140625">Parameter</th><th>Description</th></tr></thead><tbody><tr><td><strong>Stator resistance (Ohms)</strong></td><td>Stator resistance in Ohms.</td></tr><tr><td><strong>Stator leakage inductance (H)</strong></td><td>Stator leakage inductance in henries.</td></tr><tr><td><strong>Rotor resistance (Ohms)</strong></td><td>As seen from the stator.</td></tr><tr><td><strong>Rotor leakage inductance (H)</strong></td><td>As seen from the stator.</td></tr><tr><td><strong>Mutual inductance (H)</strong></td><td>As seen from the stator.</td></tr><tr><td><strong>Number of pairs of poles</strong></td><td>Number of pair of poles.</td></tr><tr><td><strong>Stator to Rotor turn ratio</strong></td><td>Ns/Nr; ratio of stator turns (Ns) to rotor turns (Nr). Only available for the DFIM. Useful to apply the correct voltage level on the rotor windings.</td></tr><tr><td><strong>Sample Time (s)</strong></td><td>Sample time of the model in seconds.</td></tr><tr><td><strong>Backward Euler discretization</strong></td><td>Check to enable</td></tr><tr><td><strong>D-Q reference frame</strong></td><td>Select the d-q reference frame rotor or stationary</td></tr></tbody></table>
{% endtab %}
{% endtabs %}

## Conserving ports

| Port           | Description                                            |
| -------------- | ------------------------------------------------------ |
| **aS, bS, cS** | Stator phase physical connection points.               |
| **aR, bR, cR** | Rotor phase physical connection points (only for DFIM) |

## Inputs

| Input      | Description                             |
| ---------- | --------------------------------------- |
| **w\_mec** | Mechanical speed of the machine (rad/s) |

## Outputs

| Output   | Description                                                                                                                                                                                                                  |
| -------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **meas** | <p>Measurements avaible</p><ul><li>flux: phisd, phisq, phird, phirq (Wb) fluxes of the machines used as internal states</li><li>Iabc (A), abc terminal currents (A)</li><li>Electrical torque (N.m) of the machine</li></ul> |


---

# 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/rt-lab/simulink-blocks-reference/artemis-library/ssn-induction-and-doubly-fed-induction-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.
