> 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/simulation-and-analysis/cable-parameter-calculator.md).

# Cable Parameter Calculator

## Description

The **Cable Parameter Calculator app** computes RLC matrices and frequency-dependent parameters of cable arrangement, the RLGC matrices and the WB frequency-dependent cable parameters of a group of aerial cables, underground cables, or cables in a metal pipe. The cables are single-core and can made up of any number of concentric conductors and insulators.

The parameters computed by the app can be used in the PI Section Line block, Distributed Parameter Line block, and Distributed Parameter Line Frequency Dependent Line block to model a single-phase or multi-phase cable arrangement.

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

## Open the Cable Parameters Tool App

* powergui Block Parameters dialog box: On the **Tools** tab, click **Cable Parameter Calculator**.
* MATLAB<sup>®</sup> command prompt:

{% code lineNumbers="true" %}

```matlab
powerCableParameters.
```

{% endcode %}

## Parameters

### **Menu**

<table data-header-hidden><thead><tr><th width="250.11114501953125"></th><th></th></tr></thead><tbody><tr><td><strong>Parameters|Load typical</strong> — Load typical parameters</td><td><p>Load typical cable parameters provided with SPS Software. This command opens a browser window where you can select typical underground, aerial, or pipe cable configurations.</p><p>By default, the app is configured with the parameters of the Param_4cablesUnderground2cond.mat file.</p></td></tr><tr><td><strong>Parameters|Load user defined</strong> — Load user parameters</td><td><p>Opens a browser window where you can select your own cable data.</p><p>Select the desired MAT file.</p></td></tr><tr><td><strong>Parameters|Save</strong> — Save cable parameters</td><td>Saves your cable data by generating a MAT file that contains the app information and cable data.</td></tr><tr><td><strong>Configuration|Underground cables</strong> — Underground cables configuration</td><td><p>The <strong>Cable Configuration</strong> table assumes that the cables are buried below the ground level. Any previously edited parameters in the table are lost. The position of the cables is specified by <strong>V (m)</strong> and <strong>H (m)</strong> parameters. Aerial cables cannot be defined in this configuration.</p><p>The title of the table is Cable Configuration: Underground. Default configuration of the app.<strong>Note</strong>If you set this configuration, you must possess a license for Optimization Toolbox™ to simulate your model.</p></td></tr><tr><td><strong>Configuration|Aerial cables</strong> — Aerial cables configuration</td><td><p>The <strong>Cable Configuration</strong> table assumes that the cables are aerial.</p><p>Any previously edited parameters in the table are lost. The position of the cables is specified by <strong>V (m)</strong> and <strong>H (m)</strong> parameters. Underground cables cannot be defined in this configuration. The title of the table is Cable Configuration: Aerial.</p></td></tr><tr><td><strong>Configuration|Cables in a pipe</strong> — Cables in pipe configuration</td><td><p>The <strong>Cable Configuration</strong> table assumes that the cables are inside a metallic pipe. Any previously edited parameters in the table are lost. The position of the cables is specified by <strong>X (m)</strong> and <strong>Angle (deg)</strong> parameters.</p><p>Aerial and underground cables cannot be defined in this configuration. The title of the table is Cable Configuration: Inside a pipe.</p></td></tr><tr><td><strong>Help</strong> — App documentation</td><td>Open the documentation page of the app.</td></tr></tbody></table>

### Geometry Tab

#### **General Parameters**

<table data-header-hidden><thead><tr><th width="250"></th><th></th></tr></thead><tbody><tr><td><strong>User comments</strong> — User comments</td><td>Free space to write comments related to the cable arrangement modeled by the app.</td></tr><tr><td><strong>Ground resistivity (ohm.m)</strong> — Ground resistivity<br><code>100</code> (default) | positive scalar</td><td>Ground resistivity in ohm-meters.</td></tr><tr><td><strong>Number of cables</strong> — Number of cables<br><code>4</code> (default) | integer</td><td>Specify how many cables are in the cable configuration. A cable is an arrangement of concentric conductors separated with insulators. If you increase the value of the <strong>Number of Cables</strong> parameter, additional lines are added to the <strong>Cable Configuration</strong> table. The App automatically duplicates the parameter values of the last cable in the table and increments the <strong>Phase Number</strong> values accordingly. Depending on the cable configuration, the <strong>H (m)</strong> parameter value or the <strong>Angle (deg)</strong> parameter value is computed to not overlap position of other cables in the table.</td></tr><tr><td><strong>Number of cable types</strong> — Number of cable types<br><code>1</code> (default) | integer</td><td>Number of cable types. Specify how many different types of cables you have in your cable arrangement.</td></tr></tbody></table>

