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

# Line Data

## Description

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

The **Line Data** block, located in the **Network Lines and Cables** library, is used to produce transmission line models for steady-state and time-domain studies. Line parameters are calculated from the transmission line geometry.

* **FD:** Frequency-dependent model
* **CP:** Constant-parameter model
* **Exact-PI:** Exact frequency-domain representation of a line at a given frequency
* **Wideband:** Wideband line model

## Transformation matrices

For a perfectly balanced line, the modal transformation matrices are frequency‑independent and can be chosen real (e.g., generalized Clarke, as used by HYPERSIM). For untransposed lines, transformation matrices vary with frequency.

The line currents transformation matrix T<sub>i</sub> diagonalizes Y<sub>phase</sub> Z<sub>phase</sub>, where Y<sub>phase</sub> is the shunt admittance matrix and Z<sub>phase</sub> is the series impedance matrix in phase quantities. The resulting Q (also called T<sub>i</sub>) is complex and is normalized using the Euclidean norm. The voltages transformation matrix T<sub>v</sub> diagonalizes Z<sub>phase</sub> Y<sub>phase</sub> and is computed as T<sub>v</sub> = (T<sub>i</sub>)<sup>−t</sup> (inverse transposed).

In the **Exact‑PI model**, the final model uses phase quantities; exact complex transformation matrices can be used at each frequency. This one‑frequency model is valid for steady‑state but not for transients.

In the **CP model**, frequency dependence is ignored. The model uses modal quantities; R, L, C are calculated exactly at one frequency using the exact complex matrix at that frequency. Since G<sub>mode</sub> = 0 is assumed, T<sub>i</sub> columns are rotated to satisfy this condition; the imaginary parts become very small. HYPERSIM requires T<sub>i</sub> to be purely real, so only the real part (after rotation) is kept in the model data file.

The **FD model** accounts for frequency dependence and distributed losses (with finite G). Like CP, FD is formulated in modal quantities and requires a real constant T<sub>i</sub>. Although FD does not assume zero modal conductances, the recommended rotation is the same as CP: rotate T<sub>i</sub> to satisfy G<sub>mode</sub> = 0 when G<sub>phase</sub> = 0. This default can be overridden with “Rotate matrix T<sub>i</sub>” in Output Options. Results are similar for both criteria because G is usually very small.

### Description of line parameters output file

The output file from Line Parameters has two main sections:

* Conductor characteristics
* Line parameters

#### **Conductor characteristics**

* Lists average height (y‑coordinate) instead of tower and midspan heights.
* Orders conductors as: phases 1, 2, 3, …; then additional conductors in bundles/parallel circuits; then ground wires (wire number = 0).
* Bundle entries are listed as individual conductors.

#### **Line parameters**

Only the lower triangular part of symmetric matrices is printed. All matrices are complex, except susceptance (or capacitance) matrices for physical conductors and equivalent phase conductors. Real and imaginary parts are printed on separate rows.

<figure><img src="https://3623212549-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLxgTpoh7kyPmQ5vuyqD7%2Fuploads%2Fgit-blob-73cf0ecefec624ac28af8a96c84a31a5dac3f8e6%2Fimage%20(408).png?alt=media" alt="" width="303"><figcaption><p>Real and imaginary parts</p></figcaption></figure>

**Impedance matrices:** Z<sub>i,k</sub> is the mutual impedance (i,k). Z<sub>i,i</sub> is the self impedance of i with return through ground (and ground wires, if present and eliminated).

**Capacitance matrices:** ωC<sub>i,k</sub> is the negative susceptance between i and k. ωC<sub>i,i</sub> is the sum of all susceptances from i to others and to ground.

**Symmetrical components matrices:** Rows are ordered (0), (1), (2) for the first three‑phase circuit, then for the next circuit, etc. Columns are ordered with (1) and (2) exchanged, making matrices symmetrical.

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

From this numbering: Z<sub>1,1</sub> = Z<sub>2,2</sub> within any three‑phase circuit Z<sub>1,0</sub> = Z<sub>0,2</sub> within any three‑phase circuit Z<sub>1,0</sub> = Z<sub>0,1</sub>, etc.

