Line#
( Circuit Element, PD Element )
EPRI’s OpenDSS Documentation for this component: https://opendss.epri.com/Line.html
# 
Name 
Type 
Default 
Units 
Description 

1 

string 
Name of bus to which first terminal is connected. 

2 

string 
Name of bus to which 2nd terminal is connected. 

3 

string 
Name of linecode object describing line impedances. 

4 

real 
Length of line. If units do not match the impedance data, specify “units” property. 

5 

integer 
3 
Number of phases, this line. 

6 

real 
Ω/[length_unit] 
Positivesequence Resistance. Setting any of R1, R0, X1, X0, C1, C0 forces the program to use the symmetrical component line definition. See also Rmatrix. 

7 

real 
Ω/[length_unit] 
Positivesequence Reactance. Setting any of R1, R0, X1, X0, C1, C0 forces the program to use the symmetrical component line definition. See also Xmatrix 

8 

real 
Ω/[length_unit] 
Zerosequence Resistance. Setting any of R1, R0, X1, X0, C1, C0 forces the program to use the symmetrical component line definition. 

9 

real 
Ω/[length_unit] 
Zerosequence Reactance. Setting any of R1, R0, X1, X0, C1, C0 forces the program to use the symmetrical component line definition. 

10 

real 
nF/[length_unit] 
Positivesequence capacitance. Setting any of R1, R0, X1, X0, C1, C0 forces the program to use the symmetrical component line definition. See also Cmatrix and B1. 

11 

real 
nF/[length_unit] 
Zerosequence capacitance. Setting any of R1, R0, X1, X0, C1, C0 forces the program to use the symmetrical component line definition.See also B0. 

12 

array of reals 
Ω/[length_unit] 
Resistance matrix, lower triangle. Order of the matrix is the number of phases. May be used to specify the impedance of any line configuration. Using any of Rmatrix, Xmatrix, Cmatrix forces program to use the matrix values for line impedance definition. For balanced line models, you may use the standard symmetrical component data definition instead. 

13 

array of reals 
Ω/[length_unit] 
Reactance matrix, lower triangle. Order of the matrix is the number of phases. May be used to specify the impedance of any line configuration. Using any of Rmatrix, Xmatrix, Cmatrix forces program to use the matrix values for line impedance definition. For balanced line models, you may use the standard symmetrical component data definition instead. 

14 

array of reals 
nF/[length_unit] 
Nodal Capacitance matrix, lower triangle. Order of the matrix is the number of phases. May be used to specify the shunt capacitance of any line configuration. Using any of Rmatrix, Xmatrix, Cmatrix forces program to use the matrix values for line impedance definition. For balanced line models, you may use the standard symmetrical component data definition instead. 

15 

boolean 
False 
Designates this line as a switch for graphics and algorithmic purposes. 

16 

real 
0.018 
Ω/[length_unit] 
Carson earth return resistance per unit length used to compute impedance values at base frequency. Default is 0.01805 = 60 Hz value in ohms per kft (matches default line impedances). This value is required for harmonic solutions if you wish to adjust the earth return impedances for frequency. If not, set both Rg and Xg = 0. 
17 

real 
0.155 
Ω/[length_unit] 
Carson earth return reactance per unit length used to compute impedance values at base frequency. For making better frequency adjustments. Default is 0.155081 = 60 Hz value in ohms per kft (matches default line impedances). This value is required for harmonic solutions if you wish to adjust the earth return impedances for frequency. If not, set both Rg and Xg = 0. 
18 

real 
100.0 
Ωm 
Earth resistivity used to compute earth correction factor. Overrides Line geometry definition if specified. 
19 

string 
Geometry code for LineGeometry Object. Supersedes any previous definition of line impedance. Line constants are computed for each frequency change or rho change. CAUTION: may alter number of phases. You cannot subsequently change the number of phases unless you change how the line impedance is defined. 

20 

string 
none 
Length Units. Default is None  assumes length units match impedance units. 

21 

string 
Reference to a LineSpacing for use in a line constants calculation. 

22 

array of strings 
Array of WireData names for use in an overhead line constants calculation. 

23 

string 
Deri 
One of {Carson  FullCarson  Deri}. Default is the global value established with the Set EarthModel command. See the Options Help on EarthModel option. This is used to override the global value for this line. This option applies only when the “geometry” property is used. 

24 

array of strings 
Array of CNData names for use in a cable constants calculation. 

25 

array of strings 
Array of TSData names for use in a cable constants calculation. 

26 

real 
μS/[length_unit] 
Alternate way to specify C1. MicroS per unit length 

27 

real 
μS/[length_unit] 
Alternate way to specify C0. MicroS per unit length 

28 

integer 
Defines the number of ratings to be defined for the wire, to be used only when defining seasonal ratings using the “Ratings” property. 

29 

array of reals 
[400.0] 
An array of ratings to be used when the seasonal ratings flag is True. It can be used to insert 

30 

string 
oh 
Code designating the type of line. 

31 

real 
400.0 
Normal rated current. 

32 

real 
600.0 
Maximum or emergency current rating. 

33 

real 
0.1 
Failure rate PER UNIT LENGTH per year. Length must be same units as LENGTH property. Default is 0.1 fault per unit length per year. 

34 

real 
20.0 
Percent of failures that become permanent. 

35 

real 
3.0 
Hours to repair. 

36 

real 
Hz 
Base Frequency for ratings. 

37 

boolean 
True 
Indicates whether this element is enabled. 

38 

string 
Make like another object, e.g.: 
Sample links#
These are the top 20 sample files with occurrences of this DSS object.
# of occurrences 
Link 

3891 

3891 

3891 

2526 

2526 

2526 

2526 

1379 

1245 

1225 

1177 

1177 

1050 

867 

867 

646 

390 

320 

289 

289 
Links are provided to the dssextensions/electricdsssrc repository since there are some edits and fixes. Otherwise, these files should be available on the official OpenDSS SVN or in the OpenDSS application folder if your have a local installation.