#### **Frequency-Dependent Model Parameters**

<table data-header-hidden><thead><tr><th width="250.111083984375"></th><th></th></tr></thead><tbody><tr><td><strong>Frequency range logspace(X1,X2,N)</strong> — Frequency range logspace(X1,X2,N)<br><code>[-4,5,400]</code> (default) | 3-element vector</td><td>Specify a vector of three elements to define a frequency vector in the logspace(X1, X2,N) format, consisting of N logarithmically equally spaced points between 10^X1 and 10^X2.</td></tr><tr><td><strong>Cable length (km)</strong> — Cable length<br><code>6</code> (default) | positive scalar</td><td>Specify the length of the cable arrangement in kilometers. All the cables contained in the arrangement have the same length.</td></tr><tr><td><strong>Compute</strong> — Compute frequency-dependent model parameters button<br>button</td><td>Computes the WB structure variable that contains the frequency-dependent parameters for the cable model. RLGC matrices are also computed at the frequency specified in the <strong>Frequency (Hz)</strong> parameter. After computing the parameters, the app displays the results in the <strong>Computed Parameters</strong> tab.</td></tr></tbody></table>

#### **RLGC Cable Parameters**

<table data-header-hidden><thead><tr><th width="250.22222900390625"></th><th></th></tr></thead><tbody><tr><td><strong>Frequency (Hz)</strong> — Cable frequency<br><code>60</code> (default) | positive scalar</td><td>Frequency in hertz that is used to evaluate RLC parameters.</td></tr><tr><td><strong>Compute</strong> — Compute RLGC matrices<br>button</td><td>Computes the R, L, G and C matrices for a given cable. After computing the parameters, the app displays the results in the <strong>Computed Parameters</strong> tab.</td></tr></tbody></table>

#### **Cable Configuration Table**

