> 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/three-phase-pi-section-line.md).

# Three-Phase PI Section Line

## Description

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

The **Three-Phase PI Section Line** block, located in the **OPAL-RT SPS Software/Power Grid Elements** library, implements a balanced three-phase transmission line model with parameters lumped in a PI section.

Contrary to the Distributed Parameters Line model where the resistance, inductance, and capacitance are uniformly distributed along the line, the Three-Phase PI Section Line block lumps the line parameters in a single PI section 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-5164ca7ae5d7e23aff04f2ea422c0f3ee498492a%2F3P_PIsectionline_equivalent_circuit.png?alt=media" alt=""><figcaption></figcaption></figure>

The line parameters R, L, and C are specified as positive- and zero-sequence parameters that take into account the inductive and capacitive couplings between the three phase conductors, as well as the ground parameters. This method of specifying line parameters assumes that the three phases are balanced.

The self and mutual resistances (*Rs*, *Rm*), self and mutual inductances (*Ls*, *Lm*) of the three coupled inductors, as well as phase capacitances *Cp* and ground capacitances *Cg*, are deduced from the positive- and zero-sequence RLC parameters as follows.

Let us assume the following line parameters:

<table><thead><tr><th width="200.0443115234375"></th><th></th></tr></thead><tbody><tr><td><strong>r1, r0</strong></td><td>Positive- and zero-sequence resistances per unit length (Ω/km)</td></tr><tr><td><strong>l1, l0</strong></td><td>Positive- and zero-sequence inductances per unit length (H/km)</td></tr><tr><td><strong>c1, c0</strong></td><td>Positive- and zero-sequence capacitances per unit length (F/km)</td></tr><tr><td><strong>f</strong></td><td>Frequency (Hz)</td></tr><tr><td><strong>lsec</strong></td><td>Line section length (km)</td></tr></tbody></table>

The total positive- and zero-sequence RLC parameters including hyperbolic corrections are first evaluated:

$$
R\_1 = r\_1 \cdot l\_{sec} \cdot k\_{r1} \\\[8pt]
L\_1 = l\_1 \cdot l\_{sec} \cdot k\_{l1} \\\[8pt]
C\_1 = c\_1 \cdot l\_{sec} \cdot k\_{c1} \\\[8pt]
R\_0 = r\_0 \cdot l\_{sec} \cdot k\_{r0} \\\[8pt]
L\_0 = l\_0 \cdot l\_{sec} \cdot k\_{l0} \\\[8pt]
C\_0 = c\_0 \cdot l\_{sec} \cdot k\_{c0} \\\[8pt]
$$

where

*k*<sub>*r1*</sub>, *k*<sub>*l1*</sub>, *k*<sub>*c1*</sub>, *k*<sub>*r0*</sub>, *k*<sub>*l0*</sub>, *k*<sub>*c0*</sub> — positive-sequence and zero-sequence hyperbolic correction factors

{% hint style="info" %}
See the [PI Section Line](https://www.opal-rt.com/docs/smart-power-simulation-software-sps/blocks-functions-tools/power-transmission-and-distribution/lines/pi-section-line.md) block reference page for an explanation on how to compute RLC parameters taking into account hyperbolic corrections.
{% endhint %}

The Powergui block provides a graphical tool for the calculation of resistance, inductance, and capacitance per unit length based on the line geometry and the conductor characteristics. See the [power\_lineparam](https://www.opal-rt.com/docs/smart-power-simulation-software-sps/blocks-functions-tools/power-transmission-and-distribution/power_lineparam.md) reference page to learn how to use this tool.

For a short line section (approximately *lsec* < 50 km), these correction factors are negligible (close to unity). However, for long lines, these hyperbolic corrections must be taken into account in order to get an exact line model at the specified frequency.

The RLC line section parameters are then computed as follows:

$$
R\_s = \frac{2R\_1 + R\_0}{3} \\\[8pt]
L\_s = \frac{2L\_1 + L\_0}{3} \\\[8pt]
R\_m = \frac{R\_0 - R\_1}{3} \\\[8pt]
L\_m = \frac{L\_0 - L\_1}{3} \\\[8pt]
C\_p = C\_1 \\\[8pt]
C\_g = \frac{3 C\_1 C\_0}{C\_1 - C\_0} \\\[8pt]
$$

## Ports

### Conserving

<table data-header-hidden><thead><tr><th width="194.800048828125"></th><th></th></tr></thead><tbody><tr><td><strong>A</strong> — Phase A terminal<br>Specialized electrical</td><td>Specialized electrical conserving port associated with the terminal of phase A.</td></tr><tr><td><strong>B</strong> — Phase B terminal<br>Specialized electrical</td><td>Specialized electrical conserving port associated with the terminal of phase B.</td></tr><tr><td><strong>C</strong> — Phase C terminal<br>Specialized electrical</td><td>Specialized electrical conserving port associated with the terminal of phase C.</td></tr></tbody></table>

## Parameters

|

**Line length (km)** — Line section length\
100 (default) | positive scalar

\| Line section length in kilometers (km). | | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | |

**Frequency used for rlc specification (Hz)** — Frequency used for specification of per unit length rlc line parameters\
60 (default) | positive scalar

\| Frequency used for specification of per unit length rlc line parameters, in hertz (Hz). This is usually the nominal system frequency (50 Hz or 60 Hz). | |

**Positive- and zero-sequence resistances** (Ohms/km) \[r1 r0] — Positive- and zero-sequence resistances\
\[ 0.01273 0.3864] (default) | vector of two positive elements

\| Positive- and zero-sequence resistances in ohms/kilometer (Ω/km). | |

**Positive- and zero-sequence inductances** (H/km) \[l1 l0] — Positive- and zero-sequence inductances\
\[ 0.9337e-3 4.1264e-3] (default) | vector of two positive elements

\| Positive- and zero-sequence inductances in henries/kilometer (H/km). The zero-sequence inductance cannot be zero, because it would result in an invalid propagation speed computation. | |

**Positive- and zero-sequence capacitances** (F/km) \[c1 c0] — Positive- and zero-sequence capacitances\
\[12.74e-9 7.751e-9] (default) | vector of two positive elements

\| Positive- and zero-sequence capacitances in farads/kilometer (F/km). The zero-sequence capacitance cannot be zero, because it would result in an invalid propagation speed computation. |

## Examples <a href="#examples" id="examples"></a>

The [Single-Phase Energization of a Three-Phase Line ](https://www.opal-rt.com/docs/smart-power-simulation-software-sps/example-models/get-started-with-sps/single-phase-energization-of-a-three-phase-line.md)(power\_triphaseline) example illustrates voltage transients at the receiving end of a 200-km line when only phase A is energized. Voltages obtained with two line models are compared: 1) the Distributed Parameters Line block and 2) a PI line model using two Three-Phase PI Section Line blocks.


---

# 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/three-phase-pi-section-line.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.
