Matrix formulation of line and cable parameters

LineCableModels calculates line and cable parameters by assembling the per-unit-length series-impedance matrix $\mathbf Z$ and shunt-admittance matrix $\mathbf Y$. These matrices contain the conductor self and mutual coefficients in the multiconductor transmission-line equations. They determine the propagation of voltages and currents along the line.

The matrix entries combine contributions from conducting materials, insulation and the external medium. Each contribution is evaluated with a selected formulation. Any formulation expressible in this framework can be incorporated with compatible conductor definitions, reference conventions and physical assumptions. The formulation sections linked below document the available equations and their domains of validity.

Transmission-line equations

At angular frequency $\omega$, with time dependence $e^{j\omega t}$, the multiconductor transmission-line equations are

\[\frac{\mathrm d\mathbf V}{\mathrm dx}=-\mathbf Z\mathbf I, \qquad \frac{\mathrm d\mathbf I}{\mathrm dx}=-\mathbf Y\mathbf V.\]

The coordinate $x$ measures distance along the line. The matrices $\mathbf Z$ and $\mathbf Y$ have units $\Omega/\mathrm m$ and $\mathrm S/\mathrm m$, respectively. Their order equals the number of retained electrical conductors [2, 7].

In the conductor representation, each component of $\mathbf V$ and $\mathbf I$ corresponds to one retained conductor. The same external reference is used for all voltages, and all currents are positive in the same longitudinal direction. Matrix indices enumerate conductors independently of their physical cross-sectional coordinates.

Sheaths and armor remain electrical conductors when retained in this representation. Bonding conditions, return-current constraints, and modal transformations are applied separately from parameter assembly.

Potential coefficients and shunt admittance

Shunt formulations often provide Maxwell potential coefficients rather than admittance entries. Under electrostatic, lossless-dielectric assumptions, the potential-coefficient matrix $\mathbf P$ relates conductor voltages to per-unit-length charges $\mathbf q$:

\[\mathbf V=\mathbf P\mathbf q, \qquad \mathbf C=\mathbf P^{-1}, \qquad \mathbf Y=j\omega\mathbf P^{-1}.\]

The units of $\mathbf P$ and $\mathbf C$ are $\mathrm m/\mathrm F$ and $\mathrm F/\mathrm m$, respectively. The admittance calculation requires the inverse of the complete potential-coefficient matrix [2, 7]. Matrix inversion couples the coefficients, so $Y_{jk}$ cannot be calculated as $j\omega/P_{jk}$.

The normalization of a shunt formulation determines the conversion to $\mathbf Y=\mathbf G+j\omega\mathbf C$ [8]. Under the charge-based, lossless definition above, $\mathbf P=j\omega\mathbf Y^{-1}$ for invertible matrices and $\omega\ne0$. The potential-coefficient matrix is distinct from an inverse-admittance matrix.

Physical contributions and formulation families

The formulation families correspond to the physical contributions required by the impedance and admittance calculations.

Physical contributionMatrix contributionFormulation section
Electromagnetic response inside conducting materialsLocal series response, including metallic surface and through-wall transfer impedancesConductors
Fields in insulation, jackets, and semiconducting regionsSeries-field contributions and local potential-coefficient or shunt contributionsDielectrics
Series fields outside the local cable assembliesExternal self and mutual impedances, including earth returnEarth return
Electric fields in the external mediumExternal potential coefficients used in the shunt-admittance calculationEarth return
Earth conductivity, permittivity, and their frequency dependenceMaterial inputs to the external-field formulationsEarth return

Each contribution has a selectable formulation. Formulations used together require compatible geometry and material properties. Their voltage references and current conventions must agree, as must their propagation assumptions.

A formulation may provide a scalar coefficient, a coupled block or a complete matrix. Its output must correspond to the physical contribution and conductor representation required by the assembly. An earth-return correction requires the associated geometric term to form a complete external impedance. Radial branch admittances and loop impedances require conversion before use in a conductor matrix. Contributions already included in one term must not be repeated in another.

