> 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/library-blocks-reference/control-protection-relays/87t-transformer-differential.md).

# 87T - Transformer Differential

## Description

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

The **87T - Transformer Differential** block, located in the **Control Protection Relays** library, implements a transformer differential protection with unrestrained (87U) and restrained (87R) elements, including harmonic restraint and harmonic blocking. The relay trips when the difference between two or three input currents exceeds a predefined value. It is sensitive to faults within the differential zone and should be set to remain insensitive to external faults.

<figure><img src="https://3623212549-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLxgTpoh7kyPmQ5vuyqD7%2Fuploads%2Fgit-blob-1ac04a1f4eb1bff3c9b2a2fe176e1e9c853e99fa%2Fimage%20(534).png?alt=media" alt="" width="563"><figcaption><p>Protection logic of 87T relay</p></figcaption></figure>

The differential current is computed as the phasor sum of the CT input currents. Current magnitudes are first referred to the primary side using the transformer winding voltage levels. Magnitudes and angles are then adjusted from Y to delta sides according to the transformer winding connections so the currents used by the differential element are in phase. All CT current polarities must be consistent: either all “looking towards the transformer” or all “looking away from the transformer.” All CTs are considered Y-connected. Based on the rated current specified in the control panel (the CT secondary current at winding 1 under normal operation), per-unit values of the currents are calculated, and this same base is used for differential current settings.

* 87U compares the differential current directly to the 87U pickup setting. It operates when any phase differential current exceeds the pickup value.
* 87R applies a two-slope restraint characteristic to the operating current. The horizontal axis is the restraint current (pu), and the vertical axis is the differential current (pu). Two restraint options are available:

$$
\text{Sum:  } I\_{\text{res}} = \sum \left( | I\_i | \right) \\
\text{Max:  } I\_{\text{res}} = max \left( | I\_i | \right)
$$

where $$I\_i$$ are the per-unit input current phasors from each CT. 87R operates only if the differential current exceeds the pickup and lies in the operating region defined by the two slopes.

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

Harmonic restraint is available with 2nd and 4th harmonics to improve security. When enabled, the restraint current is:

$$
I\_{h\text{-res}} = \sum | I\_i | + \frac{I\_{H2}}{L\_2} + \frac{I\_{H4}}{L\_4}
$$

where $$I\_{H2}$$ and $$I\_{H4}$$ are the magnitudes of the second- and fourth-order harmonics in the differential current, and $$L\_2$$ and $$L\_4$$ are the corresponding harmonic blocking levels in percent relative to the fundamental.

Harmonic blocking supports the 2nd, 4th, and 5th harmonics individually, or combinations 2nd+4th or 2nd+5th. If the maximum level of any selected harmonics is reached, 87R is blocked while this condition persists. Internally, each selected harmonic magnitude is compared to the fundamental magnitude times its maximum level (percent). For example, $$I\_{H2}$$ is compared to $$I\_{Fund} \times L\_2$$ . If the harmonic magnitude is larger, differential protection is blocked; otherwise, blocking is not active.

## Mask parameters

<figure><img src="https://3623212549-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLxgTpoh7kyPmQ5vuyqD7%2Fuploads%2Fgit-blob-c87fe172022fdcf4674f32a5f5d91463ca62fded%2F87T.jpg?alt=media" alt=""><figcaption></figcaption></figure>

{% tabs %}
{% tab title="General parameters" %}

