sim_lib_numbers_stats/lib.rs
1#![forbid(unsafe_code)]
2#![deny(missing_docs)]
3
4//! Probability, descriptive and robust benchmark statistics, deterministic
5//! clustering, streaming quantiles, finite Markov and hidden-state sequence
6//! inference, and fairness helpers for number-domain data.
7//!
8//! Descriptive statistics and disparate-impact helpers also expose Claim
9//! surfaces. The Claim values carry their subject, predicate, and evidence table
10//! as inspectable runtime data, so callers can browse both the computed metric
11//! and the inputs used to justify it. [`fit_markov`] keeps the finite vocabulary,
12//! exact counts, additive smoothing, held-out likelihood, deterministic
13//! serialization, and corpus provenance inspectable instead of hiding learned
14//! weights. [`QuantileSketch`] makes rank error and retained memory explicit;
15//! [`forward_backward`], [`viterbi`], and [`fit_hmm`] keep normalization,
16//! convergence, bounded work, numerical repair, and termination evidence.
17//! [`fit_kmeans`] and [`fit_gmm`] add seeded initialization, bounded convergence,
18//! regularized covariance, singular-component policy, and model-selection
19//! evidence without taking ownership of sequence alignment.
20//! [`median_absolute_deviation`] and [`bootstrap_mean_difference_interval`]
21//! serve benchmark dispersion and comparison policy without duplicating
22//! statistical formulas in tooling.
23
24mod implementation;
25
26pub use implementation::*;
27
28/// Cookbook recipes for this lib, embedded at build time.
29pub static RECIPES: sim_cookbook::EmbeddedDir =
30 include!(concat!(env!("OUT_DIR"), "/cookbook_recipes.rs"));
31
32#[cfg(test)]
33mod tests;