> 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/artemis-3-phase-coupled-stubline-and-compensation-block.md).

# ARTEMiS 3-phase Coupled Stubline and Compensation Blocks

## Description

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

The **ARTEMiS 3-phase Coupled Stubline and Compensation Blocks**, located in the **ARTEMiS/Tools/Decoupling Blocks** library, provide computational decoupling of grid equations composed of short transmission lines for real-time simulations. Used together, they form the **ARTEMiS Compensated Stubline (ACS)**.

The **ARTEMiS 3-phase Coupled Stubline** implements a 3-phase stubline with interphase coupling. It is based on the Bergeron line model with losses, where the equivalent capacitance is adjusted to obtain exactly one time-step of traveling delay. The model produces a coupled stubline in three ways: three independent uncoupled modes (equivalent to three single‑phase stublines), single‑mode propagation (all three modes have the same propagation time), and two‑mode propagation (one mode has exactly two time‑step delay). The single‑mode and two‑mode options model distributed parameter lines with interphase coupling, which better approximate the Bergeron line model and real lines.

The **Compensation Block** compensates the extra equivalent capacitance added by the ARTEMiS 3-phase Coupled Stubline and includes the remaining line impedances not used to construct the propagation modes. In typical use, the stubline replaces a much shorter line (lower capacitance and shorter propagation time), effectively adding reactive power to the circuit; the Compensation Block cancels this extra reactive power at power frequency. The Compensation Block can also add damping to improve stability during transients, especially when the selected lines are very short.

{% 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-eaf53a58cae8cfe9a66ee8800736a52ebc664f5e%2FArtemis_3Pcoupled_stubline_mask.png?alt=media" alt="" width="563"><figcaption></figcaption></figure>

{% tabs %}
{% tab title="3-phase Coupled Stubline" %}

<table><thead><tr><th width="241.79998779296875">Parameter</th><th>Description</th></tr></thead><tbody><tr><td><strong>Stubline type</strong></td><td><p>The type of stubline used:</p><ul><li>3-phase coupled line (1 mode): LC coupling produces a one‑step delay on all modes.</li><li>3-phase coupled line (2 modes): LC coupling produces a one‑step delay on two modes and a two‑step delay on the third mode.</li><li>3-phase line without couplings: no LC coupling across phases (equivalent to three single‑phase stublines).</li></ul></td></tr><tr><td><strong>Nominal Frequency (Hz)</strong></td><td>Frequency used for internal compensation calculations.</td></tr><tr><td><strong>Resistance (Ohms/km)</strong></td><td>3×3 resistance matrix of the line in Ohms/km.</td></tr><tr><td><strong>Inductance (H/km)</strong></td><td>3×3 inductance matrix of the line in H/km.</td></tr><tr><td><strong>Capacitance (F/km)</strong></td><td>3×3 capacitance matrix of the line in F/km.</td></tr><tr><td><strong>Length (km)</strong></td><td>Line length in km.</td></tr><tr><td><strong>Sample Time (s)</strong></td><td>Model sample time in seconds.</td></tr><tr><td><strong>Damping Required</strong></td><td>Select to enable damping in the corresponding Compensation Block.</td></tr><tr><td><strong>Undamped Frequency (Hz)</strong></td><td>Maximum frequency for the computed damping (estimate by observing transient oscillations without damping).</td></tr><tr><td><strong>Peak Frequency (Hz)</strong></td><td>Damping resonance frequency (must be greater than power frequency).</td></tr><tr><td><strong>Corresponding stub compensation block name</strong></td><td>Name of the corresponding Compensation Block, including the block path (if inside a subsystem) but not the model name.</td></tr><tr><td><strong>Update stub compensation block (button)</strong></td><td>Transfers compensation parameters from the ARTEMiS 3‑phase Coupled Stubline to the Compensation Block.</td></tr><tr><td><strong>Reactive compensation R, L, C values</strong></td><td>Visible parameters used to compute the reactive compensation; normally filled automatically from the ARTEMiS 3‑phase Coupled Stubline.</td></tr></tbody></table>

{% hint style="info" %}
The ACS damping option reduces spurious oscillations during transients. For details, refer to the ARTEMiS application note “Using ARTEMiS Compensated Stubline Damping Option.”
{% endhint %}
{% endtab %}

{% tab title="Compensation " %}
This block is normally filled automatically from the *Artemis 3-phase Coupled Stubline*. The visible parameters consist of RLC values used to compute the reactive compensation.
{% endtab %}
{% endtabs %}

## Conserving ports

<table><thead><tr><th width="260.39996337890625">Port</th><th>Description</th></tr></thead><tbody><tr><td>Phase ‘abc’ terminals (side A)</td><td>Three-phase connection point at one end of the block.</td></tr><tr><td>Phase ‘abc’ terminals (side B)</td><td>Three-phase connection point at the other end of the block.</td></tr></tbody></table>

## Inputs

This block has no inputs.

## Outputs

This block 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/artemis-3-phase-coupled-stubline-and-compensation-block.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.