<table data-header-hidden><thead><tr><th width="249.6666259765625"></th><th></th></tr></thead><tbody><tr><td><strong>Cross-bond the sheaths</strong> — Cross-bond sheaths<br>cleared (default) | checkbox</td><td><p>When selected the elements of the RLGC matrices are averaged to reflect cross-bonding the sheaths. The sheath conductors correspond to the conductor no.2 of the cables. The cable can have more than two conductors; however, to use the option all the additional conductors (3,4, …) of each cables need to be grounded, i.e., associated to phase number 0 in the <strong>Phase Number</strong> parameter vector. The electric power losses in a cable system dependent on the induced currents flowing in the metallic sheaths. These induced currents depend on the coupling between phase and sheath conductors. For example, in a three-phase cable, if sheaths are not cross-bonded a flat formation will produce higher induced sheath voltages than a trefoil formation. This will in turn result in higher sheath circulating currents and higher losses if the sheaths are bonded (grounded) at both ends. To decrease sheath induced voltage and currents, cross-bonding of sheaths is performed on minor cable sections, like transposition of three-phase aerial transmission lines. Select this option as an alternative to model all minor sections of cables with physical transposition of sheaths. This will result in approximately same induced voltage and currents in the sheaths while simulating much faster because the model size is reduced, and a longer cable length allows using a larger sample time.</p><p><strong>Dependencies</strong> To enable this parameter,</p><ul><li>All the cables in the Cable Configuration table must be set to the same Cable Type value.</li><li>The Cable Type value must correspond to a cable type having two or more conductors.</li><li>All conductors outside the sheath must be grounded (Phase Number value set to 0).</li></ul></td></tr><tr><td><strong>V (m)</strong> — Cable vertical position<br>-2 (default) | scalar</td><td><p>Vertical position of the center of the cable. When you select <strong>Aerial cables</strong> configuration in the <strong>Configuration</strong> menu, all the V values in the table must be finite positive values. When you select <strong>Underground cables</strong> configuration in the <strong>Configuration</strong> menu, all the V values in the table must be finite negative values. The app does not allow a mix of aerial and underground cables.</p><p><strong>Dependencies</strong> To enable this parameter, select <strong>Aerial cables</strong> or <strong>Underground cables</strong> options in the <strong>Configuration</strong> menu.</p></td></tr><tr><td><strong>H (m)</strong> — Cable horizontal position<br>0 (default) | scalar</td><td><p>Represent the horizontal position of the cable. H value can be negative, 0, or positive. You can define the horizontal mark position 0 anywhere in your cable arrangement and define the position of the cables according to this mark. For example, the position 0 can be defined in the center of the cable arrangement, so the cables placed on the left will have a negative H (m) value and those on the right will have a positive H (m) value.</p><p><strong>Dependencies</strong> To enable this parameter, select <strong>Aerial cables</strong> or <strong>Underground cables</strong> options in the <strong>Configuration</strong> menu.</p></td></tr><tr><td><strong>X (m)</strong> — Cable position inside pipe<br>0.00331 (default) | positive scalar</td><td><p>Cable position relative to the center of the pipe, in meters. Specify the position of the center of the cable relative to the center of the pipe.</p><p><img src="https://799605156-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FdlNg8IbOdahCpFCyzxSN%2Fuploads%2Fgit-blob-d54d04f60eab5fda400b3db93b8a6b997a7922b3%2Fcable_parameter_x.png?alt=media" alt="" data-size="original"></p><p><strong>Dependencies</strong> To enable this parameter, select <strong>Cables in a pipe</strong> in the <strong>Configuration</strong> menu.</p></td></tr><tr><td><strong>Angle (deg)</strong> — Cable position inside pipe<br>60 (default) | positive scalar</td><td><p>Position angle of the cable inside the pipe, in degrees. Specify the angle of the imaginary line that represents the distance between the center of the pipe and the center of the cable.</p><p><img src="https://799605156-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FdlNg8IbOdahCpFCyzxSN%2Fuploads%2Fgit-blob-f5792ace8ca1e9fc40a2ae90a40feb3eb888dd65%2Fcable_parameter_angle.png?alt=media" alt="" data-size="original"></p><p><strong>Dependencies</strong> To enable this parameter, select <strong>Cables in a pipe</strong> in the <strong>Configuration</strong> menu.</p></td></tr><tr><td><strong>R_out (m)</strong> — Cable external radius<br>0.0389 (default) | positive scalar</td><td><p>External radius of the cable.</p><p>The radius of the of the outer insulation of the cable.<img src="https://799605156-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FdlNg8IbOdahCpFCyzxSN%2Fuploads%2Fgit-blob-564141ce635d1bdc9b22b92c42ff09cc03fa10d0%2Fcable_parameter_radius.png?alt=media" alt=""></p></td></tr><tr><td><strong>Cable type</strong> — Type of cable<br>1 (default) | positive integer</td><td>Value corresponding to the cable type number defined in the <strong>Cable types</strong> table.</td></tr><tr><td><strong>Phase Number</strong> — Conductor phase numbers<br>[1,2] (default) | vector of positive integer</td><td><p>Associate each conductor of the cable to the electrical phases of the network. All the conductors for all the cables in the cable configuration need to be associated to an unique phase number. The only exception is phase 0 (meaning that the conductor is grounded) that can be specified for several conductors in several cables. Phase numbers start with 1 (or 0 if you have grounded conductors) and increase consecutively.</p><p>The phase numbers do not need to be specified in the numerical order in the table. For example, the following configuration is correct: we have a total of 7 conductors; two are grounded, and all the other conductors are uniquely attributed to a phase number 1,2,3,4, and 5 :<img src="https://799605156-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FdlNg8IbOdahCpFCyzxSN%2Fuploads%2Fgit-blob-d8e96df63107936e9e38146f24cf44390c8324dd%2Fcable_parameter_phasenumber.png?alt=media" alt=""></p></td></tr></tbody></table>

