> 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-tap-changing-transformer-three-windings.md).

# Three-Phase Tap-Changing Transformer (Three-Windings)

## Description

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

The **Three-Phase Tap-Changing Transformer (Three-Windings)** block, located in the **OPAL-RT SPS Software/Power Grid Elements** library, models a three-phase, tap-changing transformer with three windings. The tap changer is on winding 1. Winding 1 is connected in wye. Windings 2 and 3 can be connected in wye or delta.

The transformer voltage ratio is determined by the position of the tap and by the method used to control it. When **Mode** is set to Tap control, the position of the tap is controlled by the input signal. When **Mode** is set to Voltage regulation, the position of the tap is controlled by an internal voltage regulator that compares the input signal to the reference voltage.

When you use a Three-Phase Tap-Changing Transformer block, set the powergui block **Simulation type** to Discrete and select **Automatically handle Discrete solver**.

The robust discrete solver is used to discretize the electrical model. Simulink® returns an error if the robust discrete solver is not used.

## Ports

### Conserving

<table data-header-hidden><thead><tr><th width="249.99993896484375"></th><th></th></tr></thead><tbody><tr><td><strong>A – Winding 1 phase A terminal</strong> — Electrical conserving port<br>SPS electrical</td><td>Electrical conserving port associated with the phase A terminal of winding 1.</td></tr><tr><td><strong>B – Winding 1 phase B terminal</strong> — Electrical conserving port<br>SPS electrical</td><td>Electrical conserving port associated with the phase B terminal of winding 1.</td></tr><tr><td><strong>C – Winding 1 phase C terminal</strong> — Electrical conserving port<br>SPS electrical</td><td>Electrical conserving port associated with the phase C terminal of winding 1.</td></tr><tr><td><strong>N – Winding 1 neutral terminal</strong> — Electrical conserving port<br>SPS electrical</td><td>Electrical conserving port associated with the neutral terminal of winding 1.</td></tr><tr><td><strong>a2 – Winding 2 phase A terminal</strong> — Electrical conserving port<br>SPS electrical</td><td>Electrical conserving port associated with the phase A terminal of winding 2.</td></tr><tr><td><strong>b2 – Winding 2 phase B terminal</strong> — Electrical conserving port<br>SPS electrical</td><td>Electrical conserving port associated with the phase B terminal of winding 2.</td></tr><tr><td><strong>c2 – Winding 2 phase C terminal</strong> — Electrical conserving port<br>SPS electrical</td><td>Electrical conserving port associated with the phase C terminal of winding 2.</td></tr><tr><td><strong>a3 – Winding 3 phase A terminal</strong> — Electrical conserving port<br>SPS electrical</td><td>Electrical conserving port associated with the phase A terminal of winding 3.</td></tr><tr><td><strong>b3 – Winding 3 phase B terminal</strong> — Electrical conserving port<br>SPS electrical</td><td>Electrical conserving port associated with the phase B terminal of winding 3.</td></tr><tr><td><strong>c3 – Winding 3 phase C terminal</strong> — Electrical conserving port<br>SPS electrical</td><td>Electrical conserving port associated with the phase C terminal of winding 3.</td></tr></tbody></table>

### Simulink

