Utility Functions

linkbudget.util.db_to_lin(val_db)[source]

Decibels to linear value

Parameters:

val – Value in decibels.

Returns:

Corresponding value in linear scale.

linkbudget.util.dbm_to_dbw(val_dbm)[source]

Convert dBm to dBW

Parameters:

val_dbm – Value in dBm (decibels above 1 milliwatt).

Returns:

Value in dBW (decibels above 1 Watt).

linkbudget.util.dbw_to_dbm(val_dbw)[source]

Convert dBW to dBm

Parameters:

val_dbw – Value in dBW (decibels above 1 Watt).

Returns:

Value in dBm (decibels above 1 milliwatt).

linkbudget.util.format_area(area)[source]

Format area given in m2

Parameters:

area – Area in square meters (m2).

Returns:

String with the area and an adjusted unit such as cm2, dm2, or m2.

linkbudget.util.format_power(power)[source]

Format power given in Watts

Parameters:

power – Power in Watts (W).

Returns:

String with the power value and an adjusted unit such as kW or mW.

linkbudget.util.format_rate(rate)[source]

Format data rate given in bps

Parameters:

rate – Data rate in bits per second (bps).

Returns:

String with the data rate and an adjusted unit such as Gbps, Mbps, or kbps.

linkbudget.util.get_default_lb_dir()[source]

Get the default directory for link-budget-specific files

linkbudget.util.get_home_dir()[source]

Get the user’s home directory even if running with sudo

linkbudget.util.lin_to_db(val)[source]

Linear value to decibels

Parameters:

val – Linear scale value.

Returns:

Corresponding value in decibels.

linkbudget.util.log_header()[source]

Log header to form a table with result logs

linkbudget.util.log_result(parameter, value)[source]

Log parameter-value result

Parameters:
  • parameter – Parameter to log.

  • value – Corresponding value.

linkbudget.util.wavelength(freq)[source]

Compute the radio wavelength for a given frequency

Parameters:

freq – Radio frequency in Hz.

Returns:

Wavelength in meters.