> 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/three-phase-autotransformer-with-tertiary-winding.md).

# Three Phase Autotransformer with Tertiary Winding

## Description

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

The **Three-Phase Autotransformer with Tertiary Winding** block, located in the **OPAL-RT SPS Software/Power Grid Elements** library, represents a three-phase autotransformer.

The high-voltage side is identified by the **A**, **B**, and **C** ports, the low-voltage side by the **a**, **b**, and **c** ports, and the tertiary-winding by the **a3**, **b3**, and **c3** ports.

### Equivalent Circuit

The equivalent circuit of one phase is shown in the diagram. Each phase consists of three coupled windings: a series winding between the high-voltage terminals and low-voltage terminals, a common winding between the low-voltage terminals and the neutral terminal, and a tertiary winding connected in Delta D1.

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

**Standard Model for Winding Resistances and Inductances**

The resistances and leakage inductances of the three windings are determined from short-circuit test parameters using the following standard equations:

$$
R1 = (R12\*(1+k)/(1-k) + R13 - R23\_{pu})/(1-k)/2 R2 \\= (R12 - R13 + R23\_{pu})/(1-k)/2 R3 \\= (-R12 + R13 + R23\*(1-2\*k))/(1-k)/2 \\\[8pt]
$$

$$
L1 = (L12\*(1+k)/(1-k) + L13 - L23)/(1-k)/2 L2 \\= (L12 - L13 + L23)/(1-k)/2 L3 \\= (-L12 + L13 + L23\*(1-2\*k))/(1-k)/2
$$

where:

* *R12*, *R13*, and *R23* are the RHL, RHT, and RLT short-circuit test resistances.
* *L12*, *L13*, and *L23* are the LHL, LHT, and LLT short-circuit test inductances.
* *k* is the voltage ratio between the high-voltage side and low-voltage side nominal voltages. All parameters are in pu based on the nominal power and nominal voltage of the windings.

The standard equations listed above may produce negative winding resistances and inductances. Although negative values are permitted in phasor models (at 50 Hz or 60 Hz) using algebraic equations, these negative parameters may result in numerical instability in EMT models that use differential equations.

In this case, a warning message suggests you modify the *R23* or the *L23* parameter and proposes a range of values that produce positive resistance and inductance values.

### **Alternate Model for Winding Resistances**

To avoid the limitations of the standard model that may result in negative resistances or very uneven sharing of losses between winding 1 and winding 2, you may choose an alternate model for computing winding resistances.

This alternate model assumes that the Joules losses corresponding to *R12* are equally shared between winding w1 and winding w2 (*R2* = *R1*), which is close to real life.

*R1* and *R2* are in pu and are computed as follows:

$$
R1 = R12/2/(1-k)^2 R2
$$

*R3* is adjusted to obtain the specified *R13* value, as given by the following equation:

$$
R3 = R13 - R1(1-k)^2 - R2k^2
$$

Although this model returns an error on *R23*, this has a limited impact because it affects only the tertiary winding, which is frequently unloaded or feeds a maximum of 10% of autotransformer nominal power.

This model more accurately represents the sharing of currents between winding 1 and winding 2 for DC or very low-frequency phenomena.

For example, during a geomagnetic disturbance that produces very low-frequency earth electrical fields, the resulting geomagnetically induced currents (GICs) throughout the network are dependent on the DC autotransformer model.

## Ports

### Conserving