With two equivalent phase conductors, a two‑pole DC line is assumed: zero sequence is equal currents into both poles returning through ground; positive sequence is current into one pole returning through the other.

For three or more equivalent phase conductors, only three‑phase circuits are assumed: 1,2,3 form the first circuit; 4,5,6 the next; etc. If there are 7 or 8 phases, the last 1 or 2 are ignored; with 9 phases, three three‑phase circuits are assumed.

### Data file format

#### FD line

After specifying “Line length,” run the Model Data Calculation Function from “Save and run this case” to generate the model data file. To use the FD line model (FD m‑phase device), select the model data file under “Time‑domain model data.” The model can be used for steady‑state and/or time‑domain simulations in HYPERSIM.

The FD model data file for a sample 3‑mode line is shown below. This file is generated automatically; the following is provided for documentation:

* First line: model data calculation function identification, model option (FD), and number of phases.
* Mode sections are identified by −1, −2, …, −N (then −A, −B, … if N > 9). The device decodes only the mode ID; each mode maps to a wire on the FD m‑phase device from top to bottom.
* Mode ID line is followed by the number of Z<sub>c</sub> poles and Z<sub>c</sub> at infinite frequency.
* Next lines: residues for the poles, then the poles.
* Next: number of A<sub>p</sub> poles and mode travel time, followed by residues of A<sub>p</sub> poles, then the poles.
* Next line: comment line.
* Then: transformation matrix Q (T<sub>i</sub>).

Data is entered as real matrix rows followed by imaginary matrix rows (imaginary data is 0 but present). The number of modes must equal the number of wires (phases) in the FD m‑phase device.

<details>

<summary>Data lines example</summary>

{% code overflow="wrap" %}