Block matrix assembly

In the cylindrical construction considered here, each local unit consists of one round conductor or a concentric assembly of metallic conductors and dielectric regions. The shared regions comprise the air and earth outside the individual units. The following arbitrary-dimension notation reformulates the block patterns in [2, 7]. The cylindrical assumptions apply to this decomposition, rather than to the transmission-line matrix formulation itself.

Consider $m$ local units. Unit $j$ contains $N_j$ longitudinal metallic conductors, ordered from the center outward when the unit is coaxial. The conductor count is

\[n=\sum_{j=1}^{m}N_j.\]

A coaxial unit may contain a solid central conductor followed by any number of concentric annular conductors, separated by dielectric regions. The values of $N_j$ need not be identical across the installation.

Let $\mathbf B_j$ and $\mathbf D_j$ denote the local series-impedance and potential-coefficient blocks of unit $j$, respectively. Both have order $N_j$. Define

\[\mathbf B=\operatorname{blockdiag}(\mathbf B_1,\ldots,\mathbf B_m), \qquad \mathbf D=\operatorname{blockdiag}(\mathbf D_1,\ldots,\mathbf D_m).\]

Each local block contains the self and mutual coefficients of the conductors within its unit. The block-diagonal structure excludes interactions between different units from $\mathbf B$ and $\mathbf D$.

Current and charge aggregation

Define the conductor-membership matrix

\[\mathbf S=\operatorname{blockdiag} \left(\mathbf 1_{N_1},\ldots,\mathbf 1_{N_m}\right) \in\mathbb R^{n\times m},\]

where $\mathbf 1_{N_j}$ is a column of ones. Column $j$ identifies the conductors belonging to unit $j$. The total longitudinal current of each unit is

\[\mathbf J=\mathbf S^{\mathsf T}\mathbf I, \qquad J_j=\sum_{k=1}^{N_j}I_{j,k}.\]

The corresponding total per-unit-length charge is

\[\mathbf Q=\mathbf S^{\mathsf T}\mathbf q, \qquad Q_j=\sum_{k=1}^{N_j}q_{j,k}.\]

Under the cylindrical approximation, the shared-region formulations use $J_j$ and $Q_j$ as source amplitudes. Multiplication by $\mathbf S$ assigns the resulting voltage gradient or potential contribution to each conductor in the corresponding unit.

For a shared-region impedance matrix $\mathbf H_Z$ and potential-coefficient matrix $\mathbf H_P$, the conductor-matrix contributions are

\[\Delta\mathbf Z=\mathbf S\mathbf H_Z\mathbf S^{\mathsf T}, \qquad \Delta\mathbf P=\mathbf S\mathbf H_P\mathbf S^{\mathsf T}.\]

The same membership matrix applies to both quantities. For impedance, the block between units $j$ and $k$ is

\[\left(\mathbf S\mathbf H_Z\mathbf S^{\mathsf T}\right)_{jk} =(H_Z)_{jk}\mathbf 1_{N_j}\mathbf 1_{N_k}^{\mathsf T}.\]

The repeated coefficients result from representing each unit by its aggregate source amplitude [2, 7].

Angular current or charge distributions omitted by the cylindrical approximation require a more detailed coupled formulation. When that formulation couples several units, the coupled response must remain in the combined matrix rather than in independent local blocks.

Assembly

Let $\mathbf Z_{\mathrm{env}}$ and $\mathbf P_{\mathrm{env}}$ describe the shared medium outside the individual cable boundaries. The complete matrices are

\[\boxed{ \begin{aligned} \mathbf Z&=\mathbf B+\mathbf S\mathbf Z_{\mathrm{env}}\mathbf S^{\mathsf T},\\ \mathbf P&=\mathbf D+\mathbf S\mathbf P_{\mathrm{env}}\mathbf S^{\mathsf T}. \end{aligned} }\]