#### **Cable Types Table**

<table data-header-hidden><thead><tr><th width="250"></th><th></th></tr></thead><tbody><tr><td><strong>Show cable type</strong> — Number of cable types<br>1 (default) | list</td><td>Select the cable type number and the <strong>Cable Types</strong> table will show its parameters. The drop-down menu lists all the cable type numbers, from 1 to <strong>Number of cable types</strong>.</td></tr><tr><td><strong>Number of conductors</strong> — Number of conductors of selected cable type<br>2 (default) | positive integer</td><td>Specify how many concentric conductors exist in the selected cable. When the number of conductors parameter is increased, the app automatically adds a new line in the table with similar parameters as of the previous conductor, and it resizes the <strong>R_in</strong> and <strong>R_out</strong> dimensions proportionally..</td></tr><tr><td><strong>R_in (m)</strong> — Inside conductor radius<br>0 (default) | positive scalar</td><td>Inside radius of the conductor. Specify the distance from the center of the cable to the inner part of the conductor. For the first conductor, this value is usually set to 0.<img src="https://799605156-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FdlNg8IbOdahCpFCyzxSN%2Fuploads%2Fgit-blob-640be8ac8799f6e96107ed48da3452f3ae993fa2%2Fcable_parameter_inside_radius.png?alt=media" alt=""></td></tr><tr><td><strong>R_out (m)</strong> — Outside conductor radius<br>0.01265 (default) | positive scalar</td><td>Outside radius of the conductor. Specify the distance from the center of the cable to the outer part of the conductor.<img src="https://799605156-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FdlNg8IbOdahCpFCyzxSN%2Fuploads%2Fgit-blob-309621094342cf4b6d2b66304104df3e364d4a70%2Fcable_parameter_outsideradius.png?alt=media" alt=""></td></tr><tr><td><strong>Rho (Ohm.m)</strong> — Conductor resistivity<br>2.69e-08 (default) | positive scalar</td><td>Conductor resistivity. The resistivity of the conductor in ohm.m</td></tr><tr><td><strong>MUE</strong> — Conductor relative permeability<br>1 (default) | positive scalar</td><td>Conductor relative permeability. The relative permeability of the conductor.<br><img src="broken://files/WwPaWA6GKvg64ob9ElES" alt=""></td></tr><tr><td><strong>MUE_IN</strong> — Insulation relative permeability<br>1 (default) | positive scalar</td><td>Surrounding insulation relative permeability. The relative permeability of the insulation that surrounds the conductor.<img src="https://799605156-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FdlNg8IbOdahCpFCyzxSN%2Fuploads%2Fgit-blob-37d44feaa80dc8f52a1246f9046433cf23d805f2%2Fcable_parameter_MUE.png?alt=media" alt=""></td></tr><tr><td><strong>EPS_IN</strong> — Insulator relative permittivity<br>2.3 (default) | positive scalar</td><td>Surrounding insulation relative permittivity. The relative permittivity of the insulation that surrounds the conductor.<img src="https://799605156-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FdlNg8IbOdahCpFCyzxSN%2Fuploads%2Fgit-blob-37d44feaa80dc8f52a1246f9046433cf23d805f2%2Fcable_parameter_MUE.png?alt=media" alt=""></td></tr><tr><td><strong>LFCT_IN</strong> — Insulator loss factor<br>0 (default) | positive scalar</td><td>Surrounding insulation loss factor. The loss factor of the insulation that surrounds the conductor. A loss factor of 0.001 means that the active power losses (in watts) inside the dielectric is the 0.1% of the reactive power (in vars) associated with the Conductor1-Conductor 2 capacitance.<img src="https://799605156-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FdlNg8IbOdahCpFCyzxSN%2Fuploads%2Fgit-blob-37d44feaa80dc8f52a1246f9046433cf23d805f2%2Fcable_parameter_MUE.png?alt=media" alt=""></td></tr></tbody></table>

#### **Pipe Parameters**

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

