comnum.theory_sdr_gain_limited#

comnum.theory_sdr_gain_limited(sir_db, eps_db, rho=Ellipsis)#

The signal-to-distortion ratio (dB) of gain-limited correction against a cochannel interferer in Rayleigh fading (Cimini 1985, eq. (25); eq. (20) for an ideal pilot).

Parameters:

  • sir_db (float | array_like) – the signal-to-interference ratio (dB).

  • eps_db (float) – the gain limit relative to the RMS gain (dB, 20 log10).

  • rho (complex) – the correlation E[Z_d Z_p*] of the data and pilot envelopes.

Returns:

the SDR (dB) at every SIR.

Return type:

float | numpy.ndarray

Raises:

ValueError – for values that are not real numbers.

Examples

>>> import comnum
>>> round(comnum.theory_sdr_gain_limited(25.0, -17.0), 1)
17.7