<table data-header-hidden><thead><tr><th width="249.77764892578125"></th><th></th></tr></thead><tbody><tr><td><strong>A – High-voltage phase A terminal</strong> — Electrical conserving port<br>SPS electrical</td><td>Electrical conserving port associated with the phase A terminal on the high-voltage side of the transformer.</td></tr><tr><td><strong>B – High-voltage phase B terminal</strong> — Electrical conserving port<br>SPS electrical</td><td>Electrical conserving port associated with the phase B terminal on the high-voltage side of the transformer.</td></tr><tr><td><strong>C – High-voltage phase C terminal</strong> — Electrical conserving port<br>SPS electrical</td><td>Electrical conserving port associated with the phase C terminal on the high-voltage side of the transformer.</td></tr><tr><td><strong>N – Neutral terminal</strong> — Electrical conserving port<br>SPS electrical</td><td>Electrical conserving port associated with the neutral terminal of the transformer.</td></tr><tr><td><strong>a – Low-voltage phase A terminal</strong> — Electrical conserving port<br>SPS electrical</td><td>Electrical conserving port associated with the phase A terminal on the low-voltage side of the transformer.</td></tr><tr><td><strong>b – Low-voltage phase B terminal</strong> — Electrical conserving port<br>SPS electrical</td><td>Electrical conserving port associated with the phase B terminal on the low-voltage side of the transformer.</td></tr><tr><td><strong>c – Low-voltage phase C terminal</strong> — Electrical conserving port<br>SPS electrical</td><td>Electrical conserving port associated with the phase C terminal on the low-voltage side of the transformer.</td></tr><tr><td><strong>a3 – Tertiary winding phase A terminal</strong> — Electrical conserving port<br>SPS electrical</td><td>Electrical conserving port associated with the phase A terminal of the tertiary winding.</td></tr><tr><td><strong>b3 – Tertiary winding phase B terminal</strong> — Electrical conserving port<br>SPS electrical</td><td>Electrical conserving port associated with the phase B terminal of the tertiary winding.</td></tr><tr><td><strong>c3 – Tertiary winding phase C terminal</strong> — Electrical conserving port<br>SPS electrical</td><td>Electrical conserving port associated with the phase C terminal of the tertiary winding.</td></tr></tbody></table>

## Parameters

