Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
31 commits
Select commit Hold shift + click to select a range
df595d5
test(architecture): admit callable formulas and one-letter symbols
amaurigmartins Oct 30, 2026
92bff2e
refactor(engine): hold the path in the integral and add the family mean
amaurigmartins Oct 30, 2026
8b74304
refactor(engine): make the laws and the cable formulas callable
amaurigmartins Oct 30, 2026
4a00d42
refactor(engine): write the earth return in the form of the paper
amaurigmartins Oct 30, 2026
0d4a227
refactor(engine): give the earth slots domains and every slot a router
amaurigmartins Oct 30, 2026
ace82c5
docs(engine): document the formula layer
amaurigmartins Oct 30, 2026
39256da
fix(engine): return one complex type from the direct and image mean
amaurigmartins Oct 30, 2026
3cde7b5
feat(engine): admit a layered earth in both formulations
amaurigmartins Oct 31, 2026
5ad1413
fix(fem): keep the full air PML when a conductor is in air
amaurigmartins Oct 31, 2026
ef6bf74
feat(engine): add the lossy dielectric law
amaurigmartins Oct 31, 2026
2b5033e
feat(engine): add the surface impedances of Wedepohl and Wilcox
amaurigmartins Oct 31, 2026
519dc76
feat(engine): add the soil laws of frequency dependence
amaurigmartins Oct 31, 2026
53937f4
refactor(engine): rename the vacuum constants to ε₀ and μ₀
amaurigmartins Oct 31, 2026
720b4cc
feat(engine): add the equivalent earths of a layered model
amaurigmartins Oct 31, 2026
d9df089
feat(engine): add the closed forms of the earth return
amaurigmartins Oct 31, 2026
ab6b1b9
feat(engine): add the mixed forms of the earth return
amaurigmartins Oct 31, 2026
8457744
feat(engine): add the formulation block and the domain tags
amaurigmartins Oct 31, 2026
7cfee2c
feat(engine): add the earth return of Carson
amaurigmartins Nov 1, 2026
de0062c
feat(engine): add the earth return of Pollaczek
amaurigmartins Nov 1, 2026
576ad74
feat(engine): add the earth return of Papadopoulos
amaurigmartins Nov 1, 2026
ef38dfc
feat(engine): add the earth returns of Wise
amaurigmartins Nov 1, 2026
7fbd023
feat(engine): add the complete field of Xue
amaurigmartins Nov 1, 2026
c65c9df
refactor(engine): read the layers and the media terms once
amaurigmartins Nov 1, 2026
50a6544
refactor(engine): rename the dielectric fields of the input
amaurigmartins Nov 2, 2026
36b6ff6
refactor(engine): remove two unused arguments
amaurigmartins Nov 2, 2026
9518a5f
docs(site): describe the formulas of 0.2.0 and set the version
amaurigmartins Nov 2, 2026
7aa5319
fix(docs): admit the version 0.2 of the package in the docs
amaurigmartins Nov 2, 2026
98582f7
chore(release): merge the GetDP supply of main
amaurigmartins Nov 2, 2026
e08aeed
chore(release): merge the compat lines and the FEM fix of main
amaurigmartins Nov 2, 2026
e3f0c7e
test(engine): add the FEM row of the equivalent earth of Xue
amaurigmartins Nov 2, 2026
4dc0a35
chore(release): set the version to 0.1.0
amaurigmartins Nov 2, 2026
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion .github/workflows/CI.yml
Original file line number Diff line number Diff line change
Expand Up @@ -3,19 +3,19 @@
push:
branches:
- main
- release/v0.1.0
- release/v0.1.0-engine
tags: ['*']
pull_request:
workflow_dispatch:
concurrency:
# Skip intermediate builds: always.
# Cancel intermediate builds: only if it is a pull request build.

Check warning on line 12 in .github/workflows/CI.yml

View workflow job for this annotation

GitHub Actions / Writing

Prefer 'ask for' over 'request'.

Check warning on line 12 in .github/workflows/CI.yml

View workflow job for this annotation

GitHub Actions / Writing