The local blocks contain the contributions within each unit. The external matrices contain the self and mutual contributions of the surrounding medium.

Under the lossless potential-coefficient convention,

\[\boxed{ \mathbf Y=j\omega \left(\mathbf D+\mathbf S\mathbf P_{\mathrm{env}}\mathbf S^{\mathsf T}\right)^{-1}. }\]

Inversion applies to the full sum. In general, independently inverting the local and external potential blocks and adding their admittances does not recover $\mathbf Y$.

The assembly in this release

The coaxial formulation fills the local blocks $\mathbf B_j$ and $\mathbf D_j$ of each cable with two methods. The loop recursion assembles the surface impedances of the conductors and the magnetic terms of the dielectric intervals into $\mathbf B_j$. The formula Shunt.Formula{:series} fills $\mathbf D_j$ by the series chain of the potential coefficients of the layers. The earth-return formula gives $\mathbf Z_{\mathrm{env}}$ and $\mathbf P_{\mathrm{env}}$, the matrices Zg and Pg by cable, as Earth return describes.

LineCableModels.Engine.impedance! — Method
impedance!(
    internal::LineCableModels.Engine.InternalImpedance.Formula,
    insulation::LineCableModels.Engine.InsulationImpedance.Formula,
    Zin::AbstractArray{Complex{T<:Real}, 2},
    input::LineCableModels.Engine.CoaxialInput{T<:Real, L} where L<:(AbstractArray{<:Material{T<:Real}, 1}),
    rho::AbstractArray{T<:Real, 1},
    s::Complex{T<:Real}
) -> AbstractArray{Complex{T}, 2} where T<:Real

Write into Zin the series impedances inside the cables, conductor by conductor, by the loop recursion of Ametani. In each concentric assembly, the current of a conductor returns through the conductor outside it, from the outermost conductor inward. Conductor $k$ has the loop impedance

\[z_k = z_{\mathrm{outer}, k} + z_{\mathrm{inner}, k + 1} + z_{\mathrm{insulation}, k},\]

where $z_{\mathrm{outer}, k}$ is the outer surface impedance of conductor $k$ and $z_{\mathrm{insulation}, k}$ is the term of its dielectric interval. The inner surface impedance of the next conductor outward is $z_{\mathrm{inner}, k + 1}$, zero for the outermost conductor. With the conductors of the assembly numbered $1, \ldots, n$ from the inside out, the loop impedances and the transfer impedances $z_{\mathrm{transfer}, k}$ give the entries

\[Z_{\mathrm{in}, ij} = \sum_{k = \max(i, j)}^{n} \left(z_k - \left([i < k] + [j < k]\right) z_{\mathrm{transfer}, k}\right),\]

where $[\cdot]$ is 1 when its condition holds and 0 otherwise. All impedance terms have units [Ω/m].

Arguments

  • internal: formula of the surface impedances of each conductor.
  • insulation: formula of the term of each dielectric interval.
  • Zin: destination matrix of internal impedances [Ω/m].
  • input: numerical input of the cables.
  • rho: resistivity [Ω·m] of each conductor at the operating temperature.
  • s: complex frequency, j 2π f, in [1/s].

Returns

  • Zin, its entries in [Ω/m].
source
LineCableModels.Engine.Shunt — Module
LineCableModels.Engine.Shunt

Compute the potential coefficients inside a cable from the admittivities of its layers.

Formulas

Formula{:series}

Potential coefficients inside a cable from the series combination of its annular dielectric layers [2, 7]. A layer $l$ between the radii $a_l$ and $b_l$ has the coefficient $p_l$, and the layers $\mathcal{L}_i$ in the interval of conductor $i$ add to its own coefficient $p_i$. In each concentric assembly, with the conductors numbered $1, \ldots, n$ from the inside out, the entry between conductors $i$ and $j$ sums the own coefficients of the conductors from the outer of the two to the outermost one:

