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: AbstractEffectiveLine

Effective-value line defined by datasheet velocity factor and loss coefficients.

The default NominalEffectiveLineFormulation uses a frequency-flat permittivity, as CAD “physical” lines do, and is not causal. Pass formulation=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}\). EquivalentLine gives 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:

EffectiveValues

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:

ImmittanceResult

f_ref: Param = 1000000000.0

Reference frequency of the effective values

formulation: AbstractEffectiveLineFormulation

Turns the effective values into the immittance

k1: Param = 0.0

Skin effect loss factor in dB/(100 m sqrt(MHz))

k2: Param = 0.0

Dielectric loss factor in dB/(100 m MHz)

vf: Param = 1.0

Velocity factor

zn: Param = 50.0

Nominal characteristic impedance