> 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/lines/decoupling-line-three-phase.md).

# Decoupling Line (Three-Phase)

## Description

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

The **Decoupling Line (Three-Phase)** block, located in the **OPAL-RT SPS Software/Power Grid Elements** library, implements a three-phase distributed parameters line model that transmits the electrical signal entering its conserving ports to an associated Decoupling Line (Three-Phase) block in your model. The two Decoupling Line (Three-Phase) blocks form a pair that represents the send and receive ends of a three-phase transmission line.

The behavior of the pair of blocks is equivalent to using one Distributed Parameters Line block:

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

Refer to [Distributed Parameters Line](https://www.opal-rt.com/docs/smart-power-simulation-software-sps/blocks-functions-tools/power-transmission-and-distribution/lines/distributed-parameters-line.md) for a detailed description of the equations used to represent wave propagation phenomena and line-end reflections.

Use the Decoupling Line (Three-Phase) block pairs when you want to model a transmission line with no physical electrical connections between the send and receive ends of the line. This technique is used, for example, in applications where a large network is decoupled into smaller sections that are simulated into different subsystems or models with no electrical connections between them. This decoupling technique is often used to model complex electrical networks on multi-core real-time computers, or to allow faster simulation of large networks.

The blocks in the a pair can be associated by using the **Pairing ID** parameter, which transmits the electrical signal information travelling from one terminal to the other by using internal Simulink® Goto and From blocks or connecting the blocks with Simulink signals.

The parameters of each Decoupling Line (Three-Phase) block in the a pair must be identical and correspond to the parameters you would enter in an equivalent Distributed Parameters Line block. For example, to model a 100 km transmission line with the given R, L, and C values, use two Decoupling Line (Three-Phase) blocks with a length of 100 km each and the same R, L, and C values.

To model a transmission line in your model, add two Decoupling Line (Three-Phase) blocks to your model and set the block parameters to the same values. Alternatively, use the Specify Decoupling Lines App to find, select, and automatically replace existing Distributed Parameters Line blocks in your model with equivalent pairs of Decoupling Line (Three-Phase) blocks. For more information, see [Specify Decoupling Lines](https://www.opal-rt.com/docs/smart-power-simulation-software-sps/blocks-functions-tools/power-transmission-and-distribution/specify-decoupling-lines.md).

### Limitations

The Decoupling Line (Three-Phase) block can be used only in a discrete model, that is, when the **Simulation type** parameter of the powergui block is set to Discrete.

## Ports

### Input

| Port                                                     | Description                                                                                                                                                                                                                                                     |
| -------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **r** — Receiving voltage signal (Simulink input signal) | <p>Connect this input to the <strong>s</strong> output port of the other Decoupling Line (Three-Phase) block forming the pair.</p><p><strong>Dependencies:</strong> To enable this port, select the <strong>Show send and receive ports</strong> parameter.</p> |

### Output

| Port                                                    | Description                                                                                                                                                                                                                                                     |
| ------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **s** — Sending voltage signal (Simulink output signal) | <p>Connect this output to the <strong>r</strong> input port of the other Decoupling Line (Three-Phase) block forming the pair.</p><p><strong>Dependencies:</strong> To enable this port, select the <strong>Show send and receive ports</strong> parameter.</p> |

### Conserving

| Port                                                    | Description                                                                                                                                                                                      |
| ------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **Cons 1** — Electric terminal of line (SPS electrical) | SPS electrical conserving port associated with the send terminal or the receive terminal of a transmission line when the block is used in pair with another Decoupling Line (Three-Phase) block. |
| **Cons 2** — Electric terminal of line (SPS electrical) | SPS electrical conserving port associated with the send terminal or the receive terminal of a transmission line when the block is used in pair with another Decoupling Line (Three-Phase) block. |
| **Cons 3** — Electric terminal of line (SPS electrical) | SPS electrical conserving port associated with the send terminal or the receive terminal of a transmission line when the block is used in pair with another Decoupling Line (Three-Phase) block. |

## Parameters

<table><thead><tr><th width="249.6888427734375">Parameter</th><th>Description</th></tr></thead><tbody><tr><td><strong>Line length (km)</strong> — Transmission line length<br>100 (default) | positive scalar</td><td><p>Transmission line length, in km. Because the block is used with another Decoupling Line (Three-Phase) block, enter the same line length in each of the two blocks; do not split the value between each of the two blocks.</p><p>For example, to model a 100 km line, specify 100 in each block, not 50 in one block and 50 in the other block.</p></td></tr><tr><td><strong>Frequency used for rlc specification (Hz)</strong> — Line frequency<br>60 (default) | positive scalar</td><td>Specify the frequency used to compute the per-unit length of the resistance R, inductance I, and capacitance C matrices of the line model.</td></tr><tr><td><strong>Resistance per unit length (ohms/km) [ 3x3 matrix ] or [ r1 r0 ]</strong> — Line resistance<br>[0.01273 0.3864] (default) | two-element vector | three-element vector | 3-by-3 matrix</td><td>Resistance R per unit length, specified as a two-element vector or a 3-by-3 matrix, in ohms/km (Ω/km).<br>- For a symmetrical line, specify either the 3-by-3 matrix or the sequence parameters.<br>- For a three-phase continuously transposed line, enter the positive and zero-sequence resistances [r1 r0].<br>- For asymmetrical lines, specify the complete 3-by-3 resistance matrix.</td></tr><tr><td><strong>Inductance per unit length (H/km) [ 3x3 matrix ] or [ l1 l0 ]</strong> — Line inductance<br>[0.9337e-3 4.1264e-3] (default) | two-element vector | three-element vector | 3-by-3 matrix</td><td>Inductance I per unit length, specified as a two-element vector or a 3-by-3 matrix, in henries/km (H/km).<br>- For a symmetrical line, specify either the 3-by-3 matrix or the sequence parameters.<br>- For a three-phase continuously transposed line, enter the positive and zero-sequence inductances [l1 l0].<br>- For asymmetrical lines, specify the complete 3-by-3 inductance matrix.</td></tr><tr><td><strong>Capacitance per unit length (F/km) [ 3x3 matrix ] or [ c1 c0 ]</strong> — Line capacitance<br>[12.74e-9 7.751e-9] (default) | two-element vector | three-element vector | 3-by-3 matrix</td><td>Capacitance C per unit length, specified as a two-element vector or a 3-by-3 matrix, in farads/km (F/km).<br>- For a symmetrical line, specify either the 3-by-3 matrix or the sequence parameters.<br>- For a three-phase continuously transposed line, enter the positive and zero-sequence capacitances [c1 c0].<br>- For asymmetrical lines, specify the complete 3-by-3 capacitance matrix.</td></tr><tr><td><strong>Show send and receive ports</strong> — Ports enabling<br>off (default) | on</td><td><p>Select to show the <strong>r</strong> and <strong>s</strong> input and output ports. When selected, the Decoupling Line (Three-Phase) blocks can be paired by connecting them with Simulink signals.</p><p>You connect the s output of the first block to the r input of the second block, and connect the <strong>s</strong> port of the second block to the <strong>r</strong> port of the first block.<br><img src="https://799605156-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FdlNg8IbOdahCpFCyzxSN%2Fuploads%2Fgit-blob-08d6a57b2047830554f99c0ba61746166d8027f7%2Fimage.png?alt=media" alt=""><br>The internal model of the Decoupling Line (Three-Phase) block is directly connected to the external <strong>r</strong> and <strong>s</strong> block ports.<br><img src="https://799605156-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FdlNg8IbOdahCpFCyzxSN%2Fuploads%2Fgit-blob-3300e00fc213a1abcc9646348ae1449436273695%2Fdecoupling_line_3P_internal_model.png?alt=media" alt=""><br>To break the algebraic loop created by this type of connection, you can add a Unit Delay block at the output of each Decoupling Line (Three-Phase) block.</p><p>When <strong>Show send and receive ports</strong> is cleared, the Decoupling Line (Three-Phase) blocks are associated by using the <strong>Pairing ID</strong> parameter, which transmits the electrical signal information travelling from one terminal to the other by the use of internal Simulink Goto and From blocks.</p><p>A Unit Delay block is also added to the output signal path to break the algebraic loops.</p><p>The sample time parameter of this delay corresponds to the sample time delay specified in the powergui block.<br><img src="https://799605156-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FdlNg8IbOdahCpFCyzxSN%2Fuploads%2Fgit-blob-ed613393b7ef781bcae0e36ae8d748e8e5cc0a2f%2Fdecoupling_line_3P_pairingID.png?alt=media" alt=""></p></td></tr><tr><td><strong>Pairing ID</strong> — Pairing identifier<br>L001 (default)</td><td><p>When the <strong>Show send and receive ports</strong> parameter is cleared, internal Goto and From blocks are used to pair two Decoupling Line (Three-Phase) blocks in your model.</p><p>In both blocks, the first part of the pairing identifier is the same, but you must append _S to the end of the identifier of one block, and _R to the end of the identifier of the other block. An error is produced if the identifier does not end in _S or _R.</p><p>For example, suppose you add two Decoupling Line (Three-Phase) blocks to your model.</p><p>To pair the blocks, you must set the <strong>Pairing ID</strong> parameter of one block to L001_S and the other block to L001_R.</p></td></tr><tr><td><strong>Initial voltage (V)</strong> — Initial voltage<br>[ 1 1 1] (default) | three-element vector</td><td>Initial value of the terminal voltage, in volts.</td></tr><tr><td><strong>Initial voltage angle (Deg)</strong> — Initial angle<br>[0 -120 120] (default) | three-element vector</td><td>Angle of the initial voltage, in degrees.</td></tr><tr><td><strong>Initial current (A)</strong> — Initial current<br>[ 1 1 1] (default) | three-element vector</td><td>Initial value of the current flowing out of the block, in amperes.</td></tr><tr><td><strong>Initial current angle (Deg)</strong> — Initial angle<br>[0 -120 120] (default) | three-element vector</td><td>Angle of the initial current, in degrees.</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/smart-power-simulation-software-sps/blocks-functions-tools/power-transmission-and-distribution/lines/decoupling-line-three-phase.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.
