GeneralizedEffectiveLineFormulation

class pmrf.models.components.lines.empirical.GeneralizedEffectiveLineFormulation(f_low: Any = 1000.0, f_high: Any = 1000000000000.0, R_dc: Any = 0.0, f_s: Any = None, conductor_terms: Any = (), dielectric_terms: Any = (), inductive_dispersion: Any = (), capacitive_dispersion: Any = (), *, name: str | None = None, metadata: Any = None)

Bases: AbstractEffectiveLineFormulation

The causal effective-value formulation, with RL, RC and LC refinement terms.

The base is the nominal RLGC line with a causal factor on each loss term: the conductor loss gains the internal inductance of a half-space conductor, and the dielectric becomes a Djordjevic-Sarkar dielectric whose permittivity and loss tangent equal the effective values at \(f_{ref}\). On top of it, an optional skin-effect onset, a DC resistance and four families of terms model higher-order behaviour: extra conductor relaxations (GeneralizedRLTerm), dielectric relaxations (GeneralizedRCTerm) and modal dispersion of the inductance and capacitance (GeneralizedLCTerm). Every part is causal, so the line is too. Each term computes its own contribution, and this formulation sums them. With the defaults it is the first-order causal line. The non-causal, CAD-style special case is NominalEffectiveLineFormulation.

Mathematical Formulation

