> 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/power-line-parameters.md).

# Power Line Parameters

## Description

The **Power Line Parameters app** computes RLC parameters of overhead transmission line from its conductor characteristics and tower geometry

The **Power Line Parameters app** provides a tool to compute the RLC line parameters of the Distributed Parameters Line and PI Section Line blocks and the frequency-dependent parameters of a Distributed Parameters Line (Frequency-Dependent) block. The tool uses the [power\_lineparam](https://www.opal-rt.com/docs/smart-power-simulation-software-sps/blocks-functions-tools/power-transmission-and-distribution/power_lineparam.md) function to compute the line parameters based on the geometry of the line and the type of conductors.

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

## Syntax

Open the Power Line Parameters App:

* From the powergui Block Parameters dialog box: On the Tools tab, click Power Line Parameters.
* From the MATLAB® command prompt:

{% code lineNumbers="true" %}

```matlab
powerLineParameters
```

{% endcode %}

## Parameters

<table data-header-hidden><thead><tr><th width="249.77783203125"></th><th></th></tr></thead><tbody><tr><td><strong>Comments</strong> — Custom comments<br>no default</td><td>Use this text box to type comments that you want to save with the line parameters, for example, voltage level, conductor types and characteristics, etc.</td></tr></tbody></table>

### Menu Commands

<table data-header-hidden><thead><tr><th width="249.77777099609375"></th><th></th></tr></thead><tbody><tr><td><strong>Load > Typical parameters</strong> — Load typical parameters - no default</td><td>Opens a browser window where you can select examples of line configurations provided with SPS Software. Select the desired .mat file.</td></tr><tr><td><strong>Load > User parameters</strong> — Load user parameters<br>no default</td><td>Opens a browser window where you can select your own line data. Select the desired .mat file.</td></tr><tr><td><strong>Save</strong> — Save line data<br>no default</td><td>Saves your line data by generating a <code>.mat</code> file that contains the GUI information and the line data.</td></tr><tr><td><strong>Report</strong> — Create report<br>no default</td><td>Creates a file containing the line input parameters and the computed RLC parameters. The MATLAB Editor opens to display the contents of the file.</td></tr></tbody></table>

Selecting **Load typical parameters** allows you to load one of the following line configurations:

<table data-header-hidden><thead><tr><th width="249.77764892578125"></th><th></th></tr></thead><tbody><tr><td>Line_25kV_4wires.mat</td><td>25-kV, three-phase distribution feeder with accessible neutral conductor.</td></tr><tr><td>Line_315kV_2circ.mat</td><td>315-kV, three-phase, double-circuit line using bundles of two conductors. Phase numbering is set to obtain the RLC parameters of the two individual circuits (six-phase line).</td></tr><tr><td>Line_450kV.mat</td><td>Bipolar +/−450-kV DC line using bundles of four conductors.</td></tr><tr><td>Line_500kV_2circ.mat</td><td>500-kV, three-phase, double-circuit line using bundles of three conductors. Phase numbering is set to obtain the RLC parameters of the three-phase line circuit equivalent to the two circuits connected in parallel.</td></tr><tr><td>Line_735kV.mat</td><td>735-kV, three-phase line using bundles of four conductors.</td></tr></tbody></table>

### General Parameters

<table data-header-hidden><thead><tr><th width="250"></th><th></th></tr></thead><tbody><tr><td><strong>Units</strong> — Conductor diameter, GMR, and bundle diameter units<br>english (default) | metric</td><td>Select metric to specify conductor diameter, GMR, and bundle diameter in centimeters and conductor positions in meters. Select english to specify conductor diameter, GMR, and bundle diameter in inches and conductor positions in feet.</td></tr><tr><td><strong>Ground Resistivity</strong> — Ground Resistivity<br>100 (default) | positive scalar</td><td>Specify the ground resistivity, in ohm-meters. A zero value (perfectly conducting ground) is allowed.</td></tr><tr><td><strong>Nominal Frequency</strong> — Frequency to evaluate RLC parameters<br>60 (default) | positive scalar</td><td>Specify the frequency, in hertz, to evaluate RLC parameters.</td></tr></tbody></table>

### Line Geometry

<table data-header-hidden><thead><tr><th width="249.55572509765625"></th><th></th></tr></thead><tbody><tr><td><strong>Phase conductors (bundles)</strong> — Number of phase conductors (bundles)<br>3 (default) | positive scalar</td><td>Specify the number of phase conductors (single conductors or bundles of subconductors).</td></tr><tr><td><strong>Ground conductors (bundles)</strong> — Number of ground wires (bundles)<br>2 (default) | nonnegative scalar</td><td>Specify the number of ground wires (single conductors or bundles of subconductors). Ground wires are not usually bundled.</td></tr><tr><td><strong>Label</strong> — Conductor or bundle identifiers<br>no default</td><td>Lists the conductor or bundle identifiers. Phase conductors are identified as p1, p2,..., pn. Ground wires are identified as g1,g2,..., gn.</td></tr><tr><td><strong>Phase, Phase Number</strong> — Phase number<br>no default</td><td><p>Specify the phase number to which the conductor belongs. Several conductors may have the same phase number. All conductors that have the same phase number are lumped together and are considered as a single equivalent conductor in the R, L, and C matrices. For example, if you want to compute the line parameters of a three-phase line equivalent to a double-circuit line such as the one represented in the figure , you specify phase numbers 1, 2, 3 for conductors p1, p2, p3 (circuit 1) and phase numbers 3, 2, 1 for conductors p4, p5, p6 (circuit 2), respectively. If you prefer to simulate this line as two individual circuits and have access to the six phase conductors, you specify phase numbers 1, 2, 3, 6, 5, 4 respectively for conductors p1, p2, p3, p4, p5 and p6.</p><p>In three-phase systems, the three phases are usually labeled A, B, and C. The correspondence with the phase number is:<br>1, 2, 3, 4, 5, 6, 7, 8, 9,.... = A, B, C, A, B, C, A, B, C,...</p><p>You can also use the phase number to lump conductors of an asymmetrical bundle.</p><p>For ground wires, the phase number is forced to zero. All ground wires are lumped with the ground and they do not contribute to the R, L, and C matrix dimensions. If you need to access the ground wire connections in your model, you must specify these ground wires as normal phase conductors and manually connect them to the ground.</p></td></tr><tr><td><strong>X</strong> — Horizontal position of conductor<br>positive scalar</td><td>Specify the horizontal position of the conductor, in meters or feet. The location of the zero reference position is arbitrary. For a symmetrical line, you typically choose X = 0 at the center of the line.</td></tr><tr><td><strong>Y tower</strong> — Vertical position of conductor at tower<br>positive scalar</td><td>Specify the vertical position of the conductor (at the tower) with respect to ground, in meters or feet.</td></tr><tr><td><strong>Y min</strong> — Vertical position of the conductor at mid-span<br>positive scalar</td><td><p>Specify the vertical position of the conductor with respect to ground at mid-span, in meters or feet.</p><p>The average height of the conductor (see the figure) is produced by this equation:</p><p><span class="math">\\[4pt]Y_{\text{average}} = Y_{\min} + \frac{\text{sag}}{3} = \frac{2Y_{\min} + Y_{\text{tower}}}{3} \\[8pt]</span></p><p>Y<sub>tower</sub> = height of conductor at tower</p><p>Y<sub>min</sub> = height of conductor at mid span</p><p>sag = Y<sub>tower</sub>−Y<sub>min</sub></p><p>Instead of specifying two different values for Y<sub>tower</sub> and Y<sub>min</sub>, you may specify the same Y<sub>average</sub> value.</p></td></tr><tr><td><strong>Conductor type</strong> — Conductor or bundle type numbers<br>positive integer</td><td>Specify one of the conductor or bundle type numbers listed in the first column of the table of conductor characteristics.</td></tr></tbody></table>

### Conductors

<table data-header-hidden><thead><tr><th width="250.22216796875"></th><th></th></tr></thead><tbody><tr><td><strong>Conductor types</strong> — Number of conductor types<br>positive integer</td><td><p>Specify the number of conductor types (single conductor or bundle of subconductors). This parameter determines the number of rows in the table of conductors. The phase conductors and ground conductors can be either single conductors or bundles of subconductors. For voltage levels of 230 kV and higher, phase conductors are usually bundled to reduce losses and electromagnetic interferences due to corona effect. Ground wires are usually not bundled.</p><p>For a simple AC three-phase line, single- or double-circuit, there are usually two types of conductors: one type for the phase conductors and one type for the ground wires. You need more than two types for several lines in the same corridor, DC bipolar lines or distribution feeders, where neutral and sheaths of TV and telephone cables are represented.</p></td></tr><tr><td><kbd><strong>Internal conductor inductance evaluated from</strong> — Computation method for conductor internal inductance</kbd><br><kbd>T/D ratio (default) | Geometric Mean Radius (GMR) | Reactance Xa at 1-foot spacing | Reactance Xa at 1-meter spacing</kbd></td><td><p>Select one of the following three parameters to specify how the conductor internal inductance is computed: T/D ratio, Geometric Mean Radius (GMR), or Reactance Xa at 1-foot spacing (or Reactance Xa at 1-meter spacing if the <strong>Units</strong> parameter is set to metric).</p><p>If you select T/D ratio, the internal inductance is computed from the T/D value specified in the table of conductors, assuming a hollow or solid conductor. D is the conductor diameter and T is the thickness of the conducting material (see the figure). The conductor self-inductance and resistance are computed from the conductor diameter, T/D ratio, DC resistance, and relative permeability of conducting material and specified frequency.</p><p>If you select Geometric Mean Radius (GMR), the conductor GMR evaluates the internal inductance. When the conductor inductance is evaluated from the GMR, the specified frequency does not affect the conductor inductance. You must provide the manufacturer's GMR for the desired frequency (usually 50 Hz or 60 Hz). When you are using the T/D ratio option, the corresponding conductor GMR at the specified frequency is displayed in the <strong>Conductors</strong> table.</p><p>Selecting Reactance Xa at 1-foot spacing (or Reactance Xa at 1-meter spacing) uses the positive-sequence reactance at the specified frequency of a three-phase line having 1-foot (or 1-meter) spacing between the three phases to compute the conductor internal inductance.</p></td></tr><tr><td><strong>Include conductor skin effect</strong> — Include impact of frequency on conductor AC resistance and inductance<br>on (default) | off</td><td>Select this check box to include the impact of frequency on conductor AC resistance and inductance (skin effect). If this parameter is cleared, the resistance is kept constant at the value specified by the <strong>Conductor DC resistance</strong> parameter and the inductance is kept constant at the value computed in DC, using the <strong>D out</strong> (conductor outside diameter) and the <strong>T/D ratio</strong> parameters of the <strong>Conductors</strong> table. When skin effect is included, the conductor AC resistance and inductance are evaluated considering a hollow conductor with T/D ratio (or solid conductor if T/D = 0.5). The T/D ratio evaluates the AC resistance even if the conductor inductance is evaluated from the GMR or from the reactance at 1-foot spacing or 1-meter spacing. The ground skin effect is always considered and it depends on the ground resistivity.</td></tr><tr><td><strong>D out</strong> — Conductor outside diameter<br>positive scalar</td><td>Specify the conductor outside diameter, in centimeters or inches.</td></tr><tr><td><strong>T/D ratio</strong> — Conductor T/D ratio<br>scalar between 0 and 0.5</td><td>Specify the T/D ratio of the hollow conductor. T is the thickness of the conducting material, and D is the outside diameter. This parameter can vary between 0 and 0.5. A T/D value of 0.5 indicates a solid conductor. For Aluminum Cable Steel Reinforced (ACSR) conductors, you can ignore the steel core and consider a hollow aluminum conductor (typical T/D ratios are between 0.3 and 0.4). The T/D ratio is used to compute the conductor AC resistance when the <strong>Include conductor skin effect</strong> parameter is selected. It is also used to compute the conductor self-inductance when the parameter <strong>Internal conductor inductance evaluated from</strong> is set to T/D ratio.</td></tr><tr><td><strong>GMR</strong> — Geometric mean radius<br>positive scalar</td><td>This parameter is accessible only when the parameter <strong>Internal conductor inductance evaluated from</strong> is set to Geometric Mean Radius (GMR). Specify the GMR in centimeters or inches. The GMR at 60 Hz or 50 Hz is usually provided by conductor manufacturers.<br>When the parameter <strong>Internal conductor inductance evaluated from</strong> is set to T/D ratio, the value of the corresponding GMR giving the same conductor inductance is displayed.<br>When the parameter <strong>Internal conductor inductance evaluated from</strong> is set to Reactance Xa at 1-foot spacing or Reactance Xa at 1-meter spacing, the title of the column changes to <strong>Xa</strong>.</td></tr><tr><td><strong>Xa</strong> — Reactance Xa at 1-meter spacing or 1-foot spacing<br>positive scalar</td><td>This parameter is accessible only when <strong>Internal conductor inductance evaluated from</strong> is set to Reactance Xa at 1-meter spacing or Reactance Xa at 1-foot spacing. Specify the Xa value in ohms/km or ohms/mile at the specified frequency. The X<sub>a</sub> value at 60 Hz or 50 Hz is usually provided by conductor manufacturers.</td></tr><tr><td><strong>DC res</strong> — Conductor DC resistance<br>positive scalar</td><td>Specify the DC resistance of conductor in ohms/km or ohms/mile.</td></tr><tr><td><strong>mu_r</strong> — Conductor relative permeability<br>positive scalar</td><td>Specify the relative permeability µ<sub>r</sub> of the conducting material. µ<sub>r</sub> = 1.0 for nonmagnetic conductors (such as aluminum or copper). This parameter is not accessible when the <strong>Include conductor skin effect</strong> parameter is cleared.</td></tr><tr><td><strong>Nb_cond</strong> — Number of conductors per bundle<br>positive integer</td><td>Specify the number of subconductors in the bundle or 1 for single conductors.</td></tr><tr><td><strong>Db</strong> — Bundle diameter<br>positive scalar</td><td>Specify the bundle diameter, in centimeters or inches. This parameter is not accessible when the <strong>Nb_cond</strong> is set to 1. When you specify bundled conductors, the subconductors are assumed to be evenly spaced on a circle. If this is not the case, you must enter individual subconductor positions in the <strong>Line Geometry</strong> table and lump these subconductors by giving them the same <strong>Phase Number</strong> parameter.</td></tr><tr><td><strong>Angle</strong> — Angle of conductor 1<br>positive scalar</td><td>Specify an angle, in degrees, that determines the position of the first conductor in the bundle with respect to a horizontal line parallel to ground. This angle determines the bundle orientation. This parameter is not accessible when the <strong>Nb_cond</strong> is set to 1.</td></tr></tbody></table>

### Frequency-Dependent Line Parameters

<table data-header-hidden><thead><tr><th width="250.22235107421875"></th><th></th></tr></thead><tbody><tr><td><strong>Frequency range logspace</strong> — Frequency range for parameter computation<br>[-2,5,141] (default) | three-element vector</td><td>Specify a frequency range for the parameter computation. Enter a vector of three elements,[X1,X2,N]. This parameter defines a frequency vector of N logarithmically equally spaced points between decades 10^X1 and 10^X2.</td></tr><tr><td><strong>Line Length</strong> — Length of line<br>100 (default) | positive scalar</td><td>Specify the length of the line, in km.</td></tr></tbody></table>

### Compute

<table data-header-hidden><thead><tr><th width="249.77777099609375"></th><th></th></tr></thead><tbody><tr><td><strong>RLC Line Parameters</strong> — Compute RLC line parameters<br>no default</td><td><p>Computes the RLC parameters. After completion of the parameters computation, results are displayed in the <strong>Computed Parameters</strong> section.</p><div data-gb-custom-block data-tag="hint" data-style="info" class="hint hint-info"><p>The R, L, and C parameters are always displayed respectively in ohms/km, henries/km, and farads/km, even if the English units specify the input parameters.</p></div><p>If the number of phase conductors is 3 or 6, the symmetrical component parameters are also displayed:</p><ul><li>For a three-phase line (one circuit), R10, L10, and C10 vectors of two values are displayed for positive-sequence and zero-sequence RLC values.</li><li>For a six-phase line (two coupled three-phase circuits), R10, L10, and C10 are vectors of five values containing the following RLC sequence parameters: the positive-sequence and zero-sequence of circuit 1, the mutual zero-sequence between circuit 1 and circuit 2, and the positive-sequence and zero-sequence of circuit 2.</li></ul></td></tr><tr><td><strong>Frequency Dependent Model Parameters</strong> — Compute frequency dependent parameters<br>no default</td><td>Computes the frequency dependent parameters. After completion of the parameters computation, results are displayed in the <strong>Computed Parameters</strong> section.</td></tr></tbody></table>

### Computed Parameters

<table data-header-hidden><thead><tr><th width="250.44451904296875"></th><th></th></tr></thead><tbody><tr><td><strong>Block</strong> — Selected block<br>no default</td><td>Select a Distributed Parameters Line block (either to set the matrices or sequence RLC parameters), a Pi Section Line block, or a Three-Phase PI Section Line block in your model, then click the button to confirm the block selection. The name of the selected block appears in the left window.</td></tr><tr><td><strong>Send RLC matrices to block</strong> — Download RLC matrices to block<br>no default</td><td>Downloads RLC matrices into the selected block. This button is not visible when the selected block is a Distributed Parameters Line (Frequency-Dependent) block.</td></tr><tr><td><strong>Send Sequences to block</strong> — Download RLC sequence parameters to block<br>no default</td><td>Downloads RLC sequence parameters into the selected block. This button is not visible when the selected block is a Distributed Parameters Line (Frequency-Dependent) block.</td></tr><tr><td><strong>Send to workspace</strong> — Send matrices and component parameters to MATLAB workspace<br>no default</td><td>Sends the R, L, and C matrices, as well as the symmetrical component parameters, to the MATLAB workspace. The following variables are created in your workspace: <code>R_matrix</code>, <code>L_matrix</code>, <code>C_matrix</code>, and <code>R10</code>, <code>L10</code>, <code>C10</code> for symmetrical components.</td></tr><tr><td><strong>Send Frequency-Dependent Parameters to block</strong> — Download frequency-dependent parameters to block<br>button</td><td>Downloads the frequency-dependent parameters into the selected block. This button is not visible when the block is not a Distributed Parameters Line (Frequency-Dependent) block.</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/power-transmission-and-distribution/power-line-parameters.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.
