u_numflow/lib.rs
1//! # u-numflow
2//!
3//! Mathematical primitives for the U-Engine ecosystem.
4//!
5//! This crate provides foundational mathematical, statistical, and probabilistic
6//! building blocks that are domain-agnostic. It knows nothing about scheduling,
7//! nesting, geometry, or any consumer domain.
8//!
9//! ## Modules
10//!
11//! - [`stats`] — Descriptive statistics with numerical stability guarantees
12//! - [`distributions`] — Probability distributions (Uniform, Triangular, PERT, Normal, LogNormal, Weibull)
13//! - [`special`] — Special mathematical functions (normal CDF, inverse normal CDF)
14//! - [`matrix`] — Dense matrix operations (multiply, determinant, inverse, Cholesky)
15//! - [`random`] — Random number generation, shuffling, and weighted sampling
16//! - [`collections`] — Specialized data structures (Union-Find)
17//!
18//! ## Design Philosophy
19//!
20//! - **Numerical stability first**: Welford's algorithm for variance,
21//! Neumaier summation for accumulation
22//! - **Reproducibility**: Seeded RNG support for deterministic experiments
23//! - **Property-based testing**: Mathematical invariants verified via proptest
24
25pub mod collections;
26pub mod distributions;
27pub mod matrix;
28pub mod random;
29pub mod special;
30pub mod stats;