> 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/hypersim/library-blocks-reference/network-tools/half-cp-3-ph.md).

# Half CP, 3-ph

## Description

<figure><img src="https://3623212549-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLxgTpoh7kyPmQ5vuyqD7%2Fuploads%2Fgit-blob-437b604c34eb7e45a9c12cb3f0c950a23a239b57%2Fimage%20(451).png?alt=media" alt="" width="233"><figcaption></figcaption></figure>

The **Half CP, 3‑ph** block, located in the **Network Tools** library, uses the distributed parameter line (DPL) theory to model one half of the classic constant‑parameter (CP) transmission line \[1]. The CP model assumes frequency‑independent R, L, and C; L and C are distributed, R is lumped at R/4 at both ends and R/2 in the middle, and shunt conductance G is zero.

Two Half CP components must be connected through transceiver elements (or real‑time simulator I/Os) to form a complete line, and both must use identical line parameters. With Half CP components, the line’s total propagation delay equals the internal buffer delay plus any external “extra delay.” On a single simulator, the external delay comes from the transceiver; with two simulators, it also includes the I/O drive delay.

The single‑phase version half CP, 1-ph is extended to three phases using a modal transformation to decouple the phase domain. Decoupled modal circuits are solved independently and transformed back to the phase domain. For a continuously transposed line, only sequences 0 and 1 are considered and a built‑in Clarke matrix is used; for an untransposed line (three distinct modes), a user input matrix is used.

### Three-phase model <a href="#halfcp-1-ph-single-phasemodel" id="halfcp-1-ph-single-phasemodel"></a>

The [**single-phase model**](https://www.opal-rt.com/docs/hypersim/library-blocks-reference/network-tools/half-cp-1-ph.md) is extended to the three-phase line by using a modal transformation to decouple the equations from phase domain to modal domain. The hatted vector are modal quantities:

$$
\mathbf{V} =
\begin{bmatrix}
V\_a \ V\_b \ V\_c
\end{bmatrix}
\= T\_v \hat{\mathbf{V}} = T\_v
\begin{bmatrix}
V\_0 \ V\_1 \ V\_2
\end{bmatrix} \ \space \\
\mathbf{I} =
\begin{bmatrix}
I\_a \ I\_b \ I\_c
\end{bmatrix}
\= T\_i \hat{\mathbf{I}} = T\_i
\begin{bmatrix}
I\_0 \ I\_1 \ I\_2
\end{bmatrix} \ \space \\
\hat{\mathbf{Z}} = T\_i^{-1} \mathbf{Z} T\_i \\
\hat{\mathbf{Y}} = T\_v^{-1} \mathbf{Y} T\_v
$$

$$Z \text{ and } Y$$ are the series impedance and shunt admittance of the line, respectively. The transformation matrices are given from the following eigenvalue problem:

$$
\Lambda = T\_v^{-1} \mathbf{Z} \mathbf{Y} T\_v
$$

For an untransposed line, the number of distinct modes equals the number of phases. In the half-CP model, a constant real transformation matrix is used, computed at a specified model frequency. This matrix can be obtained using the LineData model. For a continuously transposed line, only sequence 0 and sequence 1 are considered, and a built-in Clarke transformation matrix is used.

$$
\mathbf{T}\_i =
\begin{bmatrix}
\frac{1}{\sqrt{3}} & \frac{1}{\sqrt{2}} & \frac{1}{\sqrt{6}} \\
\frac{1}{\sqrt{3}} & -\frac{1}{\sqrt{2}} & \frac{1}{\sqrt{6}} \\
\frac{1}{\sqrt{3}} & 0 & -\frac{2}{\sqrt{6}}
\end{bmatrix}
$$

To find a solution in the three-phase system, the decoupled circuits are solved separately and transformed back to the phase domain.

<figure><img src="https://3623212549-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLxgTpoh7kyPmQ5vuyqD7%2Fuploads%2Fgit-blob-c7906a97ed957eea86882f5ef98d524c4829e675%2Fimage%20(453).png?alt=media" alt=""><figcaption></figcaption></figure>

### Example

{% hint style="info" %}
Two half CP components must be connected through transceiver elements to represent a transmission line. **Line parameters must be the same in both components.**
{% endhint %}

<figure><img src="https://3623212549-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLxgTpoh7kyPmQ5vuyqD7%2Fuploads%2Fgit-blob-c0b43828883046dab61ce443a20dcd2ca0e85a2e%2Fimage%20(454).png?alt=media" alt=""><figcaption><p>Transmission line using 1 transceiver.</p></figcaption></figure>

<figure><img src="https://3623212549-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLxgTpoh7kyPmQ5vuyqD7%2Fuploads%2Fgit-blob-08295ef4340cdf569dd1a32931d4b5a687788088%2Fimage%20(455).png?alt=media" alt=""><figcaption><p>Transmission line using 3 transceivers.</p></figcaption></figure>

## Mask parameters

<figure><img src="https://3623212549-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLxgTpoh7kyPmQ5vuyqD7%2Fuploads%2Fgit-blob-06e838e6bba861af5f746552801e3fe6f53fec97%2Fimage%20(452).png?alt=media" alt="" width="563"><figcaption></figcaption></figure>

<table><thead><tr><th width="244.4000244140625">Parameter</th><th>Description</th></tr></thead><tbody><tr><td><strong>Length</strong></td><td>Line length in km. Allowed range: 1e‑12 to 1e12.</td></tr><tr><td><strong>Continuously transposed</strong></td><td>Transposition selection. transp = {0, 1}. No {0}: Untransposed line. Yes {1}: Transposed line.</td></tr><tr><td><strong>R</strong></td><td>Per‑unit‑length resistance for each phase (mode) in Ω/km. Allowed range: 0 to 1e12.</td></tr><tr><td><strong>L</strong></td><td>Per‑unit‑length inductance for each phase (mode) in H/km. Allowed range: 1e‑12 to 1e12.</td></tr><tr><td><strong>C</strong></td><td>Per‑unit‑length capacitance for each phase (mode) in F/km. Allowed range: 1e‑12 to 1e12.</td></tr><tr><td><strong>Transformation matrix (Ti)</strong></td><td>Transformation matrix between mode and phase currents ([Iphase] = [Ti] × [Imode]); not used when the line is transposed. For a continuously transposed line, only sequences 0 and 1 are considered and a built‑in Clarke matrix is used. Allowed values: elements in [‑1e64, 1e64].</td></tr><tr><td><strong>Extra delay</strong></td><td>Integer number of external delays (outside the Half CP components). On one simulator, caused by the transceiver; on two simulators, includes I/O drive delay. extradelaynb = [0, 200].</td></tr></tbody></table>

## Inputs

<table><thead><tr><th width="250.79998779296875">Input</th><th>Description</th></tr></thead><tbody><tr><td><strong>hi_(a,b,c)</strong></td><td>Historic current of phases (a, b, c) FROM the other side of the line.</td></tr></tbody></table>

## Outputs

<table><thead><tr><th width="250">Output</th><th>Description</th></tr></thead><tbody><tr><td><strong>ho_(a,b,c)</strong></td><td>Historic current of phases (a, b, c) TO the other side of the line.</td></tr><tr><td><strong>Vt_(a,b,c)</strong></td><td>Terminal voltage of phases (a, b, c) in V.</td></tr><tr><td><strong>ols_(a,b,c)</strong></td><td>Terminal current of phases (a, b, c) in A.</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/hypersim/library-blocks-reference/network-tools/half-cp-3-ph.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.