```
C LINE DATA, FD, 3 
C Comments start with C 49 48 
C LINE LENGTH = 2.2200E+02 KM 
C TRANSFORMATION MATRIX AT F = 1.0000E+03 HZ 
C The following line identifies the mode 1 (-1). The rest of this line is not 
C decoded. 
-1 1. -2 3 
21 4.74462509318108402567E+02 
2.283015427021728101D+02 9.575640649554595711D+02 2.013381477094321212D+02 6.061618998688145439D+02 -6.972729233161383036D+02 6.760451094099685143D+00 8.363043587952587643D+01 1.591355321753289900D+02 6.493018039972242832D+02 1.833223774853337545D+03 5.577558121371023844D+03 1.679503983644356776D+04 3.939444222663762048D+04 1.120239009613241506D+05 2.293957712303487351D+05 5.992245960304505425D+05 1.359085399919180200D+06 3.495434180024222005D+06 1.102754796920852736D+07 1.898582910228958726D+07 1.044347249584238678D+08 3.184377308326697461D-03 1.142659741453015743D+00 1.410247054729613758D+00 1.747385523651275863D+00 1.780662486687028201D+00 2.218827200258786547D+00 4.023109927718707013D+00 6.502239502807383609D+00 2.083985460432543846D+01 5.876541140540180663D+01 1.823876732116725918D+02 5.640593991713492414D+02 1.402308099704432834D+03 4.075276323700988542D+03 8.963552488252842522D+03 2.410076505448365424D+04 5.787837305888934497D+04 1.562438177227384003D+05 5.140558334568240098D+05 1.832975845465427265D+06 1.019662353574014083D+07 
15 8.68087756699963456440E-04 
2.446998953943564067D-05 1.101009379493385482D-01 2.729248310394779331D+00 1.163007709687541746D+00 1.330734909971337743D+01 7.270670599628982700D+01 9.703362572893102822D+01 2.288976028807581997D+02 5.706582308417526974D+02 5.873835810335974202D+03 -4.097508590341319177D+03 5.637155913727347070D+03 1.318633359546961449D+07 -1.321907020431305282D+07 2.433651981372164664D+04 1.985692975945386671D-02 2.159004563804076327D+01 2.350104352106030774D+02 2.515290357548743714D+02 5.765320412212246310D+02 1.309900558085271314D+03 1.870063871129507561D+03 3.001329244557226502D+03 3.984777264224765531D+03 5.937139251138488362D+03 6.065781934721424477D+03 1.163051851448095294D+04 1.990879557630283671D+04 1.992851726727190180D+04 2.981838019691102454D+04 
-2 1. -2 3 14 
2.72613957709204953517E+02 
2.040928261573570808D+02 7.320340772647377889D+02 5.023996315103571533D+02 -2.447593159557985132D+02 4.070538193429653973D+01 5.386497094030494814D+00 2.716602807009862772D+02 5.259885608101141088D+02 1.204394272070120593D+02 1.015066436643730441D+02 1.272919440633899768D+02 1.181570571087700898D+02 3.410575508383083616D+03 1.402412764259435644D+05 
2.827959091350378332D-03 1.100817723982985941D+00 1.468275521513094706D+00 1.657482856979041186D+00 2.067723976098531313D+00 2.509486139975520391D+00 4.585938122269856088D+00 8.520899497580858295D+00 9.624728164528338681D+00 1.457422452929704804D+01 2.403005241314601648D+01 3.912960424422755779D+01 1.791302848959001267D+03 7.388337549133962602D+04 
18 7.48652637550797027920E-04 
3.379262809620548266D-05 2.790741898524098583D-02 2.437873410569479660D+01 2.524031108790083167D+01 4.032006639563203976D+02 2.244921419547969435D+03 1.646662359713069964D+04 3.528314876257380820D+04 5.797372924111800239D+04 6.756604360794900276D+04 1.230227615342034958D+06 -7.470853275939022424D+05 1.043657001014848500D+08 -1.039677783588729799D+08 1.802076085009829104D+08 -1.814829657466953099D+08 1.576599275564814918D+07 -1.555168685457617417D+07 1.985225811826055523D-02 5.364714604810082221D+00 2.326199818676640916D+03 4.862941501813475952D+03 1.866557005247363486D+04 5.062422393492590345D+04 1.568762917443446931D+05 2.928418220667541609D+05 4.255624537142930785D+05 5.303951584052367834D+05 1.180557654378241627D+06 1.357218238814550918D+06 3.255399028247645125D+06 3.258623832750257105D+06 4.515348206166080199D+06 4.519821118733711541D+06 1.173308270877454057D+07 1.174470552294277214D+07 
-3 1. -2 3 
14 2.85812087797527453858E+02 
2.068440416608754333D+02 7.434328788502074303D+02 6.141129744727347770D+02 -3.345703266681347259D+02 2.989634922878786227D+01 1.122342424280733475D+01 2.390496148121008844D+02 1.323054560993927225D+03 -6.484703783012250824D+02 1.128252634702326986D+02 1.301301011621264081D+02 1.247322428001669010D+02 1.957136191849841271D+04 2.984413252458497416D+06 
2.867346487667737139D-03 1.099862837404594895D+00 1.480922641108804783D+00 1.650797701824323616D+00 2.039787231411344326D+00 2.491273901704059490D+00 4.341853487766006658D+00 8.903535913660869383D+00 9.283443531905913204D+00 1.461053974519216681D+01 2.397836184835597706D+01 3.982334892028816853D+01 1.001535962164031116D+04 1.534036532459646463D+06 
15 7.42260779552304772975E-04 
3.281517460210861976D-05 4.231843588743761791D-02 3.429455764932136219D+01 5.064001014999667660D+01 5.677989071445322224D+02 3.702826389013024254D+03 2.777021501646843171D+04 3.266723665610918033D+04 5.183239686396404286D+05 -1.329557821802375656D+04 -1.399472376895410998D+05 3.849242295078294724D+07 -3.893168894298432767D+07 8.090281889140170533D+05 -7.996364033324117772D+05 1.985274803339131394D-02 7.319178322505369039D+00 2.927930125718939053D+03 8.458745237649192859D+03 2.242598200799151527D+04 6.291347434485757549D+04 1.556321095858299814D+05 2.199676019453247718D+05 4.256247426522265305D+05 4.662550907182482770D+05 6.317486660880415002D+05 9.898985434087131871D+05 9.908791387987753842D+05 1.324181025567296334D+07 1.325492761823427491D+07 
C Q MATRIX BY ROWS (IMAGINARY PART = 0) 
0.57764932 -0.41240739 0.70710678 
0.00000000 0.00000000 0.00000000 
0.57663209 0.81227413 0.00000000 
0.00000000 0.00000000 0.00000000 
0.57764932 -0.41240739 -0.70710678 
0.00000000 0.00000000 0.00000000
```

