LineCableModels.jl is a Julia package for computing the series impedances and shunt admittances per unit length of arbitrary
arrangements of underground and overhead power cables, with uncertainty propagation. A computation is defined by a problem, which describes the cables, the earth, the operating temperature and the frequencies of interest, and by a formulation, which selects the formulas for each physical contribution. The computation is carried out either by the coaxial analytical backend of the package or by the finite-element backend of the Gmsh extension.
- High-fidelity cable modeling: Detailed representation of solid and stranded conductors, with round wires or rectangular strands laid on helices, semicon screens, insulation layers, sheaths, beddings, armors of round wires, jackets and fillers. Any number of cables can be placed in the same cross-section to form a cable system.
- Equivalent tubular representation: Each terminal of a cable is represented by an equivalent tubular conductor that preserves the DC resistance and the geometric mean radius of its regions, including the overlength of the round wires and rectangular strands laid on helices. The relative permeability of the insulation layers is corrected to account for the solenoid effect introduced by the helical path of the current in stranded conductors.
- Internal impedances and admittances: Internal impedances of multilayered coaxial cables by the general formulation of Ametani. The surface impedances of the conductors follow Schelkunoff or Wedepohl and Wilcox, and their resistivities follow the operating temperature.
- Lossy dielectrics: The admittivity of an insulation or semicon layer includes its conduction and polarization loss when the formulation selects the lossy law.
- Earth-return impedances and admittances: Earth-return impedances and potential coefficients of underground, overhead and mixed systems, computed by a unified formulation with a prescribed longitudinal wavenumber.
- Classical earth-return formulas: Carson, Pollaczek, Wise, Gary, Wedepohl and Wilcox,
Saad, Papadopoulos, Xue, Lucca and Ametani, selected per domain of a pair of cables.
The macro
@formulationwrites a selection per domain as a block. - Earth models: Layered earth models, with nine soil laws for the frequency dependence of each layer and two models of an equivalent homogeneous earth.
- Phase-domain matrices: Series impedance and shunt admittance matrices of polyphase systems with any number of conductors per phase, with bundling of bonded conductors, Kron elimination of grounded conductors and ideal transposition.
- Analytical and FEM solutions: The same problem is solved by the analytical coaxial
formulation of the package, which combines the closed-form internal impedances of the
tubular conductors with the earth-return integrals, or by the finite-element backend, which
solves the field equations on a mesh of the actual cross-section of the cables with Gmsh
and GetDP. Both return a
LineParametersrecord. - Uncertainty quantification: Linear propagation of the uncertainties of materials, dimensions, positions, earth properties and temperature to the line parameters, by means of the Measurements.jl package.
Add the registered package to the Julia environment:
pkg> add LineCableModelsThen, in your Julia code, import the package:
using LineCableModelsThe extension modules are loaded with the packages they build on, as described below.
The following example computes the line parameters of two insulated copper wires, buried at 1 m depth with a horizontal spacing of 1 m, in a homogeneous earth of 100 Ω·m:
using LineCableModels
copper = Material(:conductor, 1.7241e-8, 1, 1, 20, 0.00393)
polyethylene = Material(:insulator, 1.0e14, 2.3)
wire = @cable "insulated_wire" begin
@terminal :core begin
core(copper; r = 4.0e-3) # [m]
end
insulation(polyethylene; t = 1.0e-3) # [m]
end
system = build(CableSystem, [wire, wire], [Placement(0.0, -1.0), Placement(1.0, -1.0)];
connections = [(core = 1,), (core = 2,)], id = "two_wires", line_length = 1000.0)
problem = LineParametersProblem(system, homogeneous(rho = 100.0);
frequencies = [50.0, 1e3, 1e6]) # [Hz]
result = compute(problem, CoaxialFormulation())
result.Z[:, :, 1] # [Ω/m] at 50 Hz
result.terminalsLineCableModels.jl provides extension modules that load with the packages they build on and add a backend or a number type to the same problems and results.
Finite-element capabilities are introduced with using Gmsh, getdp_jll, which loads the
finite-element extension. Gmsh.jl provides the Gmsh library that meshes the cross-section,
and getdp_jll provides the GetDP 3.5.0 executable that solves the field equations in complex
arithmetic. A build of your own is selected through getdp_jll's getdp_path preference,
and the same problem is computed by compute(problem, FEM()). The
finite-element guide describes the options of the backend, its run directory and
its accuracy on the reference systems.
Uncertainty quantification is introduced with using Measurements. Any input of the problem
can then be given as an uncertain value, such as Circle(4.0e-3 ± 1.0e-5). The resulting Z
and Y have uncertain real and imaginary parts, which the extension propagates linearly
through every formula. The uncertainty quantification guide describes the propagation and the
tests that verify it.
See the full documentation for detailed usage instructions, technical background and examples.
Contributions are welcome. CONTRIBUTING.md gives the principles, the checks and the form of a pull request, and the developer section of the documentation describes the architecture, the rules and the conventions.
The source code is provided under the BSD 3-Clause License.
This work is supported by the Etch Competence Hub of EnergyVille, financed by the Flemish Government. The primary developer is Amauri Martins (@amaurigmartins).