<table><thead><tr><th width="241">Parameter</th><th>Description</th></tr></thead><tbody><tr><td><strong>Frequency</strong></td><td>Nominal frequency (Hz) of the measured current signals. Supported: 50 or 60 Hz.</td></tr><tr><td><strong>Primary/Secondary connection</strong></td><td>Transformer connection between winding 1 and winding 2. Default: YY0.</td></tr><tr><td><strong>Primary/Tertiary connection</strong></td><td>Transformer connection between winding 1 and winding 3. Default: N/A.</td></tr><tr><td><strong>Winding 1 voltage (L-L)</strong></td><td>Line-to-line voltage of winding 1 (V). Default: 315000.</td></tr><tr><td><strong>Winding 1 CT ratio</strong></td><td>CT ratio at winding 1. Default: 240.</td></tr><tr><td><strong>Winding 2 voltage (L-L)</strong></td><td>Line-to-line voltage of winding 2 (V). Default: 120000.</td></tr><tr><td><strong>Winding 2 CT ratio</strong></td><td>CT ratio at winding 2. Default: 600.</td></tr><tr><td><strong>Winding 3 voltage (L-L)</strong></td><td>Line-to-line voltage of winding 3 (V). Default: 50000.</td></tr><tr><td><strong>Winding 3 CT ratio</strong></td><td>CT ratio at winding 3. Default: 20.</td></tr><tr><td><strong>Rated current</strong></td><td>Base RMS current (A) for the input signals and differential settings. Use the CT secondary current at winding 1 under normal operation. Default: 5.</td></tr><tr><td><strong>87U pickup</strong></td><td>Pickup current for 87U (pu). Default: 8.</td></tr><tr><td><strong>Restraint type</strong></td><td>Select how the restraint current is calculated (Sum or Max). Default: Sum.</td></tr><tr><td><strong>87R pickup</strong></td><td>Pickup current for 87R (pu). Default: 0.12.</td></tr><tr><td><strong>I breakpoint</strong></td><td>Breakpoint current between slope 1 and slope 2 (pu). Default: 2.</td></tr><tr><td><strong>Slope 1</strong></td><td>First slope of the two-slope characteristic. Default: 0.75.</td></tr><tr><td><strong>Slope 2</strong></td><td>Second slope of the two-slope characteristic. Default: 0.5.</td></tr><tr><td><strong>Trip delay</strong></td><td>Delay before tripping once conditions are met (87U and 87R) (s). Default: 0.04.</td></tr><tr><td><strong>Reset delay</strong></td><td>Delay before the relay resets (87U and 87R) (s). Default: 0.04.</td></tr></tbody></table>
{% endtab %}

{% tab title="Harmonic blocking and restraint" %}

<table><thead><tr><th width="265.79998779296875">Parameter</th><th>Description</th></tr></thead><tbody><tr><td><strong>87U Harmonic blocking enable</strong></td><td>Enable harmonic blocking for 87U. Default: disabled.</td></tr><tr><td><strong>87R Harmonic blocking enable</strong></td><td>Enable harmonic blocking for 87R. Default: disabled.</td></tr><tr><td><strong>2nd Harmonic enable</strong></td><td>Enable 2nd-order harmonic blocking. Default: disabled.</td></tr><tr><td><strong>2nd Harmonic max level</strong></td><td>Maximum 2nd-harmonic level as a percentage of the fundamental (%). Default: 10.</td></tr><tr><td><strong>4th Harmonic enable</strong></td><td>Enable 4th-order harmonic blocking. Default: disabled.</td></tr><tr><td><strong>4th Harmonic max level</strong></td><td>Maximum 4th-harmonic level as a percentage of the fundamental (%). Default: 10.</td></tr><tr><td><strong>5th Harmonic enable</strong></td><td>Enable 5th-order harmonic blocking. Default: disabled.</td></tr><tr><td><strong>5th Harmonic max level</strong></td><td>Maximum 5th-harmonic level as a percentage of the fundamental (%). Default: 10.</td></tr><tr><td><strong>2nd+4th Harmonic enable</strong></td><td>Enable combined 2nd+4th harmonic blocking. Default: disabled.</td></tr><tr><td><strong>2nd+4th Harmonic max level</strong></td><td>Maximum combined 2nd+4th harmonic level as a percentage of the fundamental (%). Default: 10.</td></tr><tr><td><strong>2nd+5th Harmonic enable</strong></td><td>Enable combined 2nd+5th harmonic blocking. Default: disabled.</td></tr><tr><td><strong>2nd+5th Harmonic max level</strong></td><td>Maximum combined 2nd+5th harmonic level as a percentage of the fundamental (%). Default: 10.</td></tr><tr><td><strong>Harmonic restraint enable</strong></td><td>Enable harmonic restraint. Default: disabled.</td></tr></tbody></table>
{% endtab %}
{% endtabs %}

## Inputs

<table><thead><tr><th width="198">Input</th><th>Description</th></tr></thead><tbody><tr><td><strong>Iabc1</strong></td><td>Three-phase currents of CT1.</td></tr><tr><td><strong>Iabc2</strong></td><td>Three-phase currents of CT2.</td></tr><tr><td><strong>Iabc3</strong></td><td>Three-phase currents of CT3.</td></tr><tr><td><strong>Reset</strong></td><td>Relay reset signal. The relay resets when this signal becomes 1.</td></tr></tbody></table>

## Outputs

<table><thead><tr><th width="202">Output</th><th>Description</th></tr></thead><tbody><tr><td><strong>87U</strong></td><td>Unrestrained differential relay output.<br>0 by default; becomes 1 when a differential condition is detected.</td></tr><tr><td><strong>87R</strong></td><td>Restrained differential relay output.<br>0 by default; becomes 1 when a differential condition is detected.</td></tr></tbody></table>


---

# 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/library-blocks-reference/control-protection-relays/87t-transformer-differential.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.
