> 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-1-ph.md).

# Half CP, 1-ph

## Description

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

The **Half CP** block, located in the **Network Tools** library, represents one end (half) of a classic constant-parameter (CP) single-phase transmission line. It uses the distributed parameters line (DPL) theory to model L and C as distributed and R as lumped at three locations (R/4 at each end and R/2 in the middle), with shunt conductance G assumed to be zero \[1].

Two Half CP components must be connected through transceiver elements (or real-time simulator I/Os) to form a complete transmission line. Both halves must use identical line parameters. With the Half CP component, the line propagation delay equals the sum of the internal buffer delay and the actual external delay (“extra delay”) introduced by the transceiver and, when using two simulators, by I/O drivers.

For the three‑phase version, see Half CP, 3-ph.

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

The half CP parameters are calculated at a given frequency; thus, it is considered as a frequency independent line model. This model is less accurate than frequency-dependent line and cable models. However, it can be successfully used to analyze cases with limited frequency dispersion.

The half CP model is based on the formulation of the classic CP line model, which neglects the frequency dependence of parameters and first assumes a lossless line. The losses are included at a later stage.

<figure><img src="https://3623212549-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLxgTpoh7kyPmQ5vuyqD7%2Fuploads%2Fgit-blob-f7ddf948c759340b951a82460a6968b6db974cae%2Fimage%20(463).png?alt=media" alt="" width="427"><figcaption><p>Equivalent circuit representation of the EMT-type transmission line model.</p></figcaption></figure>

The lossless single-phase transmission line is described by the following main equations:<br>

$$
i\_k(t) = \frac{v\_k(t)}{Z\_c} - I\_{H,k}  \\
i\_m(t) = \frac{v\_m(t)}{Z\_c} - I\_{H,m}
$$

where $$I\_{H,k}$$ and $$I\_{H,m}$$ are history currents defined as:

$$
I\_{H,k} = \frac{v\_m(t-\tau)}{Z\_c} - i\_m(t -\tau) \\
I\_{H,m}= \frac{v\_k(t - \tau)}{Z\_c} +  i\_k(t -\tau)
$$

$$v\_k$$ and $$v\_m$$are the nodal voltages; $$i\_k$$ and $$i\_m$$ are the injected current at both ends of the line; $$Z\_c$$is the characteristic impedance and $$\tau$$ is the propagation time delay, respectively defined as:

$$
Z\_c = \sqrt{\frac{L'}{C'}} \\
\tau = l \sqrt{L' C'}
$$

where $$l$$is the length of the line, and $$L'$$ and $$C'$$ are the inductance and capacitance per unit length of the line, respectively.

Note that the time-domain model described above creates a decoupling effect on the interconnected network. It is mentioned that the equation system provides an exact solution only when the propagation time is an integer multiple $$K$$ of the simulation time step $$\Delta t, \space \tau=K\Delta t$$Therefore, a linear interpolation is used when $$\tau \neq K\Delta t$$.

### Inclusion of losses <a href="#halfcp-1-ph-inclusionoflosses" id="halfcp-1-ph-inclusionoflosses"></a>

To include the losses $$R'$$, the line is divided into two identical lossless models, each with half the propagation time. Then, the total $$R=lR"$$is lumped at three places (line ends $$R/4$$ and line middle $$R/2$$ ).

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

The resulted lossy line equivalent model to be implemented is given by:

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

$$
Z\_{\text{imp}} = Z\_c + \frac{R}{4} \\
I\_k(t-\tau) = \left( \frac{1+H}{2} \right) \left\[ \frac{v\_m(t-\tau)}{Z\_{\text{imp}}} + H i\_m(t-\tau) \right] + \left( \frac{1-H}{2} \right) \left\[ \frac{v\_k(t-\tau)}{Z\_{\text{imp}}} + H i\_k(t-\tau) \right] \\
I\_m(t-\tau) = \left( \frac{1+H}{2} \right) \left\[ \frac{v\_k(t-\tau)}{Z\_{\text{imp}}} + H i\_k(t-\tau) \right] + \left( \frac{1-H}{2} \right) \left\[ \frac{v\_m(t-\tau)}{Z\_{\text{imp}}} + H i\_m(t-\tau) \right] \\
H = \frac{\left( Z\_c - R/4 \right)}{\left( Z\_c + R/4 \right)}
$$

The half CP line is used to represent one Norton equivalent circuit of the lossy equivalent line. Therefore, two half CP model must be linked to each other to represent a transmission line. Both half CP components must be set with the same line parameters and connected through transceiver components. This connection is used to interchange the history current $$h\_x$$ information between both ends of the line.

$$
h\_x = \left( \frac{1+H}{2} \right) \left\[ \frac{v\_x(t-\tau)}{Z\_{\text{imp}}} + H i\_x(t-\tau) \right]
$$

The output history current $$h\_0$$ at end *k* becomes the input history current $$h\_i$$ at end *m*, and vice versa. In the model implementation, a history buffer is maintained and rotated to compute the history current sources. The buffer length depends on the propagation delay and the simulation time step. The propagation delay must be greater than the integration time step.

Note that the propagation delay of the line is the sum of what is accounted in the buffer and what is caused by the actual delay outside the components. The latter is referred as "extra delay", which must be indicated in the form of the model. For the digital simulation of the model on one simulator, the actual delay is caused by the transceiver. For the simulation on 2 simulators, the actual delay includes the delay in I/O drive.

### 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-f8a2af1e60fd1ad30212123daa9347a7cf185ae8%2Fimage%20(466).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-77d2d22da766c2fbbf31e5aeec0a26bf1ce7bf23%2Fimage%20(467).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-04efc1c456dc953728fa28299d27119c8505ae21%2Fimage%20(1079).png?alt=media" alt="" width="563"><figcaption></figcaption></figure>

<table><thead><tr><th width="199.60003662109375">Parameter</th><th>Description</th></tr></thead><tbody><tr><td><strong>Description</strong></td><td>Free text to document the component.</td></tr><tr><td><strong>Length</strong></td><td>Length of the line (m). length = {'1e-12, 1e12'}.</td></tr><tr><td><strong>R'</strong></td><td>Per‑unit‑length resistance (Ω/km). Resistance = {'0, 1e12'}.</td></tr><tr><td><strong>L'</strong></td><td>Per‑unit‑length inductance (H/km). Inductance = {'1e-12 1e12'}.</td></tr><tr><td><strong>C'</strong></td><td>Per‑unit‑length capacitance (F/km). Capacitance = {'1e-12, 1e12'}.</td></tr><tr><td><strong>Extra delay</strong></td><td>Integer number of delays produced outside the Half CP components (i.e., by the transceiver on one simulator, and by the transceiver plus I/O drivers on two simulators), extradelaynb = { [0, 200] }.</td></tr></tbody></table>

## Inputs

<table><thead><tr><th width="199.5999755859375">Input</th><th>Description</th></tr></thead><tbody><tr><td><strong>net</strong></td><td>Power network connection of one side of the line.</td></tr><tr><td><strong>hi</strong></td><td>History current from the other side of the line.</td></tr></tbody></table>

## Outputs

<table><thead><tr><th width="201.20001220703125">Output</th><th>Description</th></tr></thead><tbody><tr><td><strong>ho</strong></td><td>History current to the other side of the line.</td></tr><tr><td><strong>Vt</strong></td><td>Terminal voltage (V).</td></tr></tbody></table>

## Reference

\[1]: H. W. Dommel, "Digital computer solution of electromagnetic transients in single and multiphase networks," IEEE Trans. Power App. Syst., vol. pas-88, pp. 388-99, 04/1969.


---

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