<table data-header-hidden><thead><tr><th width="250.4444580078125"></th><th></th></tr></thead><tbody><tr><td><strong>Pnom (VA) – Transformer nominal power</strong> — Nominal power rating<br>300e6 (default) | positive number</td><td>Nominal power rating of the transformer, in volt-amperes (VA).</td></tr><tr><td><strong>Fnom (Hz) – Transformer nominal frequency</strong> — Nominal frequency<br>60 (default) | positive number</td><td>Nominal frequency of the transformer, in hertz.</td></tr><tr><td><strong>Vnom high-voltage side (VLL rms) – High-voltage side nominal voltage</strong> — Line-to-line nominal voltage<br>315e3 (default) | positive number</td><td>Line-to-line nominal voltage, in volts RMS, on the high-voltage side of the transformer.</td></tr><tr><td><strong>Vnom low-voltage side (VLL rms) – Low-voltage side nominal voltage</strong> — Line-to-line nominal voltage<br>230e3 (default) | positive number</td><td>Line-to-line nominal voltage, in volts RMS, on the low-voltage side of the transformer.</td></tr><tr><td><strong>Vnom tertiary-winding (VLL rms) – Tertiary winding nominal voltage</strong> — Line-to-line nominal voltage<br>12e3 (default) | positive number</td><td>Line-to-line nominal voltage, in volts RMS, of the tertiary winding.</td></tr><tr><td><strong>RHL (pu/Pnom) – Short-circuit test resistance</strong> — Short-circuit resistance<br>0.0016 (default) | positive number</td><td>Short-circuit resistance, in pu, from the high-voltage terminals when the low-voltage terminals are short-circuited.</td></tr><tr><td><strong>RHT (pu/Pnom) – Short-circuit test resistance</strong> — Short-circuit resistance<br>0.0088 (default) | positive number</td><td>Short-circuit resistance, in pu, from the high-voltage terminals when the tertiary terminals are short-circuited.</td></tr><tr><td><strong>RLT (pu/Pnom) – Short-circuit test resistance</strong> — Short-circuit resistance<br>0.0088 (default) | positive number</td><td>Short-circuit resistance, in pu, from the low-voltage terminals when the tertiary terminals are short-circuited.</td></tr><tr><td><strong>Calculation method for resistances – Winding resistances calculation method</strong> — Determine winding resistances<br>evaluated from RHL, RHT, RLT (default) | Evaluated from RHL, RHT ; same losses in R1 &#x26; R2</td><td><p>Select evaluated from RHL, RHT, RLT to use the standard model to determine the winding resistances.</p><p>Select Evaluated from RHL, RHT ; same losses in R1 &#x26; R2 to use the alternate model to determine the winding resistances.</p></td></tr><tr><td><strong>LHL (pu/Pnom) – Short-circuit test inductance</strong> — Short-circuit inductance<br>0.11 (default) | positive number</td><td>Short-circuit inductance, in pu, from the high-voltage terminals when the low-voltage terminals are short-circuited.</td></tr><tr><td><strong>LHT (pu/Pnom) – Short-circuit test inductance</strong> — Short-circuit inductance<br>0.22 (default) | positive number</td><td>Short-circuit inductance, in pu, from the high-voltage terminals when the tertiary terminals are short-circuited.</td></tr><tr><td><strong>LLT (pu/Pnom) – Short-circuit test inductance</strong> — Short-circuit inductance<br>0.12 (default) | positive number</td><td>Short-circuit inductance, in pu, from the low-voltage terminals when the tertiary terminals are short-circuited.</td></tr><tr><td><strong>Core type – Transformer core type</strong> — Core type<br>Three single-phase transformers (default) | Three-limb core (core-type)</td><td><p>Select Three single-phase transformers to implement a three-phase transformer using three single-phase transformer models.</p><p>This core type is used in very large power transformers (hundreds of MW) found in utility grids.</p><p>Select Three-limb core (core-type) to implement a three-limb core three-phase transformer.</p><p>In most applications, three-phase transformers use a three-limb core (core-type transformer).</p><p>This option produces accurate simulation results during an asymmetrical fault for both linear and nonlinear models, including saturation.</p><p>During asymmetrical voltage conditions, the zero-sequence flux of a core-type transformer returns outside the core, through an air gap, structural steel, and a tank. Thus, the natural zero-sequence inductance L0 (without delta winding) of such a core-type transformer is usually very low (typically 0.3 pu &#x3C; L0 &#x3C; 2 pu) compared with a three-phase transformer using three single-phase units (L0 > 100 pu).</p><p>This low L0 value affects voltages, currents, and flux unbalances during linear and saturated operation.</p></td></tr><tr><td><strong>Inductance L0 of zero-sequence flux path return (pu) – Three-limb core transformer inductance</strong> — Inductance L0<br>0.5 (default) | scalar number</td><td><p>Inductance L0, in pu, of the three-limb core transformer.</p><p><strong>Dependencies</strong> To enable this parameter, set <strong>Core Type</strong> to Three single-phase transformers.</p></td></tr><tr><td><strong>Magnetization resistance Rm (pu/Pnom) – Magnetization resistance</strong> — Magnetization resistance<br>500 (default) | scalar number</td><td>Magnetization resistance Rm, in pu.</td></tr><tr><td><strong>Magnetization inductance Lm (pu/Pnom) – Magnetization inductance</strong> — Magnetization inductance<br>500 (default) | scalar number</td><td><p>Magnetization inductance Lm, in pu, for a nonsaturable core.</p><p><strong>Dependencies</strong> To enable this parameter, clear <strong>Simulate saturation</strong>.</p></td></tr><tr><td><strong>Simulate saturation – Activate transformer saturation</strong> — Implement saturable core<br>off (default) | on</td><td>Select to implement a saturable core.</td></tr><tr><td><strong>Saturation characteristic [i1 phi1; i2 phi2; ...] – Saturation characteristic</strong> — Saturation characteristic<br>[ 0,0 ; 0.0024,1.2 ; 1.0,1.52 ] (default) | matrix</td><td><p>Saturation characteristic for the saturable core. Specify a series of current and flux pairs, in pu, starting with the pair (0, 0).</p><p><strong>Dependencies</strong> To enable this parameter, select <strong>Simulate saturation</strong>.</p></td></tr><tr><td><strong>Specify initial fluxes – Activate initial flux specification</strong> — Define initial fluxes<br>off (default) | on</td><td><p>Select to define the initial fluxes with the** Initial fluxes [phi0A, phi0B, phi0C]** parameter. When the <strong>Specify initial fluxes</strong> parameter is not selected upon simulation, the Simscape™ Electrical™ SPS software automatically computes the initial fluxes to start the simulation in steady state.</p><p>The computed values are saved in the <strong>Initial Fluxes</strong> parameter and overwrite any previous values.</p><p><strong>Dependencies</strong> To enable this parameter, select <strong>Simulate saturation</strong>.</p></td></tr><tr><td><strong>Initial fluxes [phi0A , phi0B , phi0C] – Initial fluxes</strong> — Specifies initial fluxes<br>[0, 0, 0] (default) | vector of 3 values</td><td><p>Specifies initial fluxes for each phase of the transformer. When the <strong>Specify initial fluxes</strong> parameter is not selected upon simulation, the Simscape Electrical SPS software automatically computes the initial fluxes to start the simulation in steady state.</p><p>The computed values are saved in the <strong>Initial Fluxes</strong> parameter and overwrite any previous values.</p><p><strong>Dependencies</strong> To enable this parameter, select <strong>Simulate saturation</strong> and <strong>Specify initial fluxes</strong>.</p></td></tr><tr><td><strong>Measurements – Measurements</strong> — Measurements<br>None (default) | Winding voltages | Fluxes and excitation currents ( Imag + IRm ) | Fluxes and magnetization currents ( Imag ) | All measurements (V I Flux)</td><td><p>Select Winding voltages to measure the voltage across the winding terminals.</p><p>Select Fluxes and excitation currents ( Imag + 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 Fluxes and magnetization currents ( Imag ) to measure the flux linkage, in volt seconds (V.s), and the magnetization current, in amperes (A), not including iron losses modeled by Rm.</p><p>Select All measurements (V I Flux) to measure the winding voltages, magnetization currents, and the flux linkages. Place a Multimeter block in your model to display the selected measurements during the simulation.</p><p>In the <strong>Available Measurements</strong> parameter of the Multimeter block, the measurements are identified by a label followed by the block name.</p></td></tr></tbody></table>

