The rationale for this crate is to generate good quality random numbers fast, simply and with a minimal footprint.
Not everyone wants to add 375KB plus another ten dependencies, just to generate a bunch of random numbers for testing etc ( looking at the 'other' crate: rand).
In contradistinction, this crate is lightweight and it has no dependencies at all.
There are three main algorithms on offer, plus a few utility functions to generate vectors and vectors of vectors filled with random numbers.
Two of the base algorithms, ranf64 and xoshiro generate individual f64 random numbers in the half open interval [0,1). 'Xoshiro' is a fast, modern f64 generator of top quality. It is easy to convert from this standardised range to any new desired range [min,max]. Examples are provided.
The third algorithm, splitmix, generates u64 numbers in their full range. It is currently used just to initialise the seeds for xoshiro. However, it does pass the tests. We may add an optimal u64 generator later.
use ran::*;
These algorithms use a thread safe seed, defined as follows:
``rust
// SEED is used byranf64and/orsplitmix` algorithms
threadlocal!(
// initialise SEED to a default value, in case user omits to set it
static SEED: RefCell
/// Use this function to initialise the thread local static SEED
pub fn setseed( seed:u64 ) { SEED.with(|s| *s.borrowmut() = seed) }
``
It is strongly recommended to initialise the seed withset_seed(value)` in every thread where you may want to be generating the random numbers, otherwise you will get the same sequence every time, based on the default value. Any u64 value will do.
Version 0.1.1 Changed the crate name to ran as all others are taken.
Version 0.1.0 The initial version.