<table data-header-hidden><thead><tr><th width="250.22210693359375"></th><th></th></tr></thead><tbody><tr><td><strong>ctrl – Control input</strong> — Signal used to control tap position Scalar</td><td><p>Signal used to control the tap position of the transformer. The tap position of the transformer increases when the <strong>ctrl</strong> input signal becomes greater than the specified <strong>Threshold</strong> parameter value.</p><p>The tap position decreases when the <strong>ctrl</strong> input signal becomes less than the negative of the <strong>Threshold</strong> parameter value.</p><p><img src="https://799605156-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FdlNg8IbOdahCpFCyzxSN%2Fuploads%2Fgit-blob-ddd78c75ec4ac5e6d192eaf2b77234b29c807707%2F3P_tapcahning_transformer_ctrlinput.png?alt=media" alt="" data-size="original"></p><p>The new tap position becomes effective after the time specified by the <strong>Tap selection time</strong> parameter.</p><p><strong>Dependencies</strong> To enable this port, set <strong>Mode</strong> to Tap Control.</p></td></tr><tr><td><strong>Vm (pu) – Measured voltage signal</strong> — Signal used to control tap position Scalar</td><td><p>Signal used to control the tap position of the transformer with an internal voltage regulator. Use the magnitude of voltage, in pu, measured at one of the two secondary windings (winding 2 or winding 3) or at a remote bus.</p><p>The tap position of the transformer increases when the difference between the <strong>Vm (pu)</strong> input signal and the <strong>Reference voltage Vref</strong> parameter value becomes greater than the value of the <strong>Dead band</strong> parameter divided by 2, for a time duration greater than the <strong>Delay</strong> parameter value.</p><p>The tap position decreases when the difference between the <strong>Vm (pu)</strong> input signal and the <strong>Reference voltage Vref (pu)</strong> parameter value becomes lower than the value of the negative of the <strong>Dead band</strong> parameter divided by 2, for a time duration greater than the <strong>Delay</strong> parameter value.</p><p><strong>Dependencies</strong> To enable this port, set <strong>Mode</strong> to Voltage regulation.</p></td></tr><tr><td><strong>Tap – Tap position value</strong> — Output signal Integer</td><td>Output signal that gives the current tap position.</td></tr></tbody></table>

## Parameters

### Transformer