<table data-header-hidden><thead><tr><th width="250.00006103515625"></th><th></th></tr></thead><tbody><tr><td><strong>R_in (m)</strong> — Internal radius<br>0.24 (default) | positive scalar</td><td>Internal radius of the metallic pipe in meters.</td></tr><tr><td><strong>R_out (m)</strong> — External metallic pipe radius<br>0.25 (default) | positive scalar</td><td>External radius of the metallic pipe in meters.</td></tr><tr><td><strong>R_ext</strong> — Pipe external radius<br>0.27 (default) | positive scalar</td><td>External radius of the outer insulator.</td></tr><tr><td><strong>V_depth (m)</strong> — Pipe depth<br>-2.107 (default) | negative scalar</td><td>Depth of center of the pipe below the ground level.</td></tr><tr><td><strong>MUE</strong> — Metallic pipe relative permeability<br>1 (default) | positive scalar</td><td>Metallic pipe relative permeability.</td></tr><tr><td><strong>MUE_in</strong> — Inner insulation relative permeability<br>1 (default) | positive scalar</td><td>Inside insulation relative permeability.</td></tr><tr><td><strong>EPS_in</strong> — Inner insulation relative permittivity<br>1 (default) | positive scalar</td><td>Inside insulation relative permittivity.</td></tr><tr><td><strong>LFCT_in</strong> — Inner insulation loss factor<br>0.001 (default) | positive scalar</td><td>Inside insulation loss factor.</td></tr><tr><td><strong>Rho (ohm.m)</strong> — Metallic pipe resistivity<br>1.8e-08 (default) | positive scalar</td><td>Pipe resistivity. The resistivity of the metallic pipe.</td></tr><tr><td><strong>MUE_out</strong> — Outer insulation relative permeability<br>1 (default) | positive scalar</td><td>Outside insulation relative permeability.</td></tr><tr><td><strong>EPS_out</strong> — Outer insulation relative permittivity<br>2 (default) | positive scalar</td><td>Outside insulation relative permittivity.</td></tr><tr><td><strong>LFCT_out</strong> — Outer insulation loss factor<br>0.001 (default) | positive scalar</td><td>Outside insulation loss factor.</td></tr><tr><td><strong>Phase number</strong> — Pipe phase number<br>7 (default) | integer</td><td>Phase number connected to the metallic pipe. Specify a value of 0 to connect the metallic pipe to the electrical ground. Specify a positive integer value between 1 and N+1, where N is the maximum phase number value that is specified in the <strong>Phase Number</strong> column of the <strong>Cable Configuration</strong> table.</td></tr></tbody></table>

### Computer Parameters Tab

Display the R, L, G, and C matrices resulting of the **Compute** buttons.

<table data-header-hidden><thead><tr><th width="250.22222900390625"></th><th></th></tr></thead><tbody><tr><td><strong>Send to workspace</strong> — Send RLGC, and WB to workspace<br>button</td><td>Sends the R, L, G, C, and WB parameters to the MATLAB workspace. The app creates the variables R, L, G, C, and WB in your workspace.</td></tr><tr><td><strong>Block</strong> — Block selector<br>button</td><td>Confirms the block selection. The name of the selected block appears in the Send to block edit parameter.</td></tr><tr><td><strong>Block Name</strong> — Selected block name<br>char string</td><td>Edit box to either manually specify the name of a PI Section Line block, Distributed Parameters Line, or Distributed Parameters Line Frequency Dependent block where the RLGC or WB parameters will be sent when the user clicks the <strong>Send</strong> button. By default, it displays: – No block specified, and the <strong>Send</strong> button is grayed out and unavailable.</td></tr><tr><td><strong>Send to block</strong> — Send RLGC matrices to the selected block<br>button</td><td>Sends the RLC parameters to the Distributed Parameter Line or Pi Section Line blocks specified in the <strong>Send to block</strong> parameter. Send the WB parameters via a mat file to the Distributed Parameter Line Frequency Dependent block specified in the <strong>Send to block</strong> parameter.</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/smart-power-simulation-software-sps/blocks-functions-tools/simulation-and-analysis/cable-parameter-calculator.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.
