> 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/basics/passives/mutual-inductance.md).

# Mutual Inductance

## Description

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

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

The **Mutual Inductance** block, located in the **OPAL-RT SPS Software/Passives** library, can be used to model two- or three-windings inductances with equal mutual coupling, or to model a generalized multi-windings mutual inductance with balanced or unbalanced mutual coupling.

If you choose to model two- or three-windings inductances with equal mutual coupling, you specify the self-resistance and inductance of each winding plus the mutual resistance and inductance. The electrical model for this block in this case is given below:

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

If you choose to model a general mutual inductance, specify the number of self-windings (not just limited to 2 or 3 windings) plus the resistance and inductance matrices that define the mutual coupling relationship between the windings (balanced or not).

## Equations

The resistance and inductance matrices are defined as

$$
R = \begin{bmatrix}
R1 & Rm \\
Rm & R2
\end{bmatrix}
$$

and

$$
L = \begin{bmatrix}
L1 & Lm \\
Lm & L2
\end{bmatrix}
$$

where:

* *R* is the resistance.
* *R1* is the self-resistance of resistor R1.
* *R2* is the self-resistance of resistor R2.
* *Rm* is the mutual resistance, such that $$Rm\<R1 \text{ and }Rm\<R2$$

and

* *L* is the inductance.
* *L1* is the self-inductance of inductor L1.
* *L2* is the self-inductance of inductor L2.
* *Lm* is the mutual inductance, such that $$Lm \leq \sqrt{L1\cdot L2}$$

## Parameters

<table><thead><tr><th width="217.199951171875">Parameter</th><th>Description</th></tr></thead><tbody><tr><td><strong>Type of mutual inductance</strong> — Two or three windings with equal mutual terms (default) | Generalized mutual inductance</td><td>Select Two or Three windings with equal mutual terms to implement a three-phase mutual inductance with equal mutual coupling between the windings (default). Select Generalized mutual inductance to implement a multi-windings mutual inductance with mutual coupling defined by an inductance and a resistance matrix.</td></tr><tr><td>Winding 1 self impedance [R1(Ohm) L1(H)] — [1.1 1.1e-03] (default)</td><td>Self-resistance and inductance in ohms (Ω) and henries (H) for winding 1. Dependencies: Enabled when Type is Two or three windings with equal mutual terms.</td></tr><tr><td>Winding 2 self impedance [R2(Ohm) L2(H)] — [1.1 1.1e-03] (default)</td><td>Self-resistance and inductance in ohms (Ω) and henries (H) for winding 2. Dependencies: Enabled when Type is Two or three windings with equal mutual terms.</td></tr><tr><td>Three windings Mutual Inductance — off (default) | on</td><td>If on, implements three coupled windings; otherwise two coupled windings. Dependencies: Enabled when Type is Two or three windings with equal mutual terms.</td></tr><tr><td>Winding 3 self impedance [R3(Ohm) L3(H)] — [1.1 1.1e-03] (default)</td><td>Self-resistance and inductance in ohms (Ω) and henries (H) for winding 3. Dependencies: Enabled when Type is Two or three windings with equal mutual terms and Three windings is on.</td></tr><tr><td>Mutual impedance [Rm(Ohm) Lm(H)] — [1.0 1.0e-03] (default)</td><td>Mutual resistance and inductance between windings, in ohms (Ω) and henries (H). Corresponds to the magnetizing resistance and inductance on the standard transformer circuit diagram. If set to [0 0], the block implements separate inductances with no mutual coupling.<br>The mutual inductance can be expressed as <span class="math">lm=k \sqrt{L1\cdot L2}</span>where k is the coupling coefficient (−1 ≤ <em>k</em> ≤ 1). Dependencies: Enabled when Type is Two or three windings with equal mutual terms.</td></tr><tr><td>Number of windings (N) — <code>3</code> (default)</td><td>Number of self inductances. Dependencies: Enabled when Type is Generalized mutual inductance.</td></tr><tr><td>Inductance matrix L (H) [N-by-N] — [1.0 0.9 0.9 ; 0.9 1.0 0.9; 0.9 0.9 1.0 ] * 1e-3 (default)</td><td>Inductance matrix in Henry that defines mutual coupling between windings. Must be an N-by-N symmetrical matrix. Dependencies: Enabled when Type is Generalized mutual inductance.</td></tr><tr><td>Resistance matrix R (Ohm) [N-by-N] — [1.0 0.9 0.9 ; 0.9 1.0 0.9; 0.9 0.9 1.0 ] (default)</td><td>Resistance matrix in ohms that defines mutual coupling between windings. Must be an N-by-N symmetrical matrix. Dependencies: Enabled when Type is Generalized mutual inductance.</td></tr><tr><td>Measurements — None (default) | Winding voltages | Winding currents | Winding voltages and currents</td><td>Select measurements to record. Place a Multimeter block in your model to display the selected measurements during simulation. In the Multimeter's Available Measurements list, measurements are identified by a label followed by the block name:<br>- Winding voltages: Uw1:<br>- Winding currents: Iw1:</td></tr></tbody></table>

## Limitations

* If modelling two- or three-windings inductances with equal mutual coupling, the following restrictions apply:

$$
R\_1, R\_2, \ldots, R\_N \neq R\_m \quad L\_1, L\_2, \ldots, L\_N \neq L\_m
$$

* Negative values are allowed for the self- and mutual inductances as long as the self-inductances are different from the mutual inductance.
* Windings can be left floating (not connected by an impedance to the rest of the circuit). However an internal resistor between the floating winding and the main circuit is automatically added. This internal connection does not affect voltage and current measurements.

## Examples

The power\_mutual example uses three coupled windings to inject a third harmonic voltage into a circuit fed at 60 Hz.


---

# 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/basics/passives/mutual-inductance.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.
