> 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/power-transmission-and-distribution/transformers/multi-winding-transformer.md).

# Multi Winding Transformer

## Description

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

The **Multi-Winding Transformer** block, located in the **OPAL-RT SPS Software/Power Grid Elements** library, implements a transformer where the number of windings can be specified for both the primary (left side windings) and the secondary (right side windings).

The equivalent circuit of the Multi-Winding Transformer block is similar to the one of the Linear Transformer blocks and the saturation characteristic of the core can be specified or not. See the [Saturable Transformer](https://www.opal-rt.com/docs/smart-power-simulation-software-sps/blocks-functions-tools/power-transmission-and-distribution/transformers/saturable-transformer.md) block reference pages for more details on how the saturation and the hysteresis characteristic are implemented.

The equivalent circuit of a Multi-Windings Transformer block with two primary windings and three secondary windings is shown in the next figure.

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

You can add equally spaced taps to the first primary winding (the upper-left winding) or to the first secondary winding (the upper-right winding). The equivalent circuit of a Multi-Winding Transformer block with one primary winding and eight taps on the first of the two secondary windings is shown in the next figure.

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

The winding terminals are identified by the corresponding winding number. The first winding is the first one on the primary side (upper-left side) and the last winding is the last one on the secondary side (bottom-right side). The polarities of the windings are defined by a plus sign.

The tap terminals are identified by their winding number followed by a dot character and the tap number. Taps are equally spaced so that voltage appearing at no load between two consecutive taps is equal to the total voltage of the winding divided by (number of taps +1). The total winding resistance and leakage inductance of a tapped winding is equally distributed along the taps.

## Ports

### Conserving

<table data-header-hidden><thead><tr><th width="250.5333251953125"></th><th></th></tr></thead><tbody><tr><td><strong>1+</strong> — Primary winding positive polarity<br>Specialized electrical</td><td>Specialized electrical conserving port associated with the primary winding positive polarity.</td></tr><tr><td><strong>1</strong> — Primary winding negative polarity<br>Specialized electrical</td><td>Specialized electrical conserving port associated with the primary winding negative polarity.</td></tr><tr><td><strong>2+</strong> — Secondary winding positive polarity<br>Specialized electrical</td><td>Specialized electrical conserving port associated with the secondary winding positive polarity.</td></tr><tr><td><strong>2</strong> — Secondary winding negative polarity<br>Specialized electrical</td><td>Specialized electrical conserving port associated with the secondary winding negative polarity.</td></tr><tr><td><strong>n+...</strong> — n<sup>th</sup> winding positive polarity<br>Specialized electrical</td><td><p>Specialized electrical conserving port associated with the n<sup>th</sup> winding positive polarity.</p><p><strong>Dependencies</strong> To enable this parameter, set the <strong>Number of windings on the left side</strong> or <strong>Number of windings on the right side</strong> parameters to a value larger than 1.</p></td></tr><tr><td><strong>n...</strong> — n<sup>th</sup> winding negative polarity<br>Specialized electrical</td><td><p>Specialized electrical conserving port associated with the n<sup>th</sup> winding negative polarity.</p><p><strong>Dependencies</strong> To enable this parameter, set the <strong>Number of windings on the left side</strong> or <strong>Number of windings on the right side</strong> parameters to a value larger than 1.</p></td></tr><tr><td><strong>m.1...</strong> — Tap on m<sup>th</sup> winding<br>Specialized electrical</td><td><p>Specialized electrical conserving port associated with a tap on the n<sup>th</sup> winding. The label of these ports depend on the value of the <strong>Tapped winding</strong> and <strong>Number of taps (equally spaced)</strong> parameters.</p><p><strong>Dependencies</strong> To enable this parameter, set the <strong>Number of windings on the left side</strong> or <strong>Number of windings on the right side</strong> parameters to a value larger than 1.</p></td></tr></tbody></table>

## Parameters

### Configuration Tab

<table data-header-hidden><thead><tr><th width="249.73333740234375"></th><th></th></tr></thead><tbody><tr><td><strong>Number of windings on left side</strong> — Number of windings on transformer primary side<br>1 (default) | positive integer</td><td>Specifies the number of windings on the primary side (left side) of the transformer.</td></tr><tr><td><strong>Number of windings on right side</strong> — Number of windings on transformer secondary side<br>3 (default) | positive integer</td><td>Specifies the number of windings on the secondary side (right side) of the transformer.</td></tr><tr><td><strong>Tapped winding</strong> — Specify which winding to tap<br>no taps (default) | taps on upper left winding | taps on upper right winding</td><td><p>Select no taps if you don't want to add taps to the transformer.</p><p>Select taps on upper left winding to add taps to the first winding on the primary side of the transformer.</p><p>Select taps on upper right winding to add taps to the secondary winding on the right side of the transformer.</p><p>The number of taps is specified by the <strong>Number of taps (equally spaced)</strong> parameter.</p></td></tr><tr><td><strong>Number of taps (equally spaced)</strong> — Number of taps on tapped winding<br>2 (default) | positive integer</td><td><p>If the** Tapped winding** parameter is set to taps on upper left winding, you specify the number of taps to add to the first winding on the left side.</p><p>If the** Tapped winding** parameter is set to taps on upper right winding, you specify the number of taps to add to the first winding on the right side.</p><p><strong>Dependencies</strong> To enable this parameter, set <strong>Tapped winding</strong> to a value other than no taps.</p></td></tr><tr><td><strong>Saturable core</strong> — Option to model saturable transformer<br>off (default) | on</td><td><p>If selected, implements a saturable transformer.</p><p>See also the <strong>Saturation characteristic</strong> parameter on the Parameters tab.</p></td></tr><tr><td><strong>Simulate hysteresis</strong> — Whether to model hysteresis<br>off (default) | on</td><td>Select to model hysteresis saturation characteristic instead of a single-valued saturation curve.</td></tr><tr><td><strong>Hysteresis Mat file</strong> — Specify file for hysteresis<br>'hysteresis.mat' (default) | string</td><td><p>Specify a .mat file containing the data to be used for the hysteresis model. When you open the <strong>Hysteresis Design Tool</strong> of the Powergui, the default hysteresis loop and parameters saved in the hysteresis.mat file are displayed. Use the <strong>Load</strong> button of the Hysteresis Design tool to load another .mat file. Use the <strong>Save</strong> button of the Hysteresis Design tool to save your model in a new .mat file.</p><p><strong>Dependencies</strong> To enable this parameter, select <strong>Simulate hysteresis</strong>.</p></td></tr><tr><td><strong>Measurements</strong> — Specify what to measure<br>None (default) | Winding voltages | Winding currents | Flux and excitation current (Im + IRm) | Flux and magnetization current (Im) | All measurement (V, I, Flux)</td><td><p>Select Winding voltages to measure the voltage across the winding terminals of the Saturable Transformer block. Select Winding currents to measure the current flowing through the windings of the Saturable Transformer block.</p><p>Select Flux and excitation current (Im + IRm) to measure the flux linkage, in volt seconds (V.s), and the total excitation current including iron losses modeled by Rm.</p><p>Select Flux and magnetization current (Im) to measure the flux linkage, in volt seconds (V.s), and the magnetization current, in amperes (A), not including iron losses modeled by Rm. Select All measurement (V, I, Flux) to measure the winding voltages, currents, magnetization currents, and the flux linkage.</p><p>Place a Multimeter block in your model to display the selected measurements during the simulation.</p></td></tr></tbody></table>

In the **Available Measurements** list box of the Multimeter block, the measurements are identified by a label followed by the block name.

| **Measurement**       | **Label** |
| --------------------- | --------- |
| Winding voltages      | Uw1:      |
| Winding currents      | Iw1:      |
| Excitation current    | Iexc:     |
| Magnetization current | Imag:     |
| Flux linkage          | Flux:     |

### Parameters Tab

<table data-header-hidden><thead><tr><th width="250.31109619140625"></th><th></th></tr></thead><tbody><tr><td><strong>Units</strong> — Units<br>pu (default) | SI</td><td><p>Specify the units used to enter the parameters of the block. Set to pu to use per unit. Set to SI to use SI units.</p><p>Changing the <strong>Units</strong> parameter from pu to SI or from SI to pu automatically converts the parameters displayed in the mask of the block. The per unit conversion is based on the transformer rated power Pn in VA, nominal frequency fn in Hz, and nominal voltage Vn in Vrms, of the windings.</p></td></tr><tr><td><strong>Nominal power and frequency [Pn(VA) fn(Hz)]</strong> — Nominal power and frequency<br>[75e3 60] (default)</td><td><p>The nominal power rating Pn in VA and frequency fn in Hz, of the transformer.</p><p>This parameter does not impact the transformer model when you set the <strong>Units</strong> parameter to SI.</p></td></tr><tr><td><strong>Winding nominal voltages [U1 U2 ... Un] (Vrms)</strong> — Vector of winding voltage<br>[ 14400 120 120 120 ] (default) | vector</td><td><p>Specify a vector containing the nominal RMS voltages, in Vrms, of the windings on the left side, followed by the nominal RMS voltages of the windings on the right side.</p><p>You don't have to specify the individual tap nominal voltages.</p></td></tr><tr><td><strong>Winding resistances [R1 R2 ... Rn] (Ohm)</strong> — Vector of winding resistance values<br>[ 0.005 0.005 0.005 0.005] (default) | [13.824 0.00096 0.00096 0.00096]</td><td><p>Specify a vector containing the resistance values of the windings on the left side, followed by the resistance values of the windings on the right side.</p><p>You don't have to specify the individual tap resistances. Default is [ 0.005 0.005 0.005 0.005] when the <strong>Units</strong> parameter is pu and [13.824 0.00096 0.00096 0.00096] when the <strong>Units</strong> parameter is SI.</p></td></tr><tr><td><strong>Winding leakage inductances [L1 L2 ... Ln] (H)</strong> — Vector of winding inductance values<br>[ 0.02 0.02 0.02 0.02 ] (default) | [0.14668 1.0186e-05 1.0186e-05 1.0186e-05]</td><td><p>Specify a vector containing the leakage inductance values of the windings on the left side, followed by the leakage inductance values of windings on the right side.</p><p>You don't have to specify the individual tap leakage inductances.</p><p>Default is [ 0.02 0.02 0.02 0.02 ] when the <strong>Units</strong> parameter is pu and [0.14668 1.0186e-05 1.0186e-05 1.0186e-05] when the <strong>Units</strong> parameter is SI.</p></td></tr><tr><td><strong>Magnetization resistance Rm (Ohm)</strong> — Magnetization resistance<br>50 (default) | 1.3824e+05</td><td><p>The magnetization resistance Rm, in ohms or in pu.</p><p>Default is 50 when the <strong>Units</strong> parameter is pu and 1.3824e+05 when the <strong>Units</strong> parameter is SI.</p></td></tr><tr><td><p><strong>Magnetization inductance Lm (H)</strong> — Magnetization inductance for non</p><p>saturable core<br>50 (default) | 366.69</p></td><td><p>The magnetization inductance Lm, in Henry or in pu, for a non-saturable core.</p><p>Default is 50 when the <strong>Units</strong> parameter is pu and 366.69 when the <strong>Units</strong> parameter is SI.</p><p><strong>Dependencies</strong> To enable this parameter, clear the <strong>Saturable core</strong> parameter.</p></td></tr><tr><td><strong>Saturation characteristic [ i1(A) , phi1(V.s) ; i2 , phi2 ; ... ]</strong> — Saturation characteristic for saturable core<br>[ 0,0 ; 0.0024,1.2 ; 1.0,1.52 ] (default) | [0 0;0.017678 64.823;7.3657 82.109]</td><td><p>The saturation characteristic for the saturable core. Specify a series of current/ flux pairs (in pu) starting with the pair (0,0). Default is [ 0,0 ; 0.0024,1.2 ; 1.0,1.52 ] when the <strong>Units</strong> parameter is pu and [0 0;0.017678 64.823;7.3657 82.109] when the <strong>Units</strong> parameter is SI.</p><p><strong>Dependencies</strong> To enable this parameter, select <strong>Saturable core</strong>.</p></td></tr><tr><td><strong>Specify initial flux</strong> — Option to define the initial flux<br>off (default) | on</td><td><p>Select to define the initial flux with the <strong>Initial flux phi0 (pu)</strong> parameter.</p><p>When you clear this parameter, the block automatically computes the initial flux required to start the simulation in steady state. The computed value is saved in the <strong>Initial flux phi0 (pu)</strong> parameter and overwrites any previous value.</p><p><strong>Dependencies</strong> To enable this parameter, select <strong>Saturable core</strong>.</p></td></tr><tr><td><strong>Initial flux phi0 (V.s)</strong> — Initial flux of transformer<br>0 (default) | positive scalar</td><td><p>Initial flux of the transformer. When you clear <strong>Specify initial flux</strong> parameter, the block automatically computes the initial flux required to start the simulation in steady state. The computed value is saved in the** Initial flux phi0 (pu)** parameter and overwrites any previous value.</p><p><strong>Dependencies</strong> To enable this parameter, select <strong>Saturable core</strong> and <strong>Specify initial flux</strong>.</p></td></tr></tbody></table>

### Advanced Tab

<table data-header-hidden><thead><tr><th width="250.444580078125"></th><th></th></tr></thead><tbody><tr><td><strong>Break Algebraic loop in discrete saturation model</strong> — Option to break algebraic loop<br>off (default) | on</td><td><p>When selected, a delay is inserted at the output of the saturation model computing magnetization current as a function of flux linkage (the integral of input voltage computed by a trapezoidal method).</p><p>This delay eliminates the algebraic loop resulting from trapezoidal discretization methods and speeds up the simulation of the model.</p><p>However, the delay introduces a one simulation step time delay in the model and can cause numerical oscillations if the sample time is too large.</p><p>The algebraic loop is required in most cases to get an accurate solution. When cleared (default), the discretization method of the saturation model is specified by the <strong>Discrete solver model</strong> parameter.</p><p><strong>Dependencies</strong> To enable this parameter, add a powergui block to your model, set the <strong>Simulation type</strong> parameter of the powergui block to Discrete, and clear the <strong>Automatically handle discrete solver</strong> parameter of the powerguiblock.</p><p>Also, in the Multi-Winding Transformer block, select <strong>Saturable core</strong> parameter.</p></td></tr><tr><td><strong>Discrete solver model</strong> — Method to resolve algebraic loop<br>Trapezoidal iterative (default) | Trapezoidal robust | Backward Euler robust</td><td><p>Select one of these methods to resolve the algebraic loop.</p><ul><li>Trapezoidal iterative—Although this method produces correct results, it is not recommended because Simulink<sup>®</sup> tends to slow down and may fail to converge (simulation stops), especially when the number of saturable transformers is increased.</li><li>Also, because of the Simulink algebraic loop constraint, this method cannot be used in real time. In R2018b and previous releases, you used this method when the <strong>Break Algebraic loop in discrete saturation model</strong> parameter was cleared.</li><li>Trapezoidal robust—This method is slightly more accurate than the Backward Euler robust method. However, it may produce slightly damped numerical oscillations on transformer voltages when the transformer is at no load.</li><li>Backward Euler robust—This method provides good accuracy and prevents oscillations when the transformer is at no load.</li></ul><p>The maximum number of iterations for the robust methods is specified in the <strong>Preferences</strong> tab of the powergui block, in the <strong>Solver details for nonlinear elements</strong> section. For real time applications, you may need to limit the number of iterations.</p><p>Usually, limiting the number of iterations to 2 produces acceptable results.</p><p>The two robust solvers are the recommended methods for discretizing the saturation model of the transformer.</p><p>For more information on what method to 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></p><p><strong>Dependencies</strong> To enable this parameter, add a powergui block to your model, set the <strong>Simulation type</strong> parameter of the powergui block to Discrete, and clear the <strong>Automatically handle discrete solver</strong> parameter of the powergui block.</p><p>Also, in the Multi-Winding Transformer block, select <strong>Saturable core</strong> and clear the <strong>Break Algebraic loop in discrete saturation model</strong> parameter.</p></td></tr></tbody></table>

## Examples

The [OLTC Regulating Transformer Phasor Model ](https://www.opal-rt.com/docs/smart-power-simulation-software-sps/example-models/power-transmission-and-distribution/oltc-regulating-transformer-phasor-model.md)(power\_OLTCregtransformer) example uses three Multi-Winding Transformer blocks to implement a three-phase On Load Tap Changer (OLTC) transformer.


---

# 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/power-transmission-and-distribution/transformers/multi-winding-transformer.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.
