comnum.theory_bicm_capacity#

comnum.theory_bicm_capacity(constellation, snr_db, *, fading='awgn', points=Ellipsis)#

The BICM capacity (bits per channel use) of a labelled constellation with uniform inputs (Caire, Taricco & Biglieri 1998, eq. (14)): the GMI of the bit-wise decoder, labels as constellation gives them (Gray, or Constellation.set_partitioning): theory_gmi() of any labelled constellation, uniform inputs.

Parameters:

  • constellation (Constellation) – the labelled points.

  • snr_db (float | array_like) – E_s/σ² (dB).

  • fading (str) – "awgn" or "rayleigh".

  • points (int) – quadrature nodes per dimension.

Returns:

the capacity at every SNR.

Return type:

float | numpy.ndarray

Raises:

ValueError – for an invalid parameter or input (the message names it).