\[p_l = \frac{s \ln(b_l / a_l)}{2 \pi \kappa_l}, \qquad p_i = \sum_{l \in \mathcal{L}_i} p_l, \qquad P_{\mathrm{in}, ij} = \sum_{k = \max(i, j)}^{n} p_k,\]

where $s$ is the complex frequency [1/s], $a_l$ and $b_l$ are in [m], $\kappa_l$ is the admittivity of the layer [S/m], and the coefficients are in [m/F]. A layer with $a_l = 0$ or $a_l = b_l$ has $p_l = 0$. Conductors of different assemblies have no entry in $\mathbf P_\mathrm{in}$.

source
LineCableModels.Engine.Shunt.Formula — Type
struct Formula{ID, O<:LineCableModels.Commons.FormulationOptions} <: LineCableModels.Engine.AbstractShunt

Represent a formula for the potential coefficients inside a cable. Its options form a record of type FormulationOptions{Formula{ID}}, with ID the formula identifier.

  • options::LineCableModels.Commons.FormulationOptions: Options of the formula.
source
LineCableModels.Engine.Shunt.Formula — Method
Formula(
    ::Val{ID};
    kw...
) -> LineCableModels.Engine.Shunt.Formula

Build the formula named by ID with its declared defaults and supplied options.

Arguments

  • Val{ID}: formula identifier from FORMULAS.

Keywords

  • kw...: options declared by defaults for Formula{ID}.

Returns

  • A Formula with a typed option record.

Errors

  • Throws ArgumentError for an unknown identifier or option.
source
LineCableModels.Engine.potential! — Method
potential!(
    _::LineCableModels.Engine.Shunt.Formula{:series},
    Pin::AbstractArray{Complex{T<:Real}, 2},
    input::LineCableModels.Engine.CoaxialInput{T<:Real, L} where L<:(AbstractArray{<:Material{T<:Real}, 1}),
    kappa::AbstractArray{Complex{T<:Real}, 1},
    s::Complex{T<:Real}
) -> AbstractArray{Complex{T}, 2} where T<:Real

Write into Pin the potential coefficients inside the cables, conductor by conductor, by the formula Formula{:series}, whose equations are in the section "Formulas" of Shunt.

Arguments

  • Formula{:series}: annular dielectric series-chain formula.
  • Pin: destination matrix of potential coefficients [m/F].
  • input: numerical input of the cables.
  • kappa: admittivity of each dielectric layer [S/m].
  • s: complex frequency, j 2π f, in [1/s].

Returns

  • Pin, its entries in [m/F].
source

Reductions

The reductions act on the assembled matrices in order. The bundle first merges the conductors that share a connection index, and the Kron elimination then removes the conductors at zero voltage. When selected, the ideal transposition acts on Z and Y after the admittance is computed.

LineCableModels.Engine.reductions — Function
reductions(
    system::CableSystem,
    options::LineCableModels.Commons.FormulationOptions
) -> NamedTuple{(:label, :bundles, :kept, :eliminated, :terminals), <:Tuple{Vector, Vector{Tuple{Int64, Int64}}, Vector{Int64}, Vector{Int64}, Vector}}

Return the plan of the bundle and Kron reductions of a system under the formulation's options. The plan lists the conductor indices of the reductions and the labels of the conductors and of the kept rows. The rows of the reduced matrices start with the first conductor of each conductor index k ≥ 1, in the order of the system. The other conductors of each index follow, and the conductors of index zero come last. With bundle, the reductions merge each of the other conductors into the first of its index and remove its row. With kron, they remove the rows of index zero.

Arguments

  • system: cable designs, placements, and conductor connections.
  • options: formulation options that select the bundle and Kron reductions.