Prefer 'ask for' over 'request'.
group: ${{ github.workflow }}-${{ github.ref }}
cancel-in-progress: ${{ startsWith(github.ref, 'refs/pull/') }}
jobs:
test:
if: ${{ !contains(github.event.head_commit.message, 'skip ci') }}
name: Julia ${{ matrix.version }} - ${{ matrix.os }}

Check warning on line 18 in .github/workflows/CI.yml

View workflow job for this annotation

GitHub Actions / Writing

STE: noun cluster longer than three words. Break it with a preposition. STE.NounClusters

Check warning on line 18 in .github/workflows/CI.yml

View workflow job for this annotation

GitHub Actions / Writing

STE: noun cluster longer than three words. Break it with a preposition. STE.NounClusters
runs-on: ${{ matrix.os }}
timeout-minutes: 60
permissions: # The Julia cache step deletes the old caches that it created.
Expand Down Expand Up @@ -65,7 +65,7 @@
- uses: julia-actions/setup-julia@v3
with:
version: '1.12'
- name: Install into an empty depot, without and with the extensions

Check warning on line 68 in .github/workflows/CI.yml

View workflow job for this annotation

GitHub Actions / Writing

STE: 'Install into' drops the article. Write 'the' or 'a' before the noun. STE.Articles

Check warning on line 68 in .github/workflows/CI.yml

View workflow job for this annotation

GitHub Actions / Writing