### Advanced

<table data-header-hidden><thead><tr><th width="249.99993896484375"></th><th></th></tr></thead><tbody><tr><td><strong>Break Algebraic loop in discrete saturation model – Activate Break algebraic loop in discrete saturation model</strong> — Insert delay<br>off (default) | on</td><td><p>Select to insert a delay at the output of the saturation model that computes the 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 that results from trapezoidal discretization methods and speeds up the simulation of the model. However, the delay introduces one time 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 this parameter is cleared, the discretization method of the saturation model is specified by the <strong>Discrete solver model</strong> parameter.</p></td></tr><tr><td><strong>Discrete solver model – Discrete solver model</strong> — Resolve algebraic loop<br>Trapezoidal robust (default) | Trapezoidal iterative | 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 and stop simulation, especially if the model has a large number of transformers Also, because of the Simulink algebraic loop constraint, this method cannot be used in real time.</li><li>In R2018b and previous releases, this is setting is used when <strong>Break Algebraic loop in discrete saturation model</strong> parameter is cleared.</li><li>Trapezoidal robust — This method is slightly more accurate than the Backward Euler robust method.</li><li>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>The two robust solvers are the recommended methods for discretizing the saturation model of the transformer.</p><p>For more information on which 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, clear <strong>Break Algebraic loop in discrete saturation model</strong>.</p></td></tr></tbody></table>

## Examples

[Impact of GIC on Autotransformer Saturatio](https://www.opal-rt.com/docs/smart-power-simulation-software-sps/example-models/power-transmission-and-distribution/impact-of-gic-on-autotransformer-saturation.md)n Illustrates the impact of Geomagnetic Induced Currents (GIC) on autotransformer saturation.


---

# 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/three-phase-autotransformer-with-tertiary-winding.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.
