> 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-lines-and-cables/constant-param-3-ph-with-fault.md).

# Constant Param, 3-ph with Fault

## Description

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

The **Constant Parameter (CP) 3-ph Line with fault** block, located in the **Network Lines and Cables** library, assumes that line parameters R, L, and C are independent of frequency effects due to skin effect on phase conductors and ground. The model treats L and C as distributed (ideal line) and R as lumped at three locations (R/4 at each end and R/2 in the middle). Shunt conductance G is set to zero. While frequency-dependent (FD) parameters improve waveform and peak value accuracy, the CP model is robust, simple, fast, and suitable for first-approximation analysis.

A transposed or untransposed CP line is represented either by its sequences or by propagation modes with a transformation matrix (Ti) between mode currents and phase currents. Implementation details are available in \[1].

This model can simulate an internal fault. The number of operations allowed is four per fault element, instead of ten in normal cases.

### Types of fault <a href="#types-of-fault" id="types-of-fault"></a>

The fault element uses breakers A, B, C, and Ground. A value of 1 closes the breaker; 0 opens it. Fault types are determined by the combination of these breaker states.

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

<details>

<summary><strong>Types of fault according to the state of breakers</strong></summary>

| **State of Breaker**                    | **A** | **B** | **C** | **Ground** |
| --------------------------------------- | ----- | ----- | ----- | ---------- |
| No fault                                | 0     | 0     | 0     | 0          |
| Fault between phase C and Ground        | 0     | 0     | 1     | 1          |
| Fault between phase B and Ground        | 0     | 1     | 0     | 1          |
| Fault between phases B and C            | 0     | 1     | 1     | 0          |
| Fault between phases B, C and Ground    | 0     | 1     | 1     | 1          |
| Fault between phases A and Ground       | 1     | 0     | 0     | 1          |
| Fault between phases A and C            | 1     | 0     | 1     | 0          |
| Fault between phases A, C and Ground    | 1     | 0     | 1     | 1          |
| Fault between phases A and B            | 1     | 1     | 0     | 0          |
| Fault between phases A, B and Ground    | 1     | 1     | 0     | 1          |
| Fault between phases A, B and C         | 1     | 1     | 1     | 0          |
| Fault between phases A, B, C and Ground | 1     | 1     | 1     | 1          |

</details>

To simulate faults on a 3‑phase line, either use:

* 1 line section - no fault, or
* 2 line sections - fault on the line.

Specify the fault distance from side “1”. The fault distance must be less than the line length. Set the fault distance to 0 to disable the fault element.

{% hint style="info" %}
For a phase‑to‑ground fault, it is strongly recommended to use the ground in steady state instead of programming an operation time in transient state.
{% endhint %}

The propagation delay is calculated as follows:

$$
Propagation\_delay=length\_of\_line \times \sqrt{L\[i] \times C\[i]}
$$

where i denotes each phase, and L and C are the per-unit-length inductance and capacitance.

{% hint style="danger" %}
When the propagation delay is smaller than the time step, the Constant Param block is automatically replaced by an equivalent PI line.
{% endhint %}

* If the Transposed parameter is set to yes, the following warning appears in the console:

{% code overflow="wrap" %}

```
WARNING in line: : The propagation delay ( X ) is less than the sample time ( Y ). A PI line is automatically used.
```

{% endcode %}

* If the Transposed parameter is set to no, a similar error message appears.

## Mask parameters

<figure><img src="https://3623212549-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLxgTpoh7kyPmQ5vuyqD7%2Fuploads%2Fgit-blob-6cc98130d98e3f661c12c5152c9551af6a09837f%2F3ph_cp.jpg?alt=media" alt=""><figcaption></figcaption></figure>

{% tabs %}
{% tab title="General" %}