{% endcode %}

</details>

#### CP line

After specifying “Line length,” run the Model Data Calculation Function from “Save and run this case” to generate the model data file. To use the CP line model (CP m‑phase device), select the model file with “Load data file” in the device data. The file format is documented with the CP m‑phase device.

## Mask parameters

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

<table><thead><tr><th width="279.5999755859375">Parameter</th><th>Description</th></tr></thead><tbody><tr><td><strong>Open an existing line case data file or use previously saved (click OK now) data for this device</strong></td><td>Open an existing line data file to modify a case, or use data previously saved in this device. To open the previously saved version, click OK (data is saved within the device, not in a file).</td></tr><tr><td><strong>Convert an existing EMTP-V3 data file</strong></td><td>Convert an EMTP‑V3 (AUX) data file to create a line case compatible with HYPERSIM.<br>Verify the translation by opening the converted line case with the first option on this page. The provided <em>myfile</em>.data is converted to <em>myfile</em>.lin and can be opened using the first option.</td></tr><tr><td><strong>Run an existing line case data file without opening its data</strong></td><td>Submit an existing case file directly to the Line Data Calculation function. You can also run old EMTP‑V3 cases without translating them.</td></tr><tr><td><strong>Create a new line case</strong></td><td>Create a new line case from scratch.</td></tr></tbody></table>

### Transmission line data calculation function

The Data tab allows entering the geometrical and electrical data of the transmission line. This include the electrical data of the conductors, their geometrical placement as well as a general description of the construction of the towers. The normally required information to characterize the transmission line is the geometric location of the conductors and their electrical characteristics. However, when the line geometry is not known, it is still possible to generate reasonably accurate line models from the 60-Hz (or any other specific frequency) positive and zero sequence impedance values.

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

{% tabs %}
{% tab title="Conductor Data" %}

