rng-entropy 0.5.0

A pure-Rust statistical test suite for pseudorandom number generators (NIST SP 800-22, DIEHARD, DIEHARDER).
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
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49

//! DIEHARD battery tests not already covered by NIST SP 800-22.
//!
//! Reference: George Marsaglia, *DIEHARD: A Battery of Tests of Randomness*,
//! Florida State University, 1995.  `pubs/Diehard.zip`
//!
//! Every function in this module cites Marsaglia as the original author.

pub mod binary_rank;
pub mod birthday_spacings;
pub mod bitstream;
pub mod count_ones;
pub mod craps;
pub mod minimum_distance;
pub mod monkey;
pub mod parking_lot;
pub mod runs_float;
pub mod spheres_3d;
pub mod squeeze;

use crate::{result::TestResult, rng::Rng};

/// Run all unique DIEHARD tests and return results.
///
/// `n_u32` is the number of 32-bit words to consume; 10 000 is sufficient
/// for most tests; 1 000 000 is recommended for the full battery.
/// `quick` reduces the O(n²) geometric test parameters for fast iteration.
pub fn run_all(rng: &mut impl Rng, n_u32: usize, quick: bool) -> Vec<TestResult> {
    let words = rng.collect_u32s(n_u32);
    let mut results = vec![
        birthday_spacings::birthday_spacings(&words),
        binary_rank::binary_rank_32x32(&words),
        binary_rank::binary_rank_31x31(&words),
        binary_rank::binary_rank_6x8(&words),
        bitstream::bitstream(&words),
        monkey::opso(&words),
        monkey::oqso(&words),
        monkey::dna(&words),
        count_ones::count_ones_stream(&words),
        parking_lot::parking_lot(rng, quick),
        minimum_distance::minimum_distance_2d(rng, quick),
        spheres_3d::spheres_3d(rng, quick),
        squeeze::squeeze(rng),
    ];
    // runs_float_both returns two results: one for up-runs, one for down-runs.
    results.extend(runs_float::runs_float_both(rng));
    // craps has two independent statistics; emit both rather than collapsing to min.
    results.extend(craps::craps_both(rng));
    results
}