| **Parameter**                                        | **Description**                                                                                                                                                                                |
| ---------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Description**                                      | Use this field to add information about the component.                                                                                                                                         |
| **EMTP (.pun) file for line parameters calculation** | Location (path) of the EMTP (.pun) file containing the line parameters.                                                                                                                        |
| **L-C units in EMTP (.pun) file**                    | <p>Units read from the pun file. Options:</p><ul><li>mH/km, uF/km (0): Inductance (L), capacitance (C). Ohm/km,</li><li>uS/km (1): Inductive (Xl) and capacitive susceptance (1/Xc).</li></ul> |
| **Line length**                                      | Length of the line (km), length \[0, 1e64].                                                                                                                                                    |
| **Distance of fault from (+) side**                  | Fault distance measured from the left (+) side (km), fault\_loc \[0, 1e64].                                                                                                                    |
| **Base power (perPhase)**                            | Base value for per-unit conversion (MVA per phase), pBase = \[1, 1e64].                                                                                                                        |
| **Base voltage (rmsLN)**                             | Base value for per-unit conversion (kV rms LN), vBase \[1, 1e64] .                                                                                                                             |
| **Base frequency**                                   | Base value for per-unit conversion (Hz), fBase \[1, 1e64].                                                                                                                                     |
| **Fault resistance**                                 | Fault resistance per phase (Ω), RDef \[0, 1e64].                                                                                                                                               |
| **Ropen**                                            | Open resistance per phase (Ω) ROpen \[0, 1e64].                                                                                                                                                |
| **Rclose**                                           | Closed resistance per phase (Ω),RClose \[0, 1e64].                                                                                                                                             |
| **Chopping current**                                 | Current threshold for the opening permission operation (A). Variable: Imargin = {0, 1e64}.                                                                                                     |
| {% endtab %}                                         |                                                                                                                                                                                                |

{% tab title="Line data" %}

| **Parameter**                    | **Description**                                                                                                                                           |
| -------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Continuously transposed line** | <p>Transposition setting transp. Options:<br>No (0): Untransposed line.<br>Yes (1): Transposed line.</p>                                                  |
| **R**                            | Per-unit-length resistance for each phase (mode) (Ω/km), R \[-1e64, 1e64].                                                                                |
| **L**                            | Per-unit-length inductance for each phase (mode) (H/km), L \[-1e64, 1e64].                                                                                |
| **C**                            | Per-unit-length capacitance for each phase (mode) (F/km), C \[-1e64, 1e64].                                                                               |
| **Transformation matrix**        | <p>Transformation matrix between mode current and phase current Ti \[-1e64, 1e64].<br>\[Iphase] = \[Ti] x \[Imode]<br>not used for a transposed line.</p> |
| {% endtab %}                     |                                                                                                                                                           |

{% tab title="Timing" %}