<table data-search="false"><thead><tr><th width="220.199951171875" valign="top">Parameter</th><th>Description</th></tr></thead><tbody><tr><td valign="top"><strong>Module</strong></td><td>Specify the type of data to be generated:<br><strong>Line Model:</strong> Generate transmission line models for steady-state and time-domain studies.<br><strong>Line Parameters:</strong> Determine the resistance, inductance, and capacitance matrices for a multiphase overhead transmission line consisting of an arbitrary conductor configuration.</td></tr><tr><td valign="top"><strong>Units</strong></td><td>Select the unit system for conductor and line data. Units are shown next to each parameter:<br><strong>Metric:</strong> SI units for conductor and line data.<br><strong>English:</strong> English units for conductor and line data.</td></tr><tr><td valign="top"><strong>Input option</strong></td><td>Choose how to provide geometry and line data:<br><strong>Standard Conductor Data:</strong> Specify data directly with the Conductor data option.<br><strong>Conductor Data for Line Rebuilt:</strong> Rebuild (Line Rebuild) from electrical parameters.</td></tr><tr><td valign="top"><strong>Number of conductors</strong></td><td>Select the number of conductors in the system.</td></tr><tr><td valign="top"><strong>Conductor data table</strong></td><td>For each wire<br><strong>Wire :</strong> Wire number.<br><strong>Phase number:</strong> Phase number to which the conductor belongs. Conductors with the same phase number are electrically connected (e.g., bundles). Phase numbers must be 1, 2, 3, …, N with no gaps. Use phase number 0 for a ground wire that is not considered separately.<br><strong>DC resistance:</strong> DC resistance of the conductor in the specified unit (Ω/km or Ω/mi).<br><strong>Outside diameter:</strong> Outside diameter of the conductor (cm or in).<br><strong>Horizontal distance:</strong> Horizontal distance from the reference point x = 0 (m or ft).<br><strong>Vertical Height at tower (tower VH):</strong> Vertical height above ground at the tower (m or ft).<br><strong>Vertical Height at Midspan (VH</strong><sub><strong>mid</strong></sub><strong>):</strong> Vertical height above ground at midspan (m or ft). When both VH<sub>tower</sub> and VH<sub>mid</sub> are specified, the average height is <span class="math">VH_{average} = \frac{2×VH_{mid} + VH_{tower}}{3}</span></td></tr><tr><td valign="top"><strong>Additional data for Wire</strong></td><td>Specify the following data for each selected wire.</td></tr><tr><td valign="top"><strong>Skin effect correction</strong></td><td>Consider the skin effect correction of an equivalent tubular conductor. See Reactance model data:<br><strong>Thick/Diam:</strong> Thickness/Diameter (T/D) factor; must be ≤ 0.5.<br><strong>None:</strong> Neglect skin effect correction.<br><strong>Solid conductor:</strong> Assume a solid conductor.<br><strong>Galloway‑Wedephol:</strong> Use Galloway‑Wedepohl’s correction formula for stranded conductors. Available only for Line Parameters. See “Permeability of outer strand” section</td></tr><tr><td valign="top"><strong>Bundled conductor</strong></td><td>Specify a symmetrical bundle :<br><img src="https://3623212549-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLxgTpoh7kyPmQ5vuyqD7%2Fuploads%2Fgit-blob-77d22edf5b4ee712d69502bdd66740abb9ec9069%2Fimage%20(407).png?alt=media" alt="" data-size="original"><br><strong>Number of conductors in the bundle:</strong> Number of conductors in the bundle.<br><strong>Spacing (cm):</strong> Spacing (SEPAR) between adjacent conductors in the bundle (cm or in).<br><strong>Angular position:</strong> Angular position (ALPHA) of a bundle conductor. Positive angles are counter‑clockwise.</td></tr><tr><td valign="top"><strong>Reactance model data</strong></td><td><p>Select the model used to calculate conductor internal inductance. By default, internal inductance is corrected for skin effect assuming tubular geometry. Alternatives are available without this correction.<br><strong>Relative permeability:</strong> Standard case used in Line Model and Line Parameters. Internal reactance is calculated and corrected for skin effect assuming tubular conductor geometry.<br><strong>Permeability of outer strand:</strong> For Galloway‑Wedepohl equation on stranded conductors. Specify the relative permeability μ<sub>r</sub> of the outer strand and the number of outer strands. Available only with Line Parameters.<br><strong>Reactance for unit spacing:</strong> Assume reactance (not inductance) remains constant regardless of frequency. Units: Ω/km (Metric) or Ω/mile (English). Unit spacing: 1 m (Metric) or 1 ft (English). Available only with Line Parameters. “1‑foot spacing” refers to a GMD of 1 ft with GMR in feet.<br><strong>Reactance for unit spacing at 60 Hz:</strong> Unlike the previous case, where the reactance is assumed to remain constant, the inductance is assumed to remain fixed at its 60 Hz value. If frequencies other than 60 Hz are specified in the frequency data, the reactance is adjusted proportionally. This option is available only when using <strong>Line Parameters</strong>.</p><p>Note that the relationship between the reactances for 1-foot spacing and the geometric mean radius (GMR) is given by:<span class="math">X_{1\text{-ft}(\text{ohm}/\text{mile})} = \frac{f(\text{Hz})}{100} \cdot 0.20223653 \log \left( \frac{12}{\text{GMR}(\text{inches})} \right)\\[8pt] X_{1\text{-ft}(\text{ohm}/\text{mile})} = 2 \omega \cdot 1.609344 \times 10^{-4} \log \left( \frac{12}{\text{GMR}(\text{inches})} \right)\\</span><br><strong>GMR:</strong> Geometric mean radius in cm (Metric) or inches (English). Available only with Line Parameters.<br><strong>GMR/r:</strong> Dimensionless ratio, where r is the outer radius. For solid conductors, GMR/r = 0.7788. Available only with Line Parameters</p></td></tr><tr><td valign="top"><strong>Line Rebuild option</strong></td><td>The conductor data specifies 60 Hz (or any specific frequency) zero and positive sequence impedances (R<sub>0</sub>, L<sub>0</sub>, C<sub>0</sub> and R<sub>1</sub>, L<sub>1</sub>, C<sub>1</sub>) instead of geometry. Optionally, provide the conductor’s DC resistance for improved accuracy. From these parameters, the module builds an equivalent balanced arrangement that matches the specified sequence parameters and estimates skin effect characteristics (better with DC resistance). The reconstructed line is assumed balanced and uses the generalized Clarke transformation. If DC resistance is set to 0, it is estimated automatically.</td></tr></tbody></table>
{% endtab %}