Returns

  • label: label of each conductor, cable:<i>:<terminal>.
  • bundles: conductor pairs (first, other) to merge, empty when bundle is false.
  • kept: conductor indices to keep, in result order.
  • eliminated: conductor indices to remove.
  • terminals: labels of the kept rows, with a bundle's conductor labels joined by +.
source
LineCableModels.Engine.bundle! — Function
bundle!(
    matrix::AbstractMatrix,
    pairs::AbstractVector{Tuple{Int64, Int64}}
) -> AbstractMatrix

Merge each other conductor of a bundle into the first conductor of its index, in the rows and columns of matrix. The conductors of a bundle share one voltage and carry its current together. For the pairs $(i, j)$ of pairs, with $i$ the first conductor of a bundle and $j$ another one, the change of basis is

\[M' = T M T^{\mathsf{T}}, \qquad T = I - \sum_{(i, j)} e_j e_i^{\mathsf{T}},\]

where $e_i$ is the unit vector of row $i$. It subtracts column $i$ from column $j$, then row $i$ from row $j$. Row $j$ then gives the voltage of $j$ less that of $i$, zero inside a bundle. The Kron elimination of $j$ by eliminate! completes the merge.

Arguments

  • matrix: square matrix of impedances [Ω/m] or potential coefficients [m/F], one row per conductor.
  • pairs: the rows (first, other) of each conductor that a bundle merges into the first conductor of its index.

Returns

  • matrix, with transformed columns and rows, in its original unit [Ω/m or m/F].
source
LineCableModels.Engine.eliminate! — Function
eliminate!(
    reduced::AbstractArray{Complex{T<:Real}, 2},
    matrix::AbstractArray{Complex{T<:Real}, 2},
    kept::AbstractVector{Int64},
    eliminated::AbstractVector{Int64},
    factor::AbstractArray{Complex{T<:Real}, 2},
    coupling::AbstractArray{Complex{T<:Real}, 2},
    rhs::AbstractArray{Complex{T<:Real}, 2}
) -> Any

Write into reduced the Kron elimination of matrix, the Schur complement of the block of eliminated rows and columns, retained on the kept rows and columns:

\[M_{\mathrm{r}} = M_{kk} - M_{ke} M_{ee}^{-1} M_{ek},\]

where $k$ indexes the kept rows and columns in the order of kept, and $e$ the eliminated ones in the order of eliminated. An eliminated conductor is at zero voltage: grounded, or merged into a bundle by bundle!. The LU decomposition of $M_{ee}$ solves for $M_{ee}^{-1} M_{ek}$. Without an eliminated row, $M_{\mathrm{r}} = M_{kk}$.

Arguments

  • reduced: destination matrix with length(kept) rows and columns [Ω/m or m/F].
  • matrix: square matrix of impedances [Ω/m] or potential coefficients [m/F], one row per conductor.
  • kept: rows of matrix that the elimination keeps.
  • eliminated: rows of matrix that the elimination removes.
  • factor: array for the LU factors of $M_{ee}$, square with length(eliminated) rows. Before factorization its unit is [Ω/m or m/F].
  • coupling: matrix of length(kept) rows and length(eliminated) columns that receives $M_{ke}$ [Ω/m or m/F].
  • rhs: matrix of length(eliminated) rows and length(kept) columns that receives $M_{ee}^{-1} M_{ek}$ [dimensionless].

Returns

  • reduced, in the unit of matrix [Ω/m or m/F].
source
LineCableModels.Engine.transposition! — Function
transposition!(matrix::AbstractMatrix) -> AbstractMatrix

Replace matrix by its ideal transposition, the mean over the $n$ cyclic permutations of its rows and columns:

\[\bar{M}_{ij} = \frac{1}{n} \sum_{k = 0}^{n - 1} M_{i + k, j + k},\]

with the indices taken cyclically, modulo $n$. Each cyclic diagonal, the entries $(i, j)$ of one value of $j - i$ modulo $n$, takes the mean of its entries, so the result is a circulant matrix.

Arguments

  • matrix: square matrix of impedances [Ω/m] or admittances [S/m], one row per conductor.

Returns

  • matrix, with circulant entries in its original unit [Ω/m or S/m].

Errors

  • Throws DimensionMismatch when matrix is not square.
source

The scan

The computation of LCMBackend evaluates the formulas at each frequency and writes Z and Y:

LineCableModels.Engine.solve! — Method
solve!(
    Z::AbstractArray{Complex{T<:Real}, 3},
    Y::AbstractArray{Complex{T<:Real}, 3},
    trace,
    problem::LineParametersProblem{T<:Real, S, E} where {S<:CableSystem, E<:(EarthModel{T<:Real})},
    input::LineCableModels.Engine.CoaxialInput{T<:Real, L} where L<:(AbstractArray{<:Material{T<:Real}, 1}),
    formulation::CoaxialFormulation,
    buffers,
    options::LineCableModels.Commons.ComputationOptions
) -> AbstractArray{Complex{T}, 3} where T<:Real

Write the series impedances and shunt admittances at every frequency. Evaluate material laws and cable formulas, prepare earth state once per formula, assemble the conductor matrices, and apply bundle and Kron reductions. The conductor matrices add the earth-return matrices of the cables to the matrices inside them,

\[Z_{ij} = Z_{\mathrm{in}, ij} + Z_{g, c_i c_j}, \qquad P_{ij} = P_{\mathrm{in}, ij} + P_{g, c_i c_j},\]

where $c_i$ is the cable of conductor $i$. The admittance is

\[Y = s P_{\mathrm{r}}^{-1}, \qquad s = \mathrm{j} 2 \pi f,\]

where $P_{\mathrm{r}}$ is the reduced potential matrix [m/F] and $f$ is frequency [Hz]. Apply the ideal transposition after reduction when selected.

Arguments

  • Z: destination series-impedance array, indexed by row, column, and frequency [Ω/m].
  • Y: destination shunt-admittance array in the same order [S/m].
  • trace: destinations for Zin, Zg [Ω/m] and Pin, Pg [m/F] at each frequency.
  • problem: cable system, earth, temperature, and frequencies.
  • input: numerical cable geometry and reduction indices.
  • formulation: formulas and formulation controls.
  • buffers: preallocated material, matrix, and formula arrays.
  • options: computation controls. The option trace selects copies of the intermediate matrices before assembly.

Returns

  • Z, with computed entries [Ω/m]. The method also fills Y and the selected trace arrays.
source

The formula families extend these functions of the engine. A formula method takes the formula first.

LineCableModels.Engine.impedance — Function
impedance(formula, …)

Return the series-impedance terms of a formula.

Arguments

  • formula: series-impedance formula.
  • …: physical inputs of the selected method.

Returns

  • An impedance [Ω/m] or a named tuple of impedance terms in the same unit.
source
LineCableModels.Engine.impedance! — Function
impedance!(formula, Z, …)

Write the series-impedance matrix of a formula. A method that combines formulas takes them all before Z. An earth-return method takes buffers, input, media, s, k after Z.

Arguments

  • formula: series-impedance formula.
  • Z: destination for the matrix in [Ω/m].
  • buffers: preallocated computation arrays for an earth-return method.
  • input: numerical cable geometry and connections.
  • media: air and earth properties at the frequency.
  • s: complex frequency, j 2π f, [1/s].
  • k: frequency index.
  • …: inputs of another selected method.

Returns

  • Z, with the computed entries [Ω/m].
source
LineCableModels.Engine.potential! — Function
potential!(formula, P, …)

Write the potential-coefficient matrix of a formula. An earth-return method takes buffers, input, media, s, k after P.

Arguments

  • formula: potential-coefficient formula.
  • P: destination for the matrix in [m/F].
  • buffers: preallocated computation arrays for an earth-return method.
  • input: numerical cable geometry and connections.
  • media: air and earth properties at the frequency.
  • s: complex frequency, j 2π f, [1/s].
  • k: frequency index.
  • …: inputs of another selected method.

Returns

  • P, with the computed entries [m/F].
source
LineCableModels.Engine.prepare! — Method
prepare!(
    _::LineCableModels.Commons.AbstractFormulation,
    buffers,
    input,
    media,
    s,
    k
) -> Any

Fill the shared state of a formula in buffers at the frequency of index k. Its quantity methods read this state. A formula without such state returns buffers unchanged, as this method does.

Arguments

  • formula: formula whose state needs preparation.
  • buffers: preallocated computation arrays.
  • input: numerical cable geometry and connections.
  • media: air and earth properties at the frequency.
  • s: complex frequency, j 2π f, [1/s].
  • k: frequency index.

Returns

  • buffers.
source
LineCableModels.Engine.initialize_buffers — Method
initialize_buffers(
    _::LineCableModels.Commons.AbstractFormulation,
    problem,
    input,
    buffers
) -> Union{NamedTuple, DataStructures.SortedMultiDict}

Add the preallocated arrays that a formula needs to compute problem to buffers once, before the loop over frequencies. A formula without arrays of its own returns buffers unchanged, as this method does.

Arguments

  • formula: formula whose arrays the computation needs.
  • problem: line-parameters problem.
  • input: numerical cable geometry and connections.
  • buffers: arrays already allocated.

Returns

  • buffers.
source
LineCableModels.Engine.initialize_buffers — Method
initialize_buffers(
    formulation::CoaxialFormulation,
    problem::LineParametersProblem,
    input::LineCableModels.Engine.CoaxialInput{T<:Real, L} where L<:(AbstractArray{<:Material{T<:Real}, 1})
) -> NamedTuple

Allocate the coaxial computation arrays, fill the longitudinal wavenumbers, and add the arrays of each formula from formulas.

Arguments

  • formulation: formulas, longitudinal wavenumbers, and reductions.
  • problem: line-parameters problem.
  • input: numerical cable geometry and reduction indices.

Returns

  • A named tuple of conductor resistivities rho [Ω·m], dielectric admittivities kappa [S/m], and longitudinal wavenumbers gamma [1/m].
  • The same tuple contains Zin, Zg [Ω/m], Pin, Pg [m/F], reduction arrays, an identity matrix, and formula-specific arrays.
source
LineCableModels.Engine.admittivity — Function
admittivity(formula, material, f)

Return the admittivity of a dielectric layer at a frequency.

Arguments

  • formula: admittivity law.
  • material: material of the dielectric layer.
  • f: frequency [Hz].

Returns

  • Admittivity [S/m].
source
LineCableModels.Engine.admittivity — Method
admittivity(
    formulation::Union{CoaxialFormulation, FEM},
    material::Material{T<:Real, :insulator},
    f
) -> Any

Evaluate the insulator admittivity law selected by the formulation.

Arguments

  • formulation: coaxial or finite-element formulation with the material laws.
  • material: insulator material.
  • f: frequency [Hz].

Returns

  • Admittivity [S/m].
source
LineCableModels.Engine.resistivity — Function
resistivity(formula, material, temperature)

Return the conductor resistivity at a temperature.

Arguments

  • formula: resistivity law.
  • material: material of the conductor.
  • temperature: temperature of the conductor [°C].

Returns

  • Resistivity [Ω·m].
source
LineCableModels.Engine.properties — Function
properties(formula, layer, f)

Return the material properties of an earth or air layer at a frequency.

Arguments

  • formula: earth-properties law.
  • layer: earth or air layer.
  • f: frequency [Hz].

Returns

  • rho: resistivity [Ω·m].
  • eps_r: relative permittivity [dimensionless].
  • mu_r: relative permeability [dimensionless].
source

Back to Contents