> 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/grounding-transformer.md).

# Grounding Transformer

## Description

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

The **Grounding Transformer** block, located in the **OPAL-RT SPS Software/Power Grid Elements** library, Implements three-phase grounding transformer providing a neutral in three-wire system.

Grounding transformers are used in utility distribution networks and in some power electronic converters in order to provide a neutral point in a three-wire system. This transformer is a three-phase two-winding transformer with winding 1 and winding 2 connected in zig zag as shown in the figure below.

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

The figure shows a single-phase load connected between phase C and ground in a three-wire system. The current *I* absorbed by the load returns to the source through the ground and the neutral of the grounding transformer. Because of the zig zag connection and the opposite winding polarities of upper and lower windings, the grounding transformer offers a low impedance in zero-sequence while keeping a very high impedance to positive-sequence. In other words, only a zero-sequence current can flow through the three windings. By definition, a zero-sequence current is a set of three-phase currents having same magnitude and phase. Therefore, the neutral current *I* shares into three equal currents *I/3*. Because the three currents flowing in the grounding transformer are equal, the neutral point stays fixed and the line-to-neutral voltages remain balanced.

The grounding transformer is modeled by three two-winding transformers having a 1:1 voltage ratio. Assume six identical windings with:y three two-winding transformers having a 1:1 voltage ratio. Assume six identical windings with:

*R* = winding resistances

*X* = winding leakage reactances

*Rmag*, *Xmag*= parallel resistance and reactance of the magnetizing branch

The positive-sequence impedance \_Z\_1 and the zero-sequence impedance \_Z\_0 of the grounding transformer are given by:

$$
Z\_1 = R\_1 + j X\_1 = \frac{3, j R\_{\text{mag}} X\_{\text{mag}}}{R\_{\text{mag}} + X\_{\text{mag}}} \\\[8pt]
Z\_0 = R\_0 + j X\_0 = 2 \left( R + j X \right) \\\[8pt]
$$

The zero-sequence reactance *X*<sub>0</sub> is the most important parameter of the grounding transformer. In order to minimize voltage unbalance, reactance *X*<sub>0</sub>should be kept as low as possible.

## Parameters

<table data-header-hidden><thead><tr><th width="249.7777099609375"></th><th></th></tr></thead><tbody><tr><td><strong>Units</strong></td><td><p>Specify the units used to enter the parameters of the Grounding Transformer block.</p><p>Select pu to use per unit. Select SI to use SI units.</p><p>Changing the <strong>Units</strong> parameter from pu to SI, or from SI to pu, will automatically convert 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><p>Default is pu.</p></td></tr><tr><td><strong>Nominal power and frequency</strong></td><td><p>The nominal power rating, in volt-amperes (VA), and nominal frequency, in hertz (Hz), of the transformer.</p><p>Note that the nominal parameters have no impact on the transformer model when the <strong>Units</strong> parameter is set to SI.</p><p>Default is [100e6 60].</p></td></tr><tr><td><strong>Nominal voltage</strong></td><td>The nominal phase-to-phase voltage Vn of the Grounding Transformer, in volts RMS (Vrms). Default is 25e3.</td></tr><tr><td><strong>Zero-sequence resistance and reactance</strong></td><td>The zero-sequence resistance R0 and the zero-sequence reactance X0 in pu or in ohms. Default is [0.025 0.75] when the <strong>Units</strong> parameter is pu and [0.15625 4.6875] when the <strong>Units</strong> parameter is SI.</td></tr><tr><td><strong>Magnetization branch</strong></td><td><p>The shunt resistance Rm modeling the transformer core losses and the magnetizing reactance Xm modeling the magnetization current, in pu or ohms.</p><p>Default is [500 500] when the <strong>Units</strong> parameter is pu and [3125 3125] when the <strong>Units</strong> parameter is SI.</p><p>These values define the active power losses P and the reactive power losses Q required for magnetizing the grounding transformer.</p><p><span class="math">P = \frac{V_n^2}{R_m} \\[8pt] Q = \frac{V_n^2}{X_m} \\[8pt]</span></p><p>As the nominal voltage across each of the six windings is the nominal line-to-line voltage divided by 3 (Vn/3), the three impedances effectively connected across one of the two windings on each leg are Rmag=Rm/3 and Xmag=Xm/3.</p></td></tr><tr><td><strong>Measurements</strong></td><td><p>Select Voltages to measure the line-to-neutral voltages at the terminals of the Grounding Transformer block.</p><p>Select Currents to measure the currents flowing into the three terminals of the Grounding Transformer block.</p><p>Select All voltages and currents to measure voltages and currents.</p><p>Default is None. Place a Multimeter block in your model to display the selected measurements during the simulation.</p><p>In the <strong>Available Measurements</strong> list box of the Multimeter block, the measurements are identified by a label followed by the block name.</p></td></tr></tbody></table>

<table data-header-hidden><thead><tr><th width="251.11102294921875"></th><th></th></tr></thead><tbody><tr><td><strong>Measurement</strong></td><td><strong>Label</strong></td></tr><tr><td>line-to-neutral voltages</td><td>Uan</td></tr><tr><td>currents</td><td>Ian</td></tr></tbody></table>

## Limitations

Saturation of the grounding transformer is not modeled.


---

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