{% tab title="Model" %}

<table><thead><tr><th width="209.79998779296875" valign="top">Parameter</th><th>Description</th></tr></thead><tbody><tr><td valign="top"><strong>Select model</strong></td><td>Produce transmission line models for steady-state and time-domain studies:<br><strong>FD:</strong> Frequency‑dependent model.<br><strong>CP:</strong> Constant‑parameter model.<br><strong>Exact‑PI:</strong> Exact frequency‑domain representation at a given frequency (for steady‑state and frequency scan).<br><strong>Wideband:</strong> Wideband line model.</td></tr><tr><td valign="top"><strong>FD</strong></td><td><p>Generates data compatible with the FD line model for time‑domain and steady‑state solutions. Models distributed, frequency‑dependent R and L (skin effect and ground return); C is constant. Includes non‑zero constant shunt conductance G (default 0.2×10<sup>‑9</sup> S/km). Based on rational approximations of</p><p><span class="math">Z_c = \frac{\sqrt{R + j\omega L}}{\sqrt{G + j\omega C}}\\ A_p = e^{-\gamma \ell} \\ \gamma = \sqrt{(R + j\omega L)(G + j\omega C)}\\</span></p><p>ℓ is the line length, and R, L, C, G are per‑unit‑length parameters. Uses a constant real transformation matrix T<sub>i</sub> (Q) to relate phase and modal quantities.<br><strong>Real T</strong><sub><strong>i:</strong></sub> Approximates with a constant real transformation matrix over the modeling interval. The program can find the model frequency automatically, or you can specify it. Typical automatic values are ~500 Hz to 5 kHz (mean ~1000 Hz). The exact complex matrix is evaluated at one frequency, rotated and normalized; the imaginary part is discarded. Errors are shown in the Q‑Error table.<br><strong>Balanced line:</strong> Models a perfectly transposed line; averages diagonal and off‑diagonal elements of reduced phase matrices Z<sub>phase</sub> and Y<sub>phase</sub>. Uses the generalized Clarke transformation. Results are usually poorer than “Real T<sub>i</sub>” unless the line is actually transposed. Check the Q‑Error table.<br><strong>Double circuit line:</strong> For double‑circuit lines. Models two separate perfectly balanced circuits with only zero‑sequence coupling between circuits. Uses a special transformation matrix. Typically, “Real T<sub>i</sub>” gives better results unless the line closely matches the ideal condition. Check the Q‑Error table.<br><strong>Frequency range:</strong> Frequency band used to fit the characteristic impedance Z<sub>c</sub> and propagation function A<sub>p</sub>.</p></td></tr><tr><td valign="top"><strong>CP</strong></td><td>Assumes constant R, L, C calculated at “Model frequency.” L and C are distributed; R is lumped at R/4 (ends) and R/2 (middle). Shunt conductance G = 0. Frequency dependence is ignored; CP is robust, simple, fast, and suitable for first‑approximation analyses.<br><strong>Real T</strong><sub><strong>i</strong></sub><strong>:</strong> Computes a constant real transformation matrix at an automatically determined or user‑specified model frequency (procedure similar to FD).<br><strong>Balanced line:</strong> Models a perfectly transposed line using the generalized Clarke transformation. Frequency data applies only to modal parameters.<br><strong>Double circuit line:</strong> For double‑circuit lines. Two separate perfectly balanced circuits with only zero‑sequence coupling. Frequency data applies only to modal parameters.</td></tr><tr><td valign="top"><strong>Exact‑PI</strong></td><td>The Exact PI is not supported by HYPERSIM.</td></tr><tr><td valign="top"><strong>Wideband</strong></td><td>Models phase line parameters as complex, distributed, and frequency‑dependent. Specify the Frequency range for synthesizing the propagation function and characteristic impedance.<br><strong>Unbalanced line:</strong> Line is not continuously transposed.<br><strong>Balanced line:</strong> Phase series and shunt matrices are balanced by averaging diagonal and off‑diagonal terms.<br><strong>Double circuit line:</strong> For double‑circuit lines. Two separate perfectly balanced circuits; phase series and shunt matrices are balanced by averaging diagonal and off‑diagonal terms.<br><strong>Frequency range:</strong> Frequency band used to fit the line characteristic admittance and propagation function.</td></tr></tbody></table>
{% endtab %}

