Utils

Set of utility functions for Sionna SYS.

General Utilities

is_scheduled_in_slot([sinr, num_allocated_re])	Determines whether a user is scheduled in a slot.
get_pathloss(h_freq[, rx_tx_association, ...])	Computes the pathloss for each receiver-transmitter pair and, if the receiver-transmitter association is provided, the pathloss between each user and the associated base station.
spread_across_subcarriers(tx_power_per_ut, ...)	Distributes the power uniformly across all allocated subcarriers and streams for each user.

Metrics for 3GPP Calibration

The following utilities compute system-level metrics used for 3GPP TR 38.901 calibration [TR38901V160100]. They are needed to evaluate Phase 1 link-budget metrics such as coupling loss, geometry SIR, and geometry SINR, and Phase 2 wideband interference metrics. These quantities are computed from the large-scale path gains or coupling losses of all candidate serving and interfering cells.

coupling_loss_db(path_gain_db[, precision, ...])	Computes the coupling loss from a path gain in dB.
received_power_dbm(tx_power_dbm, coupling_loss)	Computes received power from transmit power and coupling loss.
serving_indices(coupling_loss)	Returns the serving-cell indices for minimum coupling loss.
geometry_sir_db(coupling_loss[, serving, ...])	Computes geometry SIR from coupling losses.
geometry_sinr_db(coupling_loss, ...[, ...])	Computes geometry SINR from coupling losses and receiver noise.
wideband_sir_db(coupling_loss[, serving, ...])	Computes wideband SIR from coupling losses.