comnum_mimo/lib.rs
1//! # comnum-mimo — multiple-antenna processing
2//!
3//! Detection, space-time coding, precoding and capacity on the generic flat model
4//! $y = H x + w$, with $H$ the $n_{r} \times n_{t}$ channel matrix. The channel models
5//! themselves (Rayleigh and Rician fading, antenna correlation) are in `comnum-channel`
6//! (`fading::Mimo`, `spatial`); waveform-specific resource mapping (per-subcarrier
7//! detection of MIMO-OFDM) belongs to `comnum-waveform`.
8//!
9//! | Module | Content |
10//! |---|---|
11//! | [`detection`] | MR (matched filter), ZF, MMSE, ordered SIC (V-BLAST), exhaustive ML, sphere decoder, K-best; hard and soft outputs, the estimates of the symbols ([`detection::Estimates`]) |
12//! | [`message_passing`] | LAMA (complex Bayesian AMP) and OAMP for large systems, their state evolution and the recovery thresholds of LAMA |
13//! | [`receiver`] | the receiver of a link: a detector of [`detection`] by name, applied channel use after channel use (spatial layers or Alamouti blocks), with soft outputs |
14//! | [`stbc`] | orthogonal space-time block codes: Alamouti, the rate-3/4 codes for 3 and 4 antennas; linear decoding |
15//! | [`noma`] | downlink NOMA with users dropped at random in a disc: the gain distribution, the SIC thresholds, the exact and high-SNR outage probabilities (Ding, Yang, Fan & Poor 2014) |
16//! | [`precoding`] | SVD (eigenmode) transmission with water-filling, ZF and regularised ZF precoders |
17//! | [`estimation`] | training-based channel estimation on $S = H P + V$: LS, scaled LS, LMMSE and relaxed MMSE, their MSEs, the orthogonal and MMSE-optimal training, the BLUE combination of training periods (Biguesh and Gershman 2006) |
18//! | [`massive`] | the uplink of multi-user massive MIMO: perfect or estimated CSI, the closed-form lower bounds on the rates of MR and ZF receivers (Ngo, Larsson and Marzetta 2013) |
19//! | [`capacity`] | capacity of a channel realisation with equal power or water-filling; the ergodic and outage capacities of i.i.d. Rayleigh fading, the eigenvalue density of a Wishart matrix |
20//!
21//! `comnum-mimo` uses the constellations of `comnum-mapping` (ADR 0008).
22
23pub mod capacity;
24pub mod detection;
25pub mod estimation;
26pub mod massive;
27pub mod message_passing;
28pub mod noma;
29pub mod precoding;
30pub mod receiver;
31pub mod stbc;