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

# Three-Phase 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-ae3dc5c6bd7ad247358da85a517aaa140a85d7c7%2F3P_transformer_3winding_block.png?alt=media" alt=""><figcaption></figcaption></figure>

The **Three-phase transformer (Three-Windings)** block, located in the **OPAL-RT SPS Software/Power Grid Elements** library, implements a three-phase transformer by using three single-phase transformers with three windings. For a detailed description of the electrical model of a single-phase transformer, see the [Linear Transformer](https://www.opal-rt.com/docs/smart-power-simulation-software-sps/blocks-functions-tools/power-transmission-and-distribution/transformers/linear-transformer.md) block.

When activated, the saturation characteristic is the same as the one described for the Saturable Transformer block.

If the fluxes are not specified, the initial values are automatically adjusted so that the simulation starts in steady state.

The leakage inductances and resistance of each winding are given in pu based on the transformer nominal power Pn and on the nominal voltage of the winding (V1, V2, or V3). For an explanation of per units, refer to the Linear Transformer and to the Saturable Transformer.

The three windings of the transformer can be connected in the following manner:

* Y
* Y with accessible neutral (for windings 1 and 3 only)
* Grounded Y
* Delta (D1), delta lagging Y by 30 degrees
* Delta (D11), delta leading Y by 30 degrees An input port labeled N is added to the block if you select the Y connection with accessible neutral for winding 1. If you ask for an accessible neutral on winding 3, an extra outport port labeled n3 is generated.

The D1 and D11 notations refer to the following clock convention. It assumes that the reference Y voltage phasor is at noon (12) on a clock display. D1 and D11 refer respectively to 1 PM (delta voltages lagging Y voltages by 30 degrees) and 11 AM (delta voltages leading Y voltages by 30 degrees).

### Standard Notation for Winding Connections

The conventional notation for a two-winding three-phase transformer uses two letters followed by a number. The first letter (Y or D) indicates a high-voltage wye or delta winding connection. The second letter (y or d) indicates a low-voltage wye or delta winding connection. The number, an integer between 0 and 12, indicates the position of the low-voltage positive-sequence voltage phasor on a clock display when the high-voltage positive-sequence voltage phasor is at 12:00.

The following three figures are examples of standard winding connections. The dots indicate polarity marks, and arrows indicate the position of phase A-to-neutral voltage phasors on high-voltage and low-voltage windings. The phasors are assumed to rotate in a counterclockwise direction so that rising numbers indicate increasing phase lag.

* Yd1: The low-voltage winding (d) is lagging high-voltage winding (Y) by 30 degrees. The **Winding 2 connection** parameter is set to **D1**.

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

* Dy11: The low-voltage winding (y) is leading high-voltage winding (D) by 30 degrees. The **Winding 1 connection** parameter is set to **D1**.

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

* Dy1: The low-voltage winding (y) is lagging high-voltage winding (D) by 30 degrees. The **Winding 1 connection** parameter is set to **D11**.

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

You can represent many other connections with phase shifts between 0 and 360 degrees (by steps of 30 degrees) by combining the +30- or –30-degree phase shift provided by the D1 and D11 block parameter settings and, in some cases, an additional +/–120-degree phase shift obtained by connecting the output terminals of delta winding to the appropriate phases of the network.

The table explains how to set up the Three-Phase Transformer block to obtain common connections.

<table data-header-hidden><thead><tr><th width="114.66668701171875"></th><th></th><th width="121.77783203125"></th><th width="115.4444580078125"></th><th width="115.7777099609375"></th><th></th></tr></thead><tbody><tr><td><strong>Clock Position</strong></td><td><strong>Phase Shift (degrees)</strong></td><td><strong>Connection</strong></td><td><strong>Winding 1 Connection</strong></td><td><strong>Winding 2 Connection</strong></td><td><strong>Terminals of Delta Winding to Connect to Network ABC Phases</strong></td></tr><tr><td>0</td><td>0</td><td>Yy0</td><td>Y</td><td>Y</td><td>—</td></tr><tr><td>Dd0</td><td>D1</td><td>D1</td><td>abc</td><td></td><td></td></tr><tr><td>1</td><td>–30</td><td>Yd1</td><td>Y</td><td>D1</td><td>abc</td></tr><tr><td>Dy1</td><td>D11</td><td>Y</td><td>abc</td><td></td><td></td></tr><tr><td>2</td><td>–60</td><td>Dd2</td><td>D11</td><td>D1</td><td>abc</td></tr><tr><td>5</td><td>–150</td><td>Yd5</td><td>Y</td><td>D1</td><td>bca</td></tr><tr><td>Dy5</td><td>D11</td><td>Y</td><td>cab</td><td></td><td></td></tr><tr><td>7</td><td>+150</td><td>Yd7</td><td>Y</td><td>D11</td><td>cab</td></tr><tr><td>Dy7</td><td>D1</td><td>Y</td><td>bca</td><td></td><td></td></tr><tr><td>10</td><td>+60</td><td>Dd10</td><td>D1</td><td>D11</td><td>abc</td></tr><tr><td>11</td><td>+30</td><td>Yd11</td><td>Y</td><td>D11</td><td>abc</td></tr><tr><td>Dy11</td><td>D1</td><td>Y</td><td>abc</td><td></td><td></td></tr></tbody></table>

For example, to obtain the Yd5 connection, set the **Winding 1 connection** parameter to **Y** and the **Winding 2 connection** parameter to **D1**, and connect the network phases to the winding 2 as follows:

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

For more details on conventional transformer winding notations, see International Standard IEC 60076-1 \[1].

## Ports

### Conserving

<table data-header-hidden><thead><tr><th width="248.88885498046875"></th><th></th></tr></thead><tbody><tr><td><strong>A</strong> — Winding 1 phase A terminal<br>SPS electrical</td><td>SPS electrical conserving port associated with the phase A terminal of winding 1.</td></tr><tr><td><strong>B</strong> — Winding 1 phase B terminal<br>SPS electrical</td><td>SPS electrical conserving port associated with the phase B terminal of winding 1.</td></tr><tr><td><strong>C</strong> — Winding 1 phase C terminal<br>SPS electrical</td><td>SPS electrical conserving port associated with the phase C terminal of winding 1.</td></tr><tr><td><strong>N</strong> — Winding 1 neutral terminal<br>SPS electrical</td><td><p>SPS electrical conserving port associated with the neutral terminal of winding 1.</p><p><strong>Dependencies</strong> To enable this port, set the <strong>Winding 1 connection (ABC terminals)</strong> parameter to Yn.</p></td></tr><tr><td><strong>a2</strong> — Winding 2 phase A terminal<br>SPS electrical</td><td>SPS electrical conserving port associated with the phase A terminal of winding 2.</td></tr><tr><td><strong>b2</strong> — Winding 2 phase B terminal<br>SPS electrical</td><td>SPS electrical conserving port associated with the phase B terminal of winding 2.</td></tr><tr><td><strong>c2</strong> — Winding 2 phase C terminal<br>SPS electrical</td><td>SPS electrical conserving port associated with the phase C terminal of winding 2.</td></tr><tr><td><strong>n2</strong> — Winding 2 neutral terminal<br>SPS electrical</td><td><p>Electrical conserving port associated with the neutral terminal of winding 2.</p><p><strong>Dependencies</strong> To enable this port, set the <strong>Winding 2 connection (abc-2 terminals)</strong> parameter to Yn.</p></td></tr><tr><td><strong>a3</strong> — Winding 3 phase A terminal<br>Specialized electrical</td><td>SPS electrical conserving port associated with the phase A terminal of winding 3.</td></tr><tr><td><strong>b3</strong> — Winding 3 phase B terminal<br>Specialized electrical</td><td>SPS electrical conserving port associated with the phase B terminal of winding 3.</td></tr><tr><td><strong>c3</strong> — Winding 3 phase C terminal<br>Specialized electrical</td><td>SPS electrical conserving port associated with the phase C terminal of winding 3.</td></tr><tr><td><strong>n3</strong> — Winding 3 neutral terminal<br>Specialized electrical</td><td><p>SPS electrical conserving port associated with the neutral terminal of winding 3.</p><p><strong>Dependencies</strong> To enable this port, set the <strong>Winding 3 connection (abc-3 terminals)</strong> parameter to Yn.</p></td></tr></tbody></table>

## Parameters

### Configuration

<table data-header-hidden><thead><tr><th width="249.19989013671875"></th><th></th></tr></thead><tbody><tr><td><strong>Winding 1 connection (ABC terminals)</strong> — Winding connections for winding 1<br>Yg (default) | Yn | Y | Delta (D1) | Delta (D11)</td><td>Winding connections for winding 1. Choices are Y, Yn, Yg (default), Delta (D1), and Delta (D11).</td></tr><tr><td><strong>Winding 2 connection (abc-2 terminals)</strong> — Winding connections for winding 2<br>Yg (default) | YnY | Delta (D1) | Delta (D11)</td><td>Winding connections for winding 2. Choices are Y, Yn, Yg (default), Delta (D1), and Delta (D11).</td></tr><tr><td><strong>Winding 3 connection (abc-3 terminals)</strong> — Winding connections for winding 3<br>Yg (default) | YnY | Delta (D1) | Delta (D11)</td><td>Winding connections for winding 3. Choices are Y, Yn, Yg (default), Delta (D1), and Delta (D11).</td></tr><tr><td><strong>Type</strong> — Type of transformer<br>Three single-phase transformers (default) | Three-limb core (core-type) | Five-limb core (shell-type)</td><td><p>Select Three single-phase transformers (default) to implement a three-phase transformer using three single-phase transformer models.</p><p>You can use this core type to represent very large power transformers found in utility grids (hundreds of MW). 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 type of core produces accurate results during an asymmetrical fault for both linear and nonlinear models (including saturation). 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.</p><p>Thus, the natural zero-sequence inductance L0 (without delta winding) of such a core-type transformer is usually very low (typically 0.5 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><p>Select Five-limb core (shell type) to implement a five-limb core three-phase transformer. On rare occasions, very large transformers are built with a five-leg core (three phase legs and two external legs).</p><p>This core configuration, also known as shell type, is chosen mainly to reduce the height of the transformer and make transportation easier. During unbalanced voltage conditions, as opposed to the three-limb transformer, the zero-sequence flux of the five-limb transformer stays inside the steel core and returns through the two external limbs.</p><p>The natural zero-sequence inductance (without delta) is therefore very high (L0 > 100 pu). Except for small current unbalances due to core asymmetry, the behavior of the five-limb shell-type transformer is similar to that of a three-phase transformer built with three single-phase units.</p></td></tr><tr><td><strong>Simulate saturation</strong> — Option to simulate saturation<br>off (default) | on</td><td>If selected, implements a saturable three-phase transformer.</td></tr><tr><td><strong>Simulate hysteresis</strong> — Option to simulate hysteresis<br>off (default) | on</td><td><p>Select to model a saturation characteristic including hysteresis instead of a single-valued saturation curve.</p><p><strong>Dependencies</strong> To enable this parameter, select the <strong>Simulate saturation</strong> parameter.</p></td></tr><tr><td><strong>Hysteresis Mat file (ex: 'hysteresis.mat')</strong> — File containing data for use in hysteresis model<br>'hysteresis' (default)</td><td><p>Specify a .mat file containing the data for use in the hysteresis model. When you open the <strong>Hysteresis Design Tool</strong> of the Powergui block, the default hysteresis loop and parameters saved in the hysteresis.mat file are displayed.</p><p>Use the <strong>Load</strong> button of the Hysteresis Design tool to load another .mat file.</p><p>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 the <strong>Simulate hysteresis</strong> parameter.</p></td></tr><tr><td><strong>Specify initial fluxes</strong> — Option to specify initial fluxes<br>off (default) | on</td><td><p>If selected, the initial fluxes are defined by the <strong>Initial fluxes</strong> parameter on the <strong>Parameters</strong> tab.</p><p>When the <strong>Specify initial fluxes</strong> parameter is not selected upon simulation, 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 will overwrite any previous values.</p><p><strong>Dependencies</strong> To enable this parameter, select the <strong>Simulate saturation</strong> parameter.</p></td></tr><tr><td><strong>Measurements</strong> — Type of 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 of the Three-Phase Transformer block.</p><p>Select Winding currents to measure the current flowing through the windings of the Three-Phase Transformer block.</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, currents, magnetization currents, and the flux linkages.</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.

If the **Winding 1 connection (ABC terminals)** parameter is set to Y, Yn, or Yg, the labels are as follows.

| **Measurement**            | **Label**                               |
| -------------------------- | --------------------------------------- |
| **Winding 1 voltages**     | <p>Uan\_w1:</p><p>or</p><p>Uag\_w1:</p> |
| **Winding 1 currents**     | <p>Ian\_w1:</p><p>or</p><p>Iag\_w1:</p> |
| **Flux linkages**          | Flux\_A:                                |
| **Magnetization currents** | Imag\_A:                                |
| **Excitation currents**    | Iexc\_A:                                |

The same labels apply for winding 2 and winding 3, except that the 1 is replaced by 2 or by 3 in the labels. If the **Winding 1 connection (ABC terminals)** parameter is set to Delta (D11) or Delta (D1), the labels are as follows.

| **Measurement**            | **Label** |
| -------------------------- | --------- |
| **Winding 1 voltages**     | Uab\_w1:  |
| **Winding 1 currents**     | Iab\_w1:  |
| **Flux linkages**          | Flux\_A:  |
| **Magnetization currents** | Imag\_A:  |
| **Excitation currents**    | Iexc\_A:  |

### Parameters

<table data-header-hidden><thead><tr><th width="250"></th><th></th></tr></thead><tbody><tr><td><strong>Units</strong> — Units of block parameters<br>pu (default) | SI</td><td><p>Specify the units used to enter the parameters of this block. Select pu to use per unit. Select SI to use SI units. 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.</p><p>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</strong> — Nominal power rating and frequency<br>[ 250e6 , 60 ] (default)</td><td><p>Nominal power rating, in volt-amperes (VA), and nominal frequency, in hertz (Hz), of the transformer.</p><p>The nominal parameters have no impact on the transformer model when the <strong>Units</strong> parameter is set to SI.</p></td></tr><tr><td><strong>Winding 1 parameters</strong> — Parameters of winding 1<br>[ 735e3 , 0.002 , 0.08 ] (default) | [7.35e+05 4.3218 0.45856]</td><td><p>Phase-to-phase nominal voltage in volts RMS, resistance, and leakage inductance in pu for winding 1.</p><p>Default is [ 735e3 , 0.002 , 0.08 ] when the <strong>Units</strong> parameter is pu and [7.35e+05 4.3218 0.45856] when the <strong>Units</strong> parameter is SI.</p></td></tr><tr><td><strong>Winding 2 parameters</strong> — Parameters of winding 2<br>[ 315e3 , 0.002 , 0.08 ] (default) | [3.15e+05 0.7938 0.084225]</td><td><p>Phase-to-phase nominal voltage in volts RMS, resistance, and leakage inductance in pu for winding 2.</p><p>Default is [ 315e3 , 0.002 , 0.08 ] when the <strong>Units</strong> parameter is pu and [3.15e+05 0.7938 0.084225] when the <strong>Units</strong> parameter is SI.</p></td></tr><tr><td><strong>Winding 3 parameters</strong> — Parameters of winding 3<br>[ 315e3 , 0.002 , 0.08 ] (default) | [3.15e+05 0.7938 0.084225]</td><td><p>Phase-to-phase nominal voltage in volts RMS, resistance, and leakage inductance in pu for winding 3.</p><p>Default is [ 315e3 , 0.002 , 0.08 ] when the <strong>Units</strong> parameter is pu and [3.15e+05 0.7938 0.084225] when the <strong>Units</strong> parameter is SI.</p></td></tr><tr><td><strong>Magnetization resistance Rm</strong> — Magnetization resistance<br>500 (default) | 1.0805e+06</td><td>Magnetization resistance Rm, in pu. Default is 500 when the <strong>Units</strong> parameter is pu and 1.0805e+06 when the <strong>Units</strong> parameter is SI.</td></tr><tr><td><strong>Magnetization inductance Lm</strong> — Magnetization inductance for nonsaturable core<br>500 (default) | 2866</td><td><p>Magnetization inductance Lm, in pu, for a nonsaturable core.</p><p>Default is 500 when the <strong>Units</strong> parameter is pu and 2866 when the <strong>Units</strong> parameter is SI.<br><strong>Dependencies</strong> To enable this parameter, clear the <strong>Saturable core</strong> parameter.</p></td></tr><tr><td><strong>Inductance L0 of zero-sequence flux path return</strong> — Inductance L0 of zero-sequence flux path return for three-limb core transformer type<br>0.5 (default) | 2.866</td><td><p>The Inductance L0 of zero-sequence flux path return, in pu, for the three-limb core transformer type.</p><p>Default is 0.5 when the <strong>Units</strong> parameter is pu and 2.866 when the <strong>Units</strong> parameter is SI.<br><strong>Dependencies</strong> To enable this parameter, set <strong>Type</strong> to Three-limb core (core type).</p></td></tr><tr><td><strong>Saturation characteristic</strong> — Saturation characteristic<br>[ 0,0 ; 0.0024,1.2 ; 1.0,1.52 ] (default) | [0 0;0.66653 1910.3;277.72 2419.7]</td><td><p>Saturation characteristic. Default is [ 0,0 ; 0.0024,1.2 ; 1.0,1.52 ] when the <strong>Units</strong> parameter is pu and [0 0;0.66653 1910.3;277.72 2419.7] when the <strong>Units</strong> parameter is SI. The saturation characteristic for the saturable core. Specify a series of current/ flux pairs (in pu) starting with the pair (0,0).</p><p><strong>Dependencies</strong> To enable this parameter, select the <strong>Simulate saturation</strong> parameter.</p></td></tr><tr><td><strong>Initial fluxes</strong> — Initial fluxes for each phase of transformer<br>[ 0.8 , -0.8 , 0.7 ] (default) | [1273.5 -1273.5 1114.3]</td><td><p>Specify initial fluxes for each phase of the transformer. Default is [ 0.8 , -0.8 , 0.7 ] when the <strong>Units</strong> parameter is pu and [1273.5 -1273.5 1114.3] when the <strong>Units</strong> parameter is SI.</p><p>When the <strong>Specify initial fluxes</strong> parameter is not selected upon simulation, 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 the <strong>Specify initial fluxes</strong> and <strong>Simulate saturation</strong> parameters.</p></td></tr></tbody></table>

### Advanced

<table data-header-hidden><thead><tr><th width="249.5555419921875"></th><th></th></tr></thead><tbody><tr><td><strong>Break Algebraic loop in discrete saturation model</strong> — Option to break Algebraic loop in discrete saturation model<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, this 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 <strong>Discrete solver model</strong> parameter specifies the discretization method of the saturation model.</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 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></td></tr></tbody></table>

## Examples

The power\_transfo3wdn circuit uses two Three-Phase Transformer blocks. Two Multimeter blocks are used to measure the phase A voltage (or AB for delta connections) of each winding


---

# 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-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.
