> 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/rt-lab/simulink-blocks-reference/artemis-library/87t-transformer-differential-relay.md).

# 87T Transformer Differential Relay

## Description

<figure><img src="https://96827845-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNRdpSk8kjn20gXAexnt6%2Fuploads%2Fgit-blob-d2094a46174b36f02eecba3ff0fbb6c39b9f5f7f%2FArtemis_87T_transfo_diff_relay_block.png?alt=media" alt="" width="155"><figcaption></figcaption></figure>

The **Transformer Differential Relay (87T)** block, located in the **ARTEMiS/Tools/Protection Relays** library, implements a transformer differential protection function with harmonic restraint and harmonic blocking. It operates when the difference between two or three input current phasors exceeds a predefined value. The model supports up to three CT inputs (for up to three transformer windings) and a two-slope restraint characteristic. Operation is supported for 50 Hz and 60 Hz systems.

<figure><img src="https://96827845-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNRdpSk8kjn20gXAexnt6%2Fuploads%2Fgit-blob-95d33eefe00bd69be1ec91ab1dafce25cd3f7a9f%2FArtemis_87T_transfo_diff_relay_schem.png?alt=media" alt="" width="563"><figcaption><p>Protection logic of 87T relay</p></figcaption></figure>

{% hint style="danger" %}
Ensure all CT current polarities are consistent across inputs: either all look toward the transformer or all look away from the transformer. All CTs are considered Y-connected.
{% endhint %}

The model provides two differential elements: an unrestraint element (87U) and a restraint element (87R). It computes the differential current as the phasor sum of the CT input currents. It first scales the current magnitudes to the primary side using the transformer winding L-L voltages, then aligns current magnitudes and angles according to the transformer winding connections (Y/Δ compensation) so that the currents feeding the differential element are in phase. Per-unit values are calculated from the rated current specified on the relay control panel. The rated current corresponds to the CT secondary current at winding 1 under normal operating conditions and is used as the base for differential current settings.

{% hint style="info" %}
The model compensates current magnitudes and angles according to the specified transformer winding connections to align phase relationships for differential comparison.
{% endhint %}

The 87U element operates when any phase differential current exceeds the 87U pickup setting. The 87R element applies a two-slope characteristic using a restraint current computed from the per-unit magnitudes of the CT inputs. Two restraint methods are available: sum of magnitudes or maximum magnitude. The 87R element operates only when the differential current exceeds the 87R pickup and lies within the operating region defined by the two slopes.

Harmonic restraint improves security by adding second- and fourth-order harmonic terms to the restraint current.

Harmonic blocking can be enabled for the 2<sup>nd</sup>, 4<sup>th</sup>, and 5<sup>th</sup> harmonics individually or for the combinations 2<sup>nd</sup>+4<sup>th</sup> or 2<sup>nd</sup>+5<sup>th</sup>. When the selected harmonic content reaches its configured maximum level (percentage of the fundamental), the 87R operation remains blocked while the condition persists.