<table data-header-hidden><thead><tr><th width="250.08892822265625"></th><th></th></tr></thead><tbody><tr><td><strong>[Pnom(VA), Fnom(Hz)] – Transformer nominal parameters</strong> — Nominal power rating<br>[ 47e6 , 60] (default) | two-element vector</td><td>Nominal power rating, in volt-amperes (VA), and nominal frequency, in hertz (Hz), of the transformer.</td></tr><tr><td><strong>Winding 1 connection (ABC)</strong> — Winding connection<br>Yn (default)</td><td>Winding connection for winding 1.</td></tr><tr><td><strong>Winding 1 [V1 Ph-Ph(Vrms), R1(pu), L1(pu)] – Winding 1 parameters</strong> — Phase-to-phase nominal voltage<br>[120e3, 0.003, 0.09] (default) | three-element vector</td><td>Phase-to-phase nominal voltage, in volts RMS, and resistance and leakage inductance, in pu, for winding 1.</td></tr><tr><td><strong>Winding 2 connection (abc2) – Winding 2 connection</strong> — Winding connection<br>Delta (D1) (default) | Y | Yg | Delta (D11)</td><td>Winding connection for winding 2.</td></tr><tr><td><strong>Winding 2 parameters [ V2 Ph-Ph(Vrms), R2(pu), L2(pu)] – Winding 2 parameters</strong> — Phase-to-phase nominal voltage<br>[ 25e3 , 0.003 , 0.09 ] (default) | three-element vector</td><td>Phase-to-phase nominal voltage, in volts RMS, and resistance and leakage inductance, in pu, for winding 2.</td></tr><tr><td><strong>Winding 3 connection (abc3) – Winding 3 connection</strong> — Winding connection<br>Delta (D1) (default) | Y | Yg | Delta (D11)</td><td>Winding connection for winding 3.</td></tr><tr><td><strong>Winding 3 [V2 Ph-Ph(Vrms) , R3(pu) , L3(pu)] – Winding 3 parameters</strong> — Phase-to-phase nominal voltage<br>[ 25e3 , 0.003 , 0.09 ] (default) | three-element vector</td><td>Phase-to-phase nominal voltage, in volts RMS, and resistance and leakage inductance, in pu, for winding 3.</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 found in utility grids.</p><p>Select Three-limb core (core type) to implement a three-limb core three-phase transformer. In most applications, three-phase transformers use a three-limb core (core-type transformer).</p><p>Selecting this core type will produce accurate 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 tank. Consequently, the natural zero-sequence inductance L0 (without delta winding) of a core-type transformer is usually very low (typically 0.3 pu &#x3C; L0 &#x3C; 2 pu) compared with a three-phase transformer that uses 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 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-limb core (core type).</p></td></tr><tr><td><strong>Rm (pu) – Magnetisation resistance</strong> — Magnetization resistance<br>500 (default) | scalar number</td><td>Magnetization resistance Rm, in pu.</td></tr><tr><td><strong>Lm (pu) – 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 three-phase transformer<br>off (default) | on</td><td>Select this parameter to implement a saturable three-phase transformer.</td></tr><tr><td><strong>[i1 , phi1 ; i2 , phi2 ; ... ] (pu) – 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> — Specify initial fluxes<br>off (default) | on</td><td><p>If selected, the initial fluxes are defined by the <strong>[phi0A, phi0B, phi0C] (pu)</strong> parameter. When the <strong>Specify initial fluxes</strong> parameter is cleared, the SPS software automatically computes the initial fluxes to start the simulation in steady state. 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>[phi0A , phi0B , phi0C] (pu) – Initial fluxes</strong> — Initial fluxes<br>[ -1.0 0.5 0.5] (default) | vector of 3 values</td><td><p>Initial fluxes for each phase of the transformer.</p><p>When the <strong>Specify initial fluxes</strong> parameter is not selected upon simulation, the SPS software automatically computes the initial fluxes to start the simulation in steady state. 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 | Winding currents | Fluxes and excitation currents ( Imag + IRm ) | Fluxes and magnetization currents ( Imag ) | All measurements (V I Fluxes)</td><td><p>Select Winding voltages to measure the voltage across the winding terminals.</p><p>Select Winding currents to measure the current flowing through the windings. 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. Select All measurements (V I Fluxes) to measure the winding voltages, currents, magnetization currents, and the flux linkages.</p><p>Place a <a href="https://opal-rt.atlassian.net/wiki/spaces/PSPS/pages/1551830628/Multimeter">Multimeter</a> block in your model to display the selected measurements during simulation. In the <strong>Available Measurements</strong> parameter of the <a href="https://opal-rt.atlassian.net/wiki/spaces/PSPS/pages/1551830628/Multimeter">Multimeter</a> block, the measurements are identified by a label followed by the block name.</p></td></tr></tbody></table>

### Tap-Changer

<table data-header-hidden><thead><tr><th width="250.22216796875"></th><th></th></tr></thead><tbody><tr><td><strong>Minimum tap position – Minimum tap position of transformer</strong> — Minimum tap position<br>-20 (default) | integer</td><td><p>Minimum tap position of the transformer. This value is typically between -20 and +20. At the minimum tap position, the transformer voltage ratio is: U2/U1 = 1 /( 1+ <strong>Minimum tap position</strong> * <strong>Voltage step per tap (pu)</strong>).</p><p>For example, for a minimum tap position of -20 and a voltage step of 0.015, the voltage ratio is: U2/U1 = 1/(1+ -20*0.015) = 1.428 pu.</p></td></tr><tr><td><strong>Maximum tap position – Maximum tap position of transformer</strong> — Maximum tap position<br>20 (default) | integer</td><td><p>Maximum tap position of the transformer. This value is typically between -20 and +20. At the maximum tap position, the transformer voltage ratio is: U2/U1 = 1 /(1+ <strong>Maximum tap position</strong> * <strong>Voltage step per tap (pu)</strong>).</p><p>For example, for a maximum tap position of +20 and a voltage step of 0.015, the voltage ratio is: U2/U1 = 1/(1+ 20*0.015) = 0.769 pu.</p></td></tr><tr><td><strong>Initial tap position – Initial tap position of transformer</strong> — Initial tap position<br>0 (default) | integer</td><td><p>Initial position of the tap when the simulation starts. The initial position must be a value between the minimum tap position and the maximum tap position.</p><p>When the tap position is 0, the transformer voltage ratio is equal to 1 pu (nominal value).</p></td></tr><tr><td><strong>Voltage step per tap (pu) – Voltage step between two taps</strong> — Voltage step<br>0.015 (default) | positive scalar</td><td><p>Voltage step between two taps of the transformer, in pu. This value is typically in the order of 0.01 to 0.05 pu.</p><p>The transformer voltage ratio is given by: U2/U1 = 1 /(1+ <strong>Tap position</strong> * <strong>Voltage step per tap (pu)</strong>). For example, a voltage step per tap value of 0.015, and a tap position of -20, would produce a voltage ratio of: U2/U1 = 1/(1+ -20*0.015) = 1.428 pu.</p><p>The value of the <strong>Voltage step per tap (pu)</strong> parameter must be chosen in accordance with the value specified for the <strong>Minimum tap position</strong> parameter.</p><p>Follow this constraint according to the above equation:<strong>Minimum tap position</strong> * <strong>Voltage step per tap</strong> > -1 For example, for a <strong>Voltage step per tap (pu)</strong> parameter of 0.05 pu, the minimum value you can specify for the <strong>Minimum tap position</strong> parameter is: -19.</p><p>A value of –20 gives an infinite voltage ratio and a value lower than -20 yields to a negative voltage ratio, which is not relevant.</p></td></tr><tr><td><strong>Tap selection time (s) – Time delay</strong> — Time for tap to move<br>0.5 (default)</td><td>Time for the tap to move from one position to the next. This value is typically between 3 and 10 seconds.</td></tr><tr><td><strong>Mode – Tap changer control mode</strong> — Control tap position<br>Tap control (default) | Voltage regulation</td><td>Select Tap control to control the tap position of the transformer with the <strong>ctrl</strong> input signal. Select Voltage regulation to control the tap position of the transformer using an internal voltage regulator monitoring the <strong>Vm (pu)</strong> input signal.</td></tr><tr><td><strong>Threshold – Control value threshold</strong> — Control value at which tap changes position<br>0.5 (default)</td><td><p>Control value at which the tap changes position. To increase the tap position, apply a control signal <strong>ctrl</strong> greater than this value.</p><p>To lower the tap position, apply a control signal <strong>ctrl</strong> smaller than the negative of this value.</p><p><strong>Dependencies</strong> To enable this parameter, set <strong>Mode</strong> to Tap control.</p></td></tr><tr><td><strong>Reference voltage Vref (pu) – Voltage regulator reference voltage</strong> — Reference voltage<br>1.0 (default) | positive scalar</td><td><p>Reference voltage of the voltage regulator, in pu.</p><p><strong>Dependencies</strong> To enable this parameter, set <strong>Mode</strong> to Voltage regulation.</p></td></tr><tr><td><strong>Dead band (pu) – Voltage regulator dead band</strong> — Dead band of voltage regulator<br>0.03 (default)</td><td><p>Dead band of the voltage regulator, in pu. Reference voltage of the voltage regulator, in pu.</p><p><strong>Dependencies</strong> To enable this parameter, set <strong>Mode</strong> to Voltage regulation.</p></td></tr><tr><td><strong>Delay (sec) – Voltage regulator delay</strong> — Delay of voltage regulator<br>0.4 (default)</td><td><p>Delay of the voltage regulator, in sec.</p><p><strong>Dependencies</strong> To enable this parameter, set <strong>Mode</strong> to Voltage regulation.</p></td></tr></tbody></table>

## Examples

[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) illustrates the operation of two models of on load tap changer (OLTC) regulating 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/three-phase-tap-changing-transformer-three-windings.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.
