DatasheetLine
- class pmrf.models.components.lines.empirical.DatasheetLine(length: Any, zn: Any = 50.0, vf: Any = 1.0, k1: Any = 0.0, k2: Any = 0.0, f_ref: Any = 1000000000.0, *, name: str | None = None, metadata: Any = None, formulation: AbstractEffectiveLineFormulation = <factory>)
Bases:
AbstractEffectiveLineEffective-value line defined by datasheet velocity factor and loss coefficients.
The default
NominalEffectiveLineFormulationuses a frequency-flat permittivity, as CAD “physical” lines do, and is not causal. Passformulation=GeneralizedEffectiveLineFormulation()for a causal line.Mathematical Formulation
With \(k_1\) in dB/(100 m \(\sqrt{\text{MHz}}\)) and \(k_2\) in dB/(100 m MHz), the datasheet attenuation is
\[\alpha_{dB}(f) = k_1 \sqrt{\frac{f}{1\,\text{MHz}}} + k_2 \frac{f}{1\,\text{MHz}}\]per 100 m. Both losses are exact power laws, so they map exactly onto the effective values\[\varepsilon_{eff} = \frac{1}{v_f^2} \qquad A = \frac{k_1}{100} \sqrt{\frac{f_{ref}}{1\,\text{MHz}}} \qquad \tan\delta = \frac{k_2 v_f c_0 \ln 10}{2\pi \cdot 10^9}\]at every frequency, not only at \(f_{ref}\).EquivalentLinegives the resulting per-unit-length quantities.Example
import pmrf as prf from pmrf.models import DatasheetLine cable = DatasheetLine( zn=50.0, vf=0.69, # Velocity factor (e.g., solid PTFE) k1=0.2, # Skin effect loss factor k2=0.01, # Dielectric loss factor length=1.0 ) freq = prf.Frequency(start=0.1, stop=10, npoints=201, unit='ghz') s = cable.s(freq)
References
Pozar, D. M. (2011). Microwave Engineering (4th ed.), Sections 2.1 and 2.7. Wiley.
- Parameters:
zn (Param, default=50.0) – Nominal characteristic impedance in ohm.
vf (Param, default=1.0) – Velocity factor (ratio of propagation speed to the speed of light).
k1 (Param, default=0.0) – Skin effect loss factor in dB/(100 m sqrt(MHz)).
k2 (Param, default=0.0) – Dielectric loss factor in dB/(100 m MHz).
f_ref (Param, default=1e9) – Reference frequency in Hz of the effective values.
formulation (AbstractEffectiveLineFormulation, default=NominalEffectiveLineFormulation()) – Turns the effective values into the immittance. The default is not causal; see
NominalEffectiveLineFormulation.
- effective_values() EffectiveValues
The effective values of the line.
- Returns:
The nominal impedance, effective permittivity, conductor attenuation, loss tangent and their reference frequency.
- Return type:
- immittance(freq: Frequency) ImmittanceResult
Calculates the frequency-dependent per-unit-length immittance.
- Parameters:
freq (Frequency) – The frequency axis.
- Returns:
The series impedance and shunt admittance vectors.
- Return type:
- formulation: AbstractEffectiveLineFormulation
Turns the effective values into the immittance