{% hint style="danger" %}
This block requires a valid RT-LAB license on the simulator with the feature ARTEMiS enabled. Refer to[ ARTEMiS Requirements](https://www.opal-rt.com/docs/rt-lab/model-and-simulation/power-systems-with-artemis/artemis-requirements.md) for details.
{% endhint %}

## Mask parameters

<figure><img src="https://96827845-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNRdpSk8kjn20gXAexnt6%2Fuploads%2Fgit-blob-abd3a73ac672cca62c3108795b78e33e570f6eaf%2FArtemis_87T_transfo_diff_relay_mask.png?alt=media" alt="" width="563"><figcaption></figcaption></figure>

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

<table data-search="false"><thead><tr><th width="241">Parameter</th><th>Description</th></tr></thead><tbody><tr><td><strong>Enable</strong></td><td>Enable or disable relay operation.</td></tr><tr><td><strong>Frequency</strong></td><td>System frequency of the measured currents (Hz). Supports 50 Hz and 60 Hz.</td></tr><tr><td><strong>Primary/Secondary connection</strong></td><td>Transformer connection between winding 1 and winding 2.</td></tr><tr><td><strong>Primary/Tertiary connection</strong></td><td>Transformer connection between winding 1 and winding 3.</td></tr><tr><td><strong>Winding 1 voltage (L-L)</strong></td><td>L-L voltage of winding 1 (V).</td></tr><tr><td><strong>Winding 1 CT ratio</strong></td><td>CT ratio at winding 1.</td></tr><tr><td><strong>Winding 2 voltage (L-L)</strong></td><td>L-L voltage of winding 2 (V).</td></tr><tr><td><strong>Winding 2 CT ratio</strong></td><td>CT ratio at winding 2.</td></tr><tr><td><strong>Winding 3 voltage (L-L)</strong></td><td>L-L voltage of winding 3 (V).</td></tr><tr><td><strong>Winding 3 CT ratio</strong></td><td>CT ratio at winding 3.</td></tr><tr><td><strong>Rated current</strong></td><td>Base current (RMS) used for input scaling and differential current settings (A). Use the CT secondary current at winding 1 under normal operating conditions.</td></tr><tr><td><strong>87U pickup</strong></td><td>Pickup current for the 87U element (pu).</td></tr><tr><td><strong>Restraint type</strong></td><td><p>Select how the restraint current is calculated:<br>Sum <span class="math">I_{res} = \sum_{i=inputs} (|I_i|)</span></p><p><br>Max <span class="math">I_{res} = max(|I_i|)_{i=inputs}</span></p></td></tr><tr><td><strong>87R pickup</strong></td><td>Pickup current for the 87R element (pu).</td></tr><tr><td><strong>Breakpoint</strong></td><td>Threshold current (pu) between slope 1 and slope 2.</td></tr><tr><td><strong>Slope 1</strong></td><td>Value of the first slope in the two-slope characteristic.</td></tr><tr><td><strong>Slope 2</strong></td><td>Value of the second slope in the two-slope characteristic.</td></tr><tr><td><strong>Trip Delay</strong></td><td>Delay before tripping once conditions are met (s), applied to both 87U and 87R.</td></tr><tr><td><strong>Reset Delay</strong></td><td>Delay before the relay resets (s), applied to both 87U and 87R.</td></tr></tbody></table>
{% endtab %}

{% tab title="Harmonic Blocking and Restraint " %}

<table><thead><tr><th width="249.79998779296875">Parameter</th><th>Description</th></tr></thead><tbody><tr><td><strong>87U Harmonic blocking</strong></td><td>Enable harmonic blocking for the 87U element.</td></tr><tr><td><strong>87R Harmonic blocking</strong></td><td>Enable harmonic blocking for the 87R element.</td></tr><tr><td><strong>2</strong><sup><strong>nd</strong></sup><strong> Harmonic</strong></td><td>Enable 2<sup>nd</sup>-order harmonic blocking.<br>Configure the maximum level (%) relative to the fundamental.</td></tr><tr><td><strong>4</strong><sup><strong>th</strong></sup><strong> Harmonic</strong></td><td>Enable 4<sup>th</sup>-order harmonic blocking.<br>Configure the maximum level (%) relative to the fundamental.</td></tr><tr><td><strong>5</strong><sup><strong>th</strong></sup><strong> Harmonic</strong></td><td>Enable 5<sup>th</sup>-order harmonic blocking.<br>Configure the maximum level (%) relative to the fundamental.</td></tr><tr><td><strong>2</strong><sup><strong>nd</strong></sup><strong>+4</strong><sup><strong>th</strong></sup><strong> Harmonic</strong></td><td>Enable combined 2<sup>nd</sup>+4<sup>th</sup> harmonic blocking.<br>Configure the maximum level (%) relative to the fundamental.</td></tr><tr><td><strong>2</strong><sup><strong>nd</strong></sup><strong>+5</strong><sup><strong>th</strong></sup><strong> Harmonic</strong></td><td>Enable combined 2<sup>nd</sup>+5<sup>th</sup> harmonic blocking.<br>Configure the maximum level (%) relative to the fundamental.</td></tr><tr><td><strong>Harmonic Restraint: 2</strong><sup><strong>nd</strong></sup><strong>+4</strong><sup><strong>th</strong></sup><strong> Harmonic</strong></td><td><p>Enable harmonic restraint using 2<sup>nd</sup> and 4<sup>th</sup> harmonics. if checked.<br><br>Enable harmonic restraint using 2nd and 4th harmonics. When enabled, the restraint current is:<br><span class="math">I_{h-res} = \sum |I_{i} | + \frac{I_{H2} } {L_{2} } + \frac{I_{H4} } {L_{4} }</span></p><p>where <span class="math">I_{H2} </span>and <span class="math">I_{H4} </span>are the magnitudes of the 2nd- and 4th-order harmonics in the differential current, and<img src="https://96827845-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNRdpSk8kjn20gXAexnt6%2Fuploads%2Fgit-blob-dd6bf79b7f94b476ccb376be75ca424f6c53168f%2Funknown.svg%2Bxml?alt=media" alt="">and<img src="https://96827845-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNRdpSk8kjn20gXAexnt6%2Fuploads%2Fgit-blob-c077f8512d1223d5c7dd0539e0cb7eae67f096be%2Funknown.svg%2Bxml?alt=media" alt="">are the corresponding blocking levels in percent relative to the fundamental.</p></td></tr></tbody></table>
{% endtab %}
{% endtabs %}

## Conservating ports

<table><thead><tr><th width="127.60003662109375">Port</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 command. Set to 1 to reset the relay.</td></tr><tr><td><strong>87U</strong></td><td>Unrestraint differential element output. 0 by default; becomes 1 when a differential condition is detected.</td></tr><tr><td><strong>87R</strong></td><td>Restraint differential element output. 0 by default; becomes 1 when a differential condition is detected.</td></tr></tbody></table>

## Inputs

This bloc as no inputs.

## Outputs

This bloc has no outputs.


---

# 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/rt-lab/simulink-blocks-reference/artemis-library/87t-transformer-differential-relay.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.