STE: 'Install into' drops the article. Write 'the' or 'a' before the noun. STE.Articles
shell: bash
run: |
set -euo pipefail
Expand Down
2 changes: 1 addition & 1 deletion CITATION.cff
Original file line number Diff line number Diff line change
Expand Up @@ -3,7 +3,7 @@ message: "If you use LineCableModels.jl, please cite this software."
title: "LineCableModels.jl"
type: software
version: 0.1.0
date-released: 2026-10-29
date-released: 2026-11-02
authors:
- family-names: Martins
given-names: Amauri
Expand Down
18 changes: 13 additions & 5 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -23,19 +23,27 @@ arrangements of underground and overhead power cables, with uncertainty propagat
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
based on the surface impedances of Schelkunoff and on the general formulation of Ametani,
with conductor resistivities corrected to the operating temperature.
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 in homogeneous earth, computed by a
unified formulation with a prescribed longitudinal wavenumber.
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 `@formulation` writes 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 the same result.
and GetDP. Both return a `LineParameters` record.
- **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](https://github.com/JuliaPhysics/Measurements.jl) package.
Expand Down
259 changes: 259 additions & 0 deletions docs/src/bibliography.bib
Original file line number Diff line number Diff line change
Expand Up @@ -58,6 +58,13 @@ @ARTICLE{5437464
doi={10.1109/TPWRD.2009.2034797}
}

@unpublished{MartinsBritto2026,
title = {Earth Return Theory of Solid Conductors in Homogeneous Media and Quasi-TEM Propagation, Part I: Analytical Formulation},
author = {{Martins-Britto}, Amauri G. and Chrysochos, Andreas I. and Papadopoulos, Theofilos A.},
year = 2026,
note = {Manuscript in preparation}
}

@article{MartinsBritto2024,
title = {Transient {{Electromagnetic Interference}} between {{Overhead}} and {{Underground Conductors}}},
author = {{Martins-Britto}, Amauri G. and Papadopoulos, Theofilos A. and Chrysochos, Andreas I.},
Expand Down Expand Up @@ -104,3 +111,255 @@ @article{Ciuprina2024
year = {2024},
doi = {10.1186/s13362-024-00165-6}
}

@article{Wedepohl1973,
title = {Transient Analysis of Underground Power-Transmission Systems: System-Model and Wave-Propagation Characteristics},
author = {Wedepohl, L. M. and Wilcox, D. J.},
year = 1973,
journal = {Proceedings of the Institution of Electrical Engineers},
volume = {120},
number = {2},
pages = {253--260},
doi = {10.1049/piee.1973.0056}
}

@article{Alipio2014,
title = {Modeling the Frequency Dependence of Electrical Parameters of Soil},
author = {Alipio, R. and Visacro, S.},
year = 2014,
journal = {IEEE Transactions on Electromagnetic Compatibility},
volume = {56},
number = {5},
doi = {10.1109/TEMC.2014.2313977}
}

@techreport{CIGRE2019,
title = {Impact of Soil-Parameter Frequency Dependence on the Response of Grounding Electrodes and on the Lightning Performance of Electrical Systems},
author = {{CIGRE WG C4.33}},
year = 2019,
institution = {CIGRE},
type = {Technical Brochure},
number = {781}
}

@article{Datsios2019,
title = {Characterization of the Frequency Dependence of the Electrical Properties of Sandy Soil With Variable Grain Size and Water Content},
author = {Datsios, Z. G. and Mikropoulos, P. N.},
year = 2019,
journal = {IEEE Transactions on Dielectrics and Electrical Insulation},
volume = {26},
number = {3},
doi = {10.1109/TDEI.2018.007864}
}

@techreport{Longmire1975,
title = {A Universal Impedance for Soils},
author = {Longmire, C. L. and Smith, K. S.},
year = 1975,
institution = {Defense Nuclear Agency}
}

@techreport{Messier1985,
title = {Another Soil Conductivity Model},
author = {Messier, M.},
year = 1985,
institution = {JAYCOR},
address = {Santa Barbara}
}

@inproceedings{Portela1999,
title = {Measurement and Modeling of Soil Electromagnetic Behavior},
author = {Portela, C. M.},
year = 1999,
booktitle = {IEEE International Symposium on Electromagnetic Compatibility},
pages = {1004--1009}
}

@article{Scott1967,
title = {Dielectric Constant and Electrical Conductivity Measurements of Moist Rock: A New Laboratory Method},
author = {Scott, J. H. and Carroll, R. D. and Cunningham, D. R.},
year = 1967,
journal = {Journal of Geophysical Research},
volume = {72},
number = {20},
doi = {10.1029/JZ072i020p05101}
}

@inproceedings{Visacro1987,
title = {Soil Permittivity and Conductivity Behavior on Frequency Range of Transient Phenomena in Electric Power Systems},
author = {Visacro, S. and Portela, C. M.},
year = 1987,
booktitle = {International Symposium on High Voltage Engineering}
}

@article{Visacro2012,
title = {Frequency Dependence of Soil Parameters: Experimental Results, Predicting Formula and Influence on the Lightning Response of Grounding Electrodes},
author = {Visacro, S. and Alipio, R.},
year = 2012,
journal = {IEEE Transactions on Power Delivery},
volume = {27},
number = {2},
doi = {10.1109/TPWRD.2011.2179070}
}

@article{Pascoalato2022,
title = {A Comparison of Frequency-Dependent Soil Models: Electromagnetic Transient Analysis of Overhead Transmission Lines Using Modal Decomposition},
author = {Pascoalato, T. F. G. and de Araújo, A. R. J. and Colqui, J. S. L. and Kurokawa, S. and Pissolato Filho, J.},
year = 2022,
journal = {Energies},
volume = {15},
number = {5},
pages = {1687},
doi = {10.3390/en15051687}
}

@inproceedings{Pascoalato2021,
title = {Analysis of Transient Voltages and Currents in Short Transmission Lines on Frequency-Dependent Soils},
author = {Pascoalato, T. F. G. and de Araújo, A. R. J. and Kurokawa, S. and Pissolato Filho, J.},
year = 2021,
booktitle = {International Conference on Power Systems Transients},
address = {Belo Horizonte, Brazil}
}

@article{MartinsBritto2020,
title = {Multilayer Earth Structure Approximation by a Homogeneous Conductivity Soil for Ground Return Impedance Calculations},
author = {Martins-Britto, A. G. and Lopes, F. V. and Rondineau, S. R. M. J.},
year = 2020,
journal = {IEEE Transactions on Power Delivery},
volume = {35},
number = {2},
pages = {881--891},
doi = {10.1109/TPWRD.2019.2930406}
}

@article{Xue2021,
title = {Generalized Formulation and Surge Analysis on Overhead Lines: Impedance/Admittance of a Multi-Layer Earth},
author = {Xue, H. and Mahseredjian, J. and Ametani, A. and Morales, J. and Kocar, I.},
year = 2021,
journal = {IEEE Transactions on Power Delivery},
volume = {36},
number = {6},
pages = {3834--3845},
doi = {10.1109/TPWRD.2021.3049595}
}

@article{Gary1976,
title = {Approche Compl{\`e}te de la Propagation Multifilaire en Haute Fr{\'e}quence par Utilisation des Matrices Complexes},
author = {Gary, C.},
year = 1976,
journal = {EDF Bulletin de la Direction des {\'E}tudes et Recherches, S{\'e}rie B},
number = {3/4},
pages = {5--20}
}

@article{Deri1981,
title = {The Complex Ground Return Plane: A Simplified Model for Homogeneous and Multi-Layer Earth Return},
author = {Deri, A. and Tevan, G. and Semlyen, A. and Castanheira, A.},
year = 1981,
journal = {IEEE Transactions on Power Apparatus and Systems},
volume = {PAS-100},
number = {8},
pages = {3686--3693},
doi = {10.1109/TPAS.1981.317011}
}

@article{Saad1996,
title = {A Closed-Form Approximation for Ground Return Impedance of Underground Cables},
author = {Saad, O. and Gaba, G. and Giroux, M.},
year = 1996,
journal = {IEEE Transactions on Power Delivery},
volume = {11},
number = {3},
pages = {1536--1545},
doi = {10.1109/61.517514}
}

@inproceedings{Lucca1994,
title = {Mutual Impedance between an Overhead and a Buried Line with Earth Return},
author = {Lucca, G.},
year = 1994,
booktitle = {9th International Conference on Electromagnetic Compatibility},
address = {Manchester, UK},
pages = {80--86},
doi = {10.1049/cp:19940679}
}

@article{Ametani2009,
title = {An Investigation of Earth-Return Impedance Between Overhead and Underground Conductors and Its Approximation},
author = {Ametani, A. and Yoneda, T. and Baba, Y. and Nagaoka, N.},
year = 2009,
journal = {IEEE Transactions on Electromagnetic Compatibility},
volume = {51},
number = {3},
pages = {860--867},
doi = {10.1109/TEMC.2009.2019953}
}

@article{Carson1926,
title = {Wave Propagation in Overhead Wires with Ground Return},
author = {Carson, J. R.},
year = 1926,
journal = {Bell System Technical Journal},
volume = {5},
number = {4},
pages = {539--554},
doi = {10.1002/j.1538-7305.1926.tb00122.x}
}

@article{Pollaczek1926,
title = {{\"U}ber das Feld einer unendlich langen wechselstromdurchflossenen Einfachleitung},
author = {Pollaczek, F.},
year = 1926,
journal = {Elektrische Nachrichtentechnik},
volume = {3},
number = {9},
pages = {339--359}
}

@article{Papadopoulos2010,
title = {Impedances and {{Admittances}} of {{Underground Cables}} for the {{Homogeneous Earth Case}}},
author = {Papadopoulos, Theofilos A. and Tsiamitros, Dimitrios A. and Papagiannis, Grigoris K.},
year = 2010,
month = apr,
journal = {IEEE Transactions on Power Delivery},
volume = {25},
number = {2},
pages = {961--969},
doi = {10.1109/TPWRD.2009.2034797}
}

@article{Wise1934,
title = {Propagation of {{High-Frequency Currents}} in {{Ground Return Circuits}}},
author = {Wise, W.H.},
year = 1934,
month = apr,
journal = {Proceedings of the IRE},
volume = {22},
number = {4},
pages = {522--527},
doi = {10.1109/JRPROC.1934.225868}
}

@article{Wise1948,
title = {Potential {{Coefficients}} for {{Ground Return Circuits}}},
author = {Wise, W. Howard},
year = 1948,
month = apr,
journal = {Bell System Technical Journal},
volume = {27},
number = {2},
pages = {365--371},
doi = {10.1002/j.1538-7305.1948.tb00913.x}
}

@article{XueEtAl2018,
title = {Generalized {{Formulation}} of {{Earth-Return Impedance}}/{{Admittance}} and {{Surge Analysis}} on {{Underground Cables}}},
author = {Xue, Haoyan and Ametani, Akihiro and Mahseredjian, Jean and Kocar, Ilhan},
year = 2018,
month = dec,
journal = {IEEE Transactions on Power Delivery},
volume = {33},
number = {6},
pages = {2654--2663},
doi = {10.1109/TPWRD.2018.2796089}
}
Loading
Loading