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:
AbstractEffectiveLineFormulationThe 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 isNominalEffectiveLineFormulation.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
DjordjevicSarkarDielectricwith \(\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;
GeneralizedLCTermraises 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
Nonefor no onset.conductor_terms (tuple of GeneralizedRLTerm, default=()) – Conductor relaxations.
(A, f)tuples are coerced toGeneralizedRLTerm.dielectric_terms (tuple of GeneralizedRCTerm, default=()) – Dielectric relaxations.
(tand, f)tuples are coerced toGeneralizedRCTerm.inductive_dispersion (tuple of GeneralizedLCTerm, default=()) – Resonances in the inductance.
(a, f)or(a, f, zeta)tuples are coerced toGeneralizedLCTerm.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:
freq (Frequency) – The frequency axis.
values (EffectiveValues) – The effective values of the line.
- Returns:
The series impedance and shunt admittance.
- Return type:
- capacitive_dispersion: tuple[GeneralizedLCTerm, ...] = ()
Resonances in the capacitance
- conductor_terms: tuple[GeneralizedRLTerm, ...] = ()
Conductor relaxations
- dielectric_terms: tuple[GeneralizedRCTerm, ...] = ()
Dielectric relaxations
- inductive_dispersion: tuple[GeneralizedLCTerm, ...] = ()
Resonances in the inductance