comnum-mapping 0.3.0

Constellations, Gray labelling, mapping, hard and soft demapping, differential PSK, sources and closed-form error rates of comnum
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34

//! # 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`](comnum_core::traits::Map) and [`Demap`](comnum_core::traits::Demap) traits |
//! | [`differential`] | differential coding of M-PSK (DBPSK, DQPSK, D8PSK): encoding and decoding of phase indices, noncoherent detection, Gray-labelled [`Dpsk`](differential::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);
//! ```

pub mod bicm;
pub mod constellation;
pub mod demapper;
pub mod differential;
pub mod imperfect_csi;
pub mod link_adaptation;
pub mod source;
pub mod theory;