{% tab title="Line Length" %}

<table><thead><tr><th width="260.199951171875">Parameter</th><th>Description</th></tr></thead><tbody><tr><td><strong>Line length</strong></td><td>Line/cable length (km or miles).</td></tr><tr><td><strong>Ground return resistivity</strong></td><td>Ground resistivity (Ω·m).</td></tr><tr><td><strong>Ground wires are segmented</strong></td><td>Continuous ground wire: grounded at each tower and continuous between towers. Segmented: grounded at one tower and insulated at adjacent towers at both ends of the segmentation interval.</td></tr></tbody></table>
{% endtab %}

{% tab title="Output Options" %}

<table><thead><tr><th width="200.199951171875" valign="top">Parameter</th><th>Description</th></tr></thead><tbody><tr><td valign="top"><strong>Extra printout information level</strong></td><td>Print out extra informative messages in the output file</td></tr><tr><td valign="top"><strong>Rotate matrix T</strong><sub><strong>i</strong></sub></td><td><p>Rotate the modal transformation matrix to:</p><ul><li>Satisfy G<sub>m</sub> = 0 when G<sub>phase</sub> = 0, or</li><li>Minimize the imaginary part of T<sub>i</sub> elements.</li></ul></td></tr><tr><td valign="top"><strong>Extra output options</strong></td><td>Calculates modal parameters from exact phase-domain Z and Y at the specified frequency and prints T<sub>i</sub>. G is assumed zero for these calculations. Related check boxes are self‑explanatory.</td></tr><tr><td valign="top"><strong>Test sources for Q‑error indicators</strong></td><td><p>Defines sending‑end voltage sources for open‑circuit/short‑circuit Q‑Error tests:</p><ul><li>In the open circuit test, all the phases at the receiving end of the line are open.</li><li>In the short circuit test, all the phases at the receiving end of the line are short circuited.</li></ul><p>The Q‑Error table indicates errors when using a constant real Q (T<sub>i</sub>) instead of the exact complex matrix. If not specified, defaults are:</p><p>Percent errors correspond to the phase with the largest error at a given frequency. The Q‑Error table is qualitative and excludes voltages/currents smaller than 5% of the largest values.</p></td></tr><tr><td valign="top"><strong>Override default test</strong></td><td>Specify per‑phase sending‑end voltage amplitude and phase to replace defaults.</td></tr></tbody></table>
{% endtab %}

{% tab title="Options" %}

