> 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/hypersim/model-and-simulation/optimize-the-model/use-parameter-generators/transformer-parameters.md).

# Transformer Parameters

## Overview

The HYPERSIM **Transformer Parameters tools** accurately reproduce the behavior of three-phase linear transformers operating at power frequency, including two-winding and three-winding configurations. These tools support the various parameter representations available in the corresponding Z-based transformer components.

### **Three-Limb Core Transformer: Three Windings**

<figure><img src="https://3623212549-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLxgTpoh7kyPmQ5vuyqD7%2Fuploads%2Fgit-blob-9923bf75f8840972e65a75c9c0a6200b8f4517a2%2Fimage%20(1199).png?alt=media" alt=""><figcaption><p>Three-limb core - three windings</p></figcaption></figure>

* **Transformer model support**\
  HYPERSIM uses an **inductance-matrix transformer model**, which is designed to represent **three-limb** and **five-limb core transformers**. Configurations consisting of **three independent single-phase cores are not supported**, as they require Z0=Z1Z\_0 = Z\_1Z0​=Z1​.
* **Single-phase representation**\
  Each single-phase transformer is represented by **three magnetically coupled windings**.
* **Three-limb, three-winding transformer**\
  A three-limb, three-winding transformer with **Z0≠Z1Z\_0 \neq Z\_1Z0​=Z1​** is modeled using **nine coupled windings**. These windings are arranged in the **\[L]** and **\[R]** matrices as described in the next section.
* **Three-limb, two-winding transformer**\
  A three-limb, two-winding transformer is modeled using **six coupled windings**, ordered in the **\[L]** and **\[R]** matrices as described in the next section.

### **Inductance matrix transformer model** <a href="#inductance-matrix-transformer-model" id="inductance-matrix-transformer-model"></a>

The inductance matrix transformer model implements this relationship equation:

$$
\begin{bmatrix} V\_1 \ V\_2 \ \cdots \ V\_9 \ \end{bmatrix} = \begin{bmatrix} R\_1 & 0 & \cdots & 0 \ 0 & R\_2 & \cdots & 0 \ \cdots & \cdots & \cdots & \cdots \ 0 & 0 & \cdots & R\_9 \ \end{bmatrix}. \begin{bmatrix} I\_1 \ I\_2 \ \cdots \ I\_9 \ \end{bmatrix}+\begin{bmatrix} L\_{11} & L\_{12} & \cdots & L\_{19} \ L\_{21} & L\_{22} & \cdots & L\_{29} \ \cdots & \cdots & \cdots & \cdots \ L\_{91} & L\_{92} & \cdots & L\_{99} \ \end{bmatrix}. \frac{d}{dt} \begin{bmatrix} I\_1 \ I\_2 \ \cdots \ I\_9 \ \end{bmatrix}
$$

Where R<sub>1</sub> to R<sub>9</sub> represent the winding resistances. L<sub>ii</sub> represents the self-inductance and the Lij represents the mutual inductance.\
The calculation of the inductance matrix transformer is performed by these equations.

#### **Positive-sequence and mutual reactances** <a href="#positive-sequence-and-mutual-reactances" id="positive-sequence-and-mutual-reactances"></a>

$$
X\_1(i,i)=\frac{Vnom\_{i}^2}{Q\_{1\_t}} \\\[8pt]
X\_1(j,j)=\frac{Vnom\_{j}^2}{Q\_{1\_j}} \\\[8pt]
X\_1(i,j)=X\_1(j,i)=\sqrt{X\_1(i,i).X\_1(j,j)-X\_{1 ij}^2}
$$

The zero-sequence self reactances $$X\_0(i,i)$$ and $$X\_0(j,j)$$ and mutual reactance $$X\_0(i,j)=X\_0(j,i)$$ are also computed using similar equations.

<table data-header-hidden><thead><tr><th width="200"></th><th></th></tr></thead><tbody><tr><td><strong>Q1i</strong></td><td>Three-phase reactive power absorbed by winding i at no load when winding i is excited by a positive-sequence voltage Vnomi with winding j open</td></tr><tr><td><strong>Q1j</strong></td><td>Three-phase reactive power absorbed by winding j at no load when winding j is excited by a positive-sequence voltage Vnomj with winding i open</td></tr><tr><td><strong>X1ij</strong></td><td>Positive-sequence short-circuit reactance seen from winding i when winding j is short-circuited</td></tr><tr><td><strong>Vnomi, Vnomj</strong></td><td>Nominal line-line voltages of windings i and j</td></tr></tbody></table>

If we extend the two 2x2 reactance matrices in positive-sequence and in zero-sequence, to a 6x6 matrix, and replace the four scalar terms by a 3x3, we have this matrix:

$$
\begin{bmatrix} X\_s & X\_m & X\_m \ X\_m & X\_s & X\_m \ X\_m & X\_m & X\_s \ \end{bmatrix}
$$

Where the self and mutual terms are given by:

$$
X\_s=\frac{1}{3}(X\_0+2X\_1) \\\[8pt]
X\_m=\frac{1}{3}(X\_0-X\_1)
$$

To model the core losses (P1 and P0 in positive and zero-sequence), additional shunt resistances are connected between windings.

The resistances equation is:

$$
R1\_i=\frac{Vnom\_i^2}{P\_{1\_i}} ; ; ; ; ; ; R0\_i=\frac{Vnom\_i^2}{P\_{0\_i}}
$$

## Use the Transformer Data

<figure><img src="https://3623212549-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLxgTpoh7kyPmQ5vuyqD7%2Fuploads%2Fgit-blob-240e047ac9b64dd2c6b8b2ecd87a8c31fb096ede%2Fimage%20(1655).png?alt=media" alt=""><figcaption></figcaption></figure>

### Toolbox icons

<figure><img src="https://3623212549-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLxgTpoh7kyPmQ5vuyqD7%2Fuploads%2Fgit-blob-ff78865266675227349d0eff705f1d681d109ab8%2FZ-based-transformer-data-menu.png?alt=media" alt=""><figcaption></figcaption></figure>

<table><thead><tr><th width="200">Button</th><th>Description</th></tr></thead><tbody><tr><td><strong>Compute</strong></td><td>Compute the transformer data, the results are shown in the Log tab.</td></tr><tr><td><strong>Revert</strong></td><td>Revert to default transformer data</td></tr><tr><td><strong>Open</strong></td><td>Load your transformer model *.htd (hypertransfo data file)</td></tr><tr><td><strong>Save</strong></td><td>Saves your transformer data in a new *.htd (hypertransfo data file) file that contains the information of the model</td></tr></tbody></table>

## **REFERENCES**

\[1] HYPERSIM Reference guide manual for software version 9.1.\
\[2] Dommel, H., et al., Electromagnetic Transients Program Reference Manual (EMTP Theory\
Book), 1986.\
\[3] A transformer model for winding fault studies, Partrick Batard, Pierre Bertrand, Michel Meunier,\
IEEE, Vol 9, No 2, April 1994.


---

# 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/hypersim/model-and-simulation/optimize-the-model/use-parameter-generators/transformer-parameters.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.
