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//! - [`random`] — Random number generation, shuffling, and weighted sampling
15//! - [`collections`] — Specialized data structures (Union-Find)
16//!
17//! ## Design Philosophy
18//!
19//! - **Numerical stability first**: Welford's algorithm for variance,
20//! Neumaier summation for accumulation
21//! - **Reproducibility**: Seeded RNG support for deterministic experiments
22//! - **Property-based testing**: Mathematical invariants verified via proptest
23
24pub mod collections;
25pub mod distributions;
26pub mod random;
27pub mod special;
28pub mod stats;