Crate comnum_mapping 

comnum-mapping — constellations, mapping and demapping

(OptiCommPy optic.comm.modulation and optic.comm.sources.)

Module	Content
bicm	cutoff rates of coded modulation and bit-interleaved coded modulation, over AWGN and Rayleigh fading (Caire, Taricco & Biglieri 1998); their capacities are in theory
link_adaptation	variable-rate variable-power MQAM over Rayleigh fading: capacity with water-filling in time, adaptive MQAM with continuous and discrete rates, region durations (Goldsmith & Chua 1997)
constellation	PAM, QAM, PSK and OOK constellations with Gray (or set-partitioning) labelling, mapping of bits to symbols, hard decisions
demapper	log-likelihood ratios (exact and max-log); the Map and Demap traits
differential	differential coding of M-PSK (DBPSK, DQPSK, D8PSK): encoding and decoding of phase indices, noncoherent detection, Gray-labelled Dpsk
imperfect_csi	bit error rates over Rayleigh fading with an imperfect channel estimate (BPSK, QPSK, 16-QAM) and of differential detection over Jakes’ fading (Chang & Su 2002)
source	random bits, pseudo-random binary sequences (PRBS), random and shaped symbols
theory	closed-form error rates over AWGN and Rayleigh fading, information rates over AWGN and Rayleigh fading (the CM and BICM capacities), the SER of orthogonal signals detected noncoherently

Examples

use comnum_mapping::{constellation::Constellation, source};
use comnum_core::rng::Rng;
let c = Constellation::qam(16).unwrap().normalized();
let bits = source::bits(400, &mut Rng::new(1));
let x = c.map_bits(&bits).unwrap();
assert_eq!(x.len(), 100);
assert_eq!(c.demap_bits(&x), bits);

Modules

bicm

Cutoff rates of coded modulation (CM) and bit-interleaved coded modulation (BICM) with uniform inputs (Caire, Taricco & Biglieri 1998, Sec. III); their capacities are the mutual information and the generalized mutual information of crate::theory::constellation_mi and crate::theory::constellation_gmi.

constellation

Constellations, Gray mapping and hard decisions (OptiCommPy optic.comm.modulation).

demapper

Soft demapping: log-likelihood ratios of the bits of received symbols.

differential

Differential coding of M-PSK (DBPSK, DQPSK, D8PSK, …): encoding and decoding of the phase indices, noncoherent detection, and the Gray-labelled link Dpsk.

imperfect_csi

Error rates over Rayleigh fading with an imperfect channel estimate (Chang & Su 2002).

link_adaptation

Variable-rate variable-power MQAM over Rayleigh fading (Goldsmith & Chua 1997): the Shannon capacity with power adapted in time, the spectral efficiency of MQAM whose size and power follow the channel gain at a target bit error rate, with a continuum or a finite set of constellations, and the average time spent in every fading region.

source

Sources of bits and symbols (OptiCommPy optic.comm.sources).

theory

Closed-form error rates and information rates of constellations over AWGN.