<table><thead><tr><th width="220.199951171875">Parameter</th><th>Description</th></tr></thead><tbody><tr><td><strong>Transposition</strong></td><td>Produce a model for transposed lines by averaging series impedance and shunt admittance matrices. Valid only when each transposition section is much shorter than the signal wavelength. The sum of section lengths must equal the “Line length.” No automatic check on phase sequence.</td></tr><tr><td><strong>Create a transposed line</strong></td><td>Enable transposed line modeling.</td></tr><tr><td><strong>Number of transposition sections</strong></td><td>Enter the number of sections and the span length for each section.</td></tr><tr><td><strong>Phase sequence</strong></td><td>Phase sequence in each section. Phase numbers are defined in Conductor Data.</td></tr><tr><td><strong>Phase Shunt conductance</strong></td><td>Override the internal default G = 0.2×10<sup>‑9</sup> S/km (for models that assume non‑zero G). Specify diagonal elements of the reduced G<sub>phase</sub> matrix; off‑diagonal elements are zero. A value of 0 uses the default.</td></tr><tr><td><strong>Override default G</strong></td><td>Specify per‑phase G in S/km or S/miles.</td></tr></tbody></table>
{% endtab %}

{% tab title="Fitting" %}
Options available only for FD line models.

<table data-search="false"><thead><tr><th width="201">Parameter</th><th>Description</th></tr></thead><tbody><tr><td><strong>Extra printout information level</strong></td><td>Print extra informative messages in the output file.</td></tr><tr><td><strong>Quick fit</strong></td><td>Use fewer iterations during fitting of Z<sub>c</sub> and A<sub>p</sub>. May reduce accuracy.</td></tr><tr><td><strong>Maximum number of poles</strong></td><td>Maximum poles during fitting. Default: 25.</td></tr><tr><td><strong>Extra dynamics</strong></td><td>Add poles/zeros to improve low‑frequency approximation of A<sub>p</sub>. Improves accuracy for very short lines (e.g., breaker reignition) and very low‑frequency conditions (e.g., trapped charge).</td></tr><tr><td><strong>Print comparison table for Z</strong><sub><strong>c</strong></sub><strong> and A</strong><sub><strong>p</strong></sub></td><td>Include a comparison table of functions and their rational approximations.</td></tr><tr><td><strong>Printer plot</strong></td><td>Include plots comparing functions and approximations.</td></tr><tr><td><strong>Print poles and zeros</strong></td><td>Include tables of poles and zeros of the rational approximations of Z<sub>c</sub> and A<sub>p</sub>, RC equivalents for Z<sub>c</sub>, and time‑domain exponential representations.</td></tr></tbody></table>
{% endtab %}

{% tab title="Save and run this case" %}

<table><thead><tr><th width="200.199951171875" valign="top">Parameter</th><th>Description</th></tr></thead><tbody><tr><td valign="top"><strong>Current Case Data File name</strong></td><td><p>Enter a unique name to save the model.<br>Before running, provide a Case Data File identification (model ID and device name). The Line Data Calculation program generates a model data file. Usage:</p><ul><li>CP m‑phase: load generated model data with “Load data from file.”</li><li>FD m‑phase: select the model data file directly in the device forms.</li><li>WB line: select model data in the WB fitter to generate line data.</li></ul></td></tr><tr><td valign="top"><strong>Run this case to create a model data file for the selected line model</strong></td><td>Generate line model data. On OK, HYPERSIM runs the LINE DATA calculation to generate line data.</td></tr></tbody></table>
{% endtab %}
{% endtabs %}

## Inputs

This block has no inputs.

## Outputs

This block has no outputs.

## Example 3‑phase transmission line

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

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

FD‑line model for a 3‑phase system with:

* Metric units
* Conductor data specified directly
* 8 conductors total: 2 tubular per phase and 2 solid ground wires

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

<figure><img src="https://3623212549-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLxgTpoh7kyPmQ5vuyqD7%2Fuploads%2Fgit-blob-212751daab3a7150c987191cd0b91bd0aa37baad%2Fimage%20(413).png?alt=media" alt=""><figcaption><p>The complete view of conductor data</p></figcaption></figure>

Ground wires (phase 0) do not appear in the model data. Wires with the same phase number are counted as one. The generated model has 3 wires (3 modes).


---

# 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/line-data.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.
