rf-bench-drivers-utils

Pure RF math utilities for bench instrument automation. Part of the rf-bench-drivers family of packages.

Install

pip install rf-bench-drivers-utils

Import

from rf_bench.utils import dbm_to_vpp, thermal_noise_floor, format_freq

What's in the box

rf_bench.utils is a single module (rf_utils.py) of pure functions. No instrument connections, no side effects, numpy is the only dependency.

All functions default to 50 Ω reference impedance where applicable. Frequencies are in Hz throughout; use format_freq() for human-readable display.

Quick examples

from rf_bench.utils import (
    dbm_to_vpp, thermal_noise_floor, rl_to_vswr,
    cascaded_noise_figure, pi_attenuator, format_freq,
)

# 0 dBm into 50 Ω
print(dbm_to_vpp(0))           # 0.6325 Vpp

# Thermal noise floor at 500 Hz bandwidth
print(thermal_noise_floor(500))  # -143.0 dBm (approx)

# Return loss to VSWR
print(rl_to_vswr(20))           # 1.222

# Cascaded noise figure: 2 dB cable -> 20 dB LNA (3 dB NF) -> IF amp
print(cascaded_noise_figure([(-2, 2), (20, 3), (10, 5)]))  # ~5.06 dB

# Pi attenuator values for 6 dB at 50 Ω
print(pi_attenuator(6))         # {'r_shunt': 150.5, 'r_series': 37.35}

# Frequency formatting
print(format_freq(14_200_000))  # '14.2000 MHz'

Related packages

This package is one of four that together replace the original rf-bench monolith:

All four packages share the rf_bench namespace; install as many as you need.

License

GPL-3.0-or-later