| **Parameter**                          | **Description**                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| -------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Time units**                         | <p>Units applied to programmed state transitions Ut. Options: Second (s): All Tn in seconds.<br>Millisecond (ms): All Tn in milliseconds.<br>Cycle (c): All Tn in electrical cycles (set the frequency).</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| **Time programming**                   | <p>Master switch for executing programmed operations upon acquisition trigger EnaGen<br>Disable (0): Programmed operations are disabled.</p><p>Enable (1): Programmed operations are enabled.</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| **Steady-state condition**             | <p>State of phase breakers in steady state iniStateA, iniStateB, iniStateC, iniStateG<br>“colored” if breaker is open (0)<br>“grey” if closed (1).</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| **Frequency**                          | Set using “Base frequency” (Hz) Freq \[45, 70].                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| **Switching times (Line1)**            | <p>Enable/disable the state transition operation on the same line EnaT1,EnaT2 ...<br>Disable (0): Disables the operation.<br>Enable (1): Enables the operation;<br>if enabled with no values, the operation is ignored</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| **Switching times (Type f, i, u, ug)** | <p>Relative time (with respect to <a href="https://www.opal-rt.com/docs/hypersim/library-blocks-reference/network-tools/point-on-wave-synchronization.md">POW synchronization</a>) when the command is sent to change state. Enter timing type and values as a single string T1, T2, .. Types:</p><ul><li><strong>Fixed</strong> (f: fixed time): At each acquisition, Tn is sent at the same time for all phases selected in “Phase operated”.</li><li><strong>Incremental</strong> (i: initial time/final time/time increment): First acquisition uses the initial time; each subsequent acquisition adds the increment until the final time is reached, then resets to the initial time.</li><li><strong>Uniform</strong> (u: minimal time/maximal time): At each acquisition, Tn is random with uniform probability in the range. Selected phases do not receive the command simultaneously.</li><li><strong>Uniform gaussian</strong> (ug: minimal time/maximal time/dispersion): At each acquisition, Tn is random with gaussian probability in the range. Selected phases do not receive the command simultaneously.</li></ul><p>Important notes:</p><ul><li>Programmed operation times must satisfy Tn > Tn-1.</li><li>If a parameter field is blank or contains “-”, no switching occurs for that line.</li><li>If using referenced operations, the calculated time is applied after the component receives the reference command.</li></ul> |
| **Referenced operations**              | <p>Trigger Tn based on another breaker’s programmed transition. All fields are required for this feature.</p><ul><li>Ref operation (Eref1 , Eref2, ..): Name or path of the breaker being referenced.</li><li>Ref time (Tref1, Tref2, ..): Time Tn ID of the referenced breaker step.</li><li>Phase/Command (T1RPh, T2RPh, ..): Activate (Phase (1)) or deactivate (Command (0)) the reference dependency.</li></ul>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| **Phase operated**                     | <p>Phases that change state when the timing condition is reached. T1Pa, T1Pb, T1Pc T2Pa, T2Pb, T2Pc ...<br>Example: if after Tn-1 phases A and C are OFF and Tn triggers B and C, then after Tn phases A and B are OFF and C is ON.<br>ON (1): “Colored” when a transition occurs.<br>OFF (0): “Grayed out” when no transition occurs.</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| {% endtab %}                           |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |

{% tab title="Line generator" %}
The electrical parameters of CP lines can be calculated using the Line Generator.

For more information see [Line Generator](https://www.opal-rt.com/docs/hypersim/model-and-simulation/optimize-the-model/use-parameter-generators/line-parameters.md).
{% endtab %}
{% endtabs %}

## Conserving ports

| **Port**          | **Description**                                            |
| ----------------- | ---------------------------------------------------------- |
| **net\_1(a,b,c)** | Network connection of phases (a,b,c) of the left (+) side. |
| **net\_2(a,b,c)** | Network connection of phases (a,b,c) of the right side.    |

## Inputs

This block has no inputs.

## Outputs

This block has no outputs.

## Signals available for monitoring and external I/O connections (via sensors form)

All block inputs and outputs are available as signals for monitoring and for external I/O connections.

Additional signals are also available and are listed below with their descriptions.

| **Signal**                        | **Description**                                 |
| --------------------------------- | ----------------------------------------------- |
| **V(a*****,b,c*****)\_Node(1,2)** | Voltage (V) of each phase on bus (1,2)          |
| **I(a*****,b,c*****)\_Node(1,2)** | Currents (A) of each phase on bus (1,2)         |
| **V(a*****,b,c*****)\_FLT**       | Voltage (V) on fault bus phases (a,b,c)         |
| **I(a*****,b,c,n*****)\_FLT**     | Fault current (A) (a,b,c,n)                     |
| **CMD(a*****,b,c,n*****)\_FLT**   | Command for states of phase and ground breakers |

{% hint style="info" %}
(1,2) indicates the bus name at each end of the line (1 for the left (+) side and 2 for the right side).\
The **Fault bus** refers to the fault point defined by “Distance of fault from (+) side”.
{% endhint %}

## References

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-lines-and-cables/constant-param-3-ph-with-fault.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.
