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

# 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-9e79f12f35708dfd074793637f9912921986c0d9%2FPI_ection_line_block.png?alt=media" alt=""><figcaption></figcaption></figure>

The **PI Section Line** block, located in the **OPAL-RT SPS Software/Power Grid Elements** library, implements an *N*-phase transmission line with parameters lumped in PI sections.

For a transmission line, the resistance, inductance, and capacitance are uniformly distributed along the line. An approximate model of the distributed parameter line is obtained by cascading several identical PI sections. The following figure shows one PI section of a three-phase transmission line.

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

When the number of phases is greater than 1, the series resistance and inductance are implemented by a mutual inductance device defined by the R and L matrices.

When the number of phases is 1, the series resistance and inductance are modeled by a single resistance R and inductance L. The phase-to-phase capacitors, Cp, are not modeled.

The shunt capacitance Cg of each phase and the phase-to-phase capacitance Cp are defined as:

Cg = sum(C(:, p)) / 2; (1)\
Cp = - C(p, k) (2)

where C is the capacitance matrix and p and k are the number of the phases to which Cp is connected.

Unlike the Distributed Parameters Line block, which has an infinite number of states, the PI section linear model has a finite number of states that permit you to compute a linear state-space model. The number of sections to be used depends on the frequency range to be represented.

An approximation of the maximum frequency range represented by the PI line model is given by:

$$
f\_{max}=\frac{N\_{bpi}\cdot v}{8 \cdot ltot}
$$

where

| Symbol                  | Meaning                                                                   |
| ----------------------- | ------------------------------------------------------------------------- |
| **N**<sub>**bpi**</sub> | Number of PI sections                                                     |
| **v**                   | Propagation speed (km/s) = $$\frac{1}{\sqrt{lc}}$$ ; l in H/km, c in F/km |
| **ltot**                | Line length (km)                                                          |

For example, for a 100 km aerial line having a propagation speed of 300,000 km/s, the maximum frequency range represented with a single PI section is approximately 375 Hz. For studying interactions between a power system and a control system, this simple model could be sufficient. However, for switching surge studies involving high-frequency transients in the kHz range, much shorter PI sections should be used. In fact, you can obtain the most accurate results by using a distributed parameters line model.

{% hint style="info" %}
The [powergui](broken://pages/554aec932df28b25a24f86c767c56e24112d3417) Preview block provides the **Power Line Parameters** App, which calculates resistance, inductance, and capacitance per unit of length based on the line geometry and the conductor characteristics.
{% endhint %}

### Hyperbolic Correction of RLC Elements

For short line sections (approximately lsec < 50 km), the RLC elements for each line section are simply given by:

R = r · lsec\
L = l · lsec\
C = c · lsec

where:

| ***r***    | Resistance per unit length (Ω/km)       |
| ---------- | --------------------------------------- |
| ***l***    | Inductance per unit length (H/km)       |
| ***c***    | Capacitance per unit length (F/km)      |
| ***f***    | Frequency (Hz)                          |
| ***lsec*** | Line section length = *ltot* / *N* (km) |

However, for long line sections, the RLC elements given by the above equations must be corrected in order to get an exact line model at a specified frequency. The RLC elements are then computed using hyperbolic functions as explained below.

$$
\omega=2\pi f
$$

Per unit length series impedance at frequency f is:

$$
z=r+j\omega l
$$

Per unit length shunt admittance at frequency f is:

$$
y=j\omega c
$$

Characteristic impedance:

$$
Z\_c=\sqrt{z/y}
$$

Propagation constant:

$$
\gamma = \sqrt{z \cdot y} \\\[8pt]
Z = R + j\omega L = Z\_c \cdot \sinh(\gamma \cdot l\_{sec}) \\\[8pt]
R = \mathrm{real}(Z) \\\[8pt]
L = \mathrm{imag}(Z) / \omega \\\[8pt]
Y = \frac{2}{Z\_c} \cdot \tanh!\left( \gamma \cdot \frac{l\_{sec}}{2} \right) \\\[8pt]
C = \mathrm{imag}(Y) / \omega \\\[8pt]
$$

Hyperbolic corrections result in RLC values slightly different from the non-corrected values. R and L are decreased while C is increased. These corrections become more important as line section length increases. For example, let us consider a 735 kV line with the following positive-sequence and zero-sequence parameters (these are the default parameters of the [Three-Phase PI Section Line](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) block and [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) block):

| **Positive sequence** | <p><em>r</em>= 0.01273 Ω/km<br><em>l</em>= 0.9337×10−3H/km<br><em>c</em>= 12.74×10−9F/km</p> |
| --------------------- | -------------------------------------------------------------------------------------------- |
| **Zero sequence**     | <p><em>r</em>= 0.3864 Ω/km<br><em>l</em>= 4.1264×10−3H/km<br><em>c</em>= 7.751×10−9F/km</p>  |

For a 350 km line section, noncorrected RLC positive-sequence values are:

$$
R = 0.01273 \times 350 = 4.455,\Omega \\\[8pt]
L = 0.9337 \times 10^{-3} \times 350 = 0.3268,\text{H} \\\[8pt]
C = 12.74 \times 10^{-9} \times 350 = 4.459 \times 10^{-6},\text{F} \\\[8pt]
$$

Hyperbolic correction at 60 Hz yields:

$$
R = 4.153,\Omega \\\[8pt]
L = 0.3156,\text{H} \\\[8pt]
C = 4.538 \times 10^{-6},\text{F} \\\[8pt]
$$

For these particular parameters and long line section (350 km), corrections for positive-sequence RLC elements are relatively important (respectively −6.8%, −3.4%, and + 1.8%). For zero-sequence parameters, you can verify that even higher RLC corrections must be applied (respectively −18%, −8.5%, and +4.9%).

The PI Section Line block always uses the hyperbolic correction, regardless of the line section length.

## Parameters

<table data-header-hidden><thead><tr><th width="250.2222900390625"></th><th></th></tr></thead><tbody><tr><td><strong>Number of phases [N]</strong> — Number of phases<br>1 (default) | scalar greater than or equal to 1</td><td>Number of phases of the PI-section line. The number of ports of this block is equal to the value of this parameter.</td></tr><tr><td><strong>Number of pi sections</strong> — Number of PI sections<br>1 (default) | scalar greater than or equal to 1</td><td>Number of PI sections.</td></tr><tr><td><strong>Line length (km)</strong> — Line section length<br>100 (default) | positive scalar</td><td>Line length in kilometers (km).</td></tr><tr><td><strong>Frequency used for rlc specification (Hz)</strong> — Frequency used for specification of per unit length rlc line parameters<br>60 (default) | positive scalar</td><td>Frequency <em>f</em>, in hertz (Hz), at which per unit length <em>r</em>, <em>l</em>, <em>c</em> parameters are specified. Hyperbolic correction is applied on RLC elements of each line section using this frequency.</td></tr><tr><td><strong>Resistance per unit length (Ohms/km) [ NxN matrix ]</strong> — Resistance per unit length<br>0.01273 (default) | matrix of N-by-N elements</td><td>Resistance per unit length, as an <em>N</em>-by-<em>N</em> matrix in ohms/km (Ω/km).</td></tr><tr><td><strong>Inductance per unit length (H/km) [ NxN matrix ]</strong> — Inductance per unit length<br>0.9337e-3 (default) | matrix of N-by-N elements</td><td>Inductance per unit length of the line, as an <em>N</em>-by-<em>N</em> matrix in henries/km (H/km). The terms in the matrix diagonal cannot be zero, because it would result in an invalid propagation speed computation.</td></tr><tr><td><strong>Capacitance per unit length (F/km) [ NxN matrix ]</strong> — Capacitance per unit length<br>12.74e-9 (default) | matrix of N-by-N elements</td><td>Capacitance per unit length of the line, as an <em>N</em>-by-<em>N</em> matrix in farads/km (F/km). The terms in the matrix diagonal cannot be zero, because it would result in an invalid propagation speed computation.</td></tr><tr><td><strong>Specify conductance</strong> — Option to specify conductance<br>off (default) | on</td><td>Option to specify the shunt conductance per unit length.</td></tr><tr><td><strong>Conductance per unit length (mho/km) [ NxN matrix ]</strong> — Shunt conductance per unit length<br>0 (default) | matrix of N-by-N elements</td><td><p>Shunt conductance per unit length as an N-by-N matrix in mho/km.</p><p>Shunt conductance is normally not considered for transmission line since leakage currents flowing across insulators and air are significantly smaller than nominal current. However, if you are using the Pi Section Line block to model a cable arrangement, the shunt conductance can be non negligible.</p><p><strong>Dependencies</strong></p><p>To enable this parameter, select the <strong>Specify conductance</strong> parameter.</p></td></tr><tr><td><strong>Measurements</strong> — Block measurements<br>None (default) | Input and output voltages | Input and output currents | All pi-section voltages and currents | All voltages and currents</td><td><p>When the <strong>Number of phases [N]</strong> parameter is greater than 1, the only measurement available in the drop-down menu is Phase-to-ground voltages.</p><p>When the <strong>Number of phases [N]</strong> is 1, you can select these options:</p><p>Select Input and output voltages to measure the sending end (input port) and receiving end (output port) voltages of the line model.</p><p>Select Input and output currents to measure the sending end and receiving end currents of the line model.</p><p>Select All pi-section voltages and currents to measure voltages and currents at the start and end of each pi-section.</p><p>Select All voltages and currents to measure the sending end and receiving end voltages and currents of the line model.</p><p>Default is None.</p><p>Place a Multimeter block in your model to display the selected measurements during the simulation. In the <strong>Available Measurements</strong> list box of the Multimeter block, the measurement is identified by a label followed by the block name.</p></td></tr></tbody></table>

Measurement labels (for Multimeter Available Measurements list):

| Measurement                                    | Label                                                      |
| ---------------------------------------------- | ---------------------------------------------------------- |
| **Sending end voltage (block input)**          | Us:                                                        |
| **Receiving end voltage (block output)**       | Ur:                                                        |
| **Sending end current (input current)**        | Is:                                                        |
| **Receiving end current (output current)**     | Ir:                                                        |
| **Phase-to-ground (block inputs and outputs)** | <p>Us phase 1, 2, 3, ... N;<br>Ur phase 1, 2, 3, ... N</p> |

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

The **power\_piline** example shows the line energization voltages and currents of a single-phase PI section line.


---

# 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/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.