With the nominal \(R'_n(\omega)\), \(L'_n\) and \(C'_n\) of EffectiveValues,

\[Z'(\omega) = j\omega L'_n + Z'_{int}(\omega) + \sum_i Z'_{L,i}(\omega) \qquad Y'(\omega) = j\omega C'_n \frac{\varepsilon_{DS}(\omega)}{\varepsilon_{eff}} + \sum_i Y'_{RC,i}(\omega) + \sum_i Y'_{C,i}(\omega).\]

\(\varepsilon_{DS}\) is the complex permittivity of DjordjevicSarkarDielectric with \(\varepsilon_r' = \varepsilon_{eff}\), \(\tan\delta\), \(f_{ref}\), f_low and f_high. Equivalently, its term is \(\chi_{DS}(\omega) G'_n + j\omega C'_n\) with

\[X(\omega) = \ln\frac{\omega_{high} + j\omega}{\omega_{low} + j\omega} \qquad \chi_{DS}(\omega) = \frac{X(\omega) - \Re X(\omega_{ref})}{j \Im X(\omega_{ref})},\]
so \(\chi_{DS}(\omega_{ref}) = 1\).

Each RC term in dielectric_terms adds

\[Y'_{RC,i}(\omega) = j\omega C'_n \frac{2\tan\delta_i}{1 + j\omega/\omega_i},\]
and each LC term adds
\[Z'_{L,i}(\omega) = j\omega L'_n \Delta_i(\omega) \quad\text{or}\quad Y'_{C,i}(\omega) = j\omega C'_n \Delta_i(\omega), \qquad \Delta_i(\omega) = \frac{a_i}{1 - (\omega/\omega_i)^2 + 2j\zeta_i\omega/\omega_i},\]
as it sits in inductive_dispersion or capacitive_dispersion. Undamped, \(\zeta_i = 0\), \(\Delta_i = a_i \omega_i^2 / (\omega_i^2 - \omega^2)\); damped, it is a lossy RLC term.

The conductor’s internal impedance is

\[Z'_{int}(\omega) = R_{dc} + \frac{2}{\pi}(1 + j) R'_n(\omega) \arctan\sqrt{\frac{j\omega}{\omega_s}} + 2 z_n \frac{\ln 10}{20} \sum_i A_i \frac{j\omega}{\omega_i + j\omega},\]
where the sum runs over conductor_terms, each a parallel \(R_i \parallel L_i\) with \(R_i = 2 z_n \frac{\ln 10}{20} A_i\) and \(L_i = R_i/\omega_i\). The arctan is the closed form of a distribution of RL terms truncated below \(\omega_s\),
\[\frac{\sqrt{2} R'_n(\omega_{ref})}{\pi\sqrt{\omega_{ref}}} \int_{\omega_s}^{\infty} \frac{j\omega}{\sqrt{x}(x + j\omega)}\,dx,\]
which tends to \((1 + j) R'_n(\omega)\) as \(\omega_s \to 0\). With f_s = None the onset is absent and that limit is used exactly.

ep_eff and tand describe the base medium at f_ref. The terms add to it, so once any RC or LC term is present \(\Re\,\varepsilon(f_{ref}) \neq \varepsilon_{eff}\). Each RC term also raises the static capacitance by \(2\tan\delta_i C'_n\), as the Kramers-Kronig relations require. An undamped LC term is singular at its resonance, so f must lie outside the evaluated band; GeneralizedLCTerm raises if it does not.

Example

import pmrf as prf
from pmrf.models import (
    EquivalentLine, GeneralizedEffectiveLineFormulation, GeneralizedLCTerm,
)

line = EquivalentLine(
    zn=50.0,
    ep_eff=2.1,
    A=0.05,
    tand=2e-4,
    length=1.0,
    formulation=GeneralizedEffectiveLineFormulation(
        f_s=1e6,
        conductor_terms=[(0.01, 10e6)],
        dielectric_terms=[(1e-4, 100e6)],
        capacitive_dispersion=[GeneralizedLCTerm(a=1e-3, f=20e9)],
    ),
)

freq = prf.Frequency(start=1, stop=1000, npoints=101, unit='mhz')
s = line.s(freq)

References

Allen, G. V. C. Precision Circuit Modelling for 21 cm Radiometer Calibration. PhD thesis.

Djordjevic, A. R., Biljic, R. M., Likar-Smiljanic, V. D., & Sarkar, T. K. (2001). Wideband frequency-domain characterization of FR-4 and time-domain causality. IEEE Transactions on Electromagnetic Compatibility, 43(4), 662-667.

Pozar, D. M. (2011). Microwave Engineering (4th ed.), Section 1.7. Wiley.

Debye, P. (1929). Polar Molecules. Chemical Catalog Company.

Jackson, J. D. (1999). Classical Electrodynamics (3rd ed.), Section 7.5. Wiley.

Parameters:
  • f_low (Param, default=1e3) – Lower bound of the base medium’s relaxation-time distribution in Hz.

  • f_high (Param, default=1e12) – Upper bound of the base medium’s relaxation-time distribution in Hz.

  • R_dc (Param, default=0.0) – DC series resistance in ohm/m.

  • f_s (Param | None, default=None) – Skin-effect onset frequency in Hz, or None for no onset.

  • conductor_terms (tuple of GeneralizedRLTerm, default=()) – Conductor relaxations. (A, f) tuples are coerced to GeneralizedRLTerm.

  • dielectric_terms (tuple of GeneralizedRCTerm, default=()) – Dielectric relaxations. (tand, f) tuples are coerced to GeneralizedRCTerm.

  • inductive_dispersion (tuple of GeneralizedLCTerm, default=()) – Resonances in the inductance. (a, f) or (a, f, zeta) tuples are coerced to GeneralizedLCTerm.

  • capacitive_dispersion (tuple of GeneralizedLCTerm, default=()) – Resonances in the capacitance, coerced as inductive_dispersion.

immittance(freq: Frequency, values: EffectiveValues) → ImmittanceResult

Calculate the per-unit-length immittance.

Parameters:
Returns:

The series impedance and shunt admittance.

Return type:

ImmittanceResult

R_dc: Param = 0.0

DC series resistance in ohm/m

capacitive_dispersion: tuple[GeneralizedLCTerm, ...] = ()

Resonances in the capacitance

conductor_terms: tuple[GeneralizedRLTerm, ...] = ()

Conductor relaxations

dielectric_terms: tuple[GeneralizedRCTerm, ...] = ()

Dielectric relaxations

f_high: Param = 1000000000000.0

Upper bound of the base medium’s relaxation-time distribution

f_low: Param = 1000.0

Lower bound of the base medium’s relaxation-time distribution

f_s: Param | None = None

Skin-effect onset frequency, or None for no onset

inductive_dispersion: tuple[GeneralizedLCTerm, ...] = ()

Resonances in the inductance