Struct quasirandom::Qrng

pub struct Qrng<T: Quasirandom> { /* fields omitted */ }

Main driver of this library

QRNG vs PRNG

A Qrng is a quasirandom value generator. Rather than generating values that are truly random (or pseudorandom), it produces values that are evenly distributed across the domain of all possible values.

Uses

Qrngs are particularly useful for things like monte-carlo simulations, where evenly covering the domain improves convergence.

Features

A Qrng can be built for any tuple up to size 32 for which all elements implement FromUniform.

For instance, a Qrng<(f64, u32, bool, Option<i16>)> will generate values of the 5-tuple that, over enough samples, will uniformly cover that space.

Note

Type inference will typically force you to specify the type at construction time, e.g. Qrng::<(f64, f64)>::new(seed).

Example usage

use quasirandom::Qrng;
 
fn compute_pi() {
    let mut qrng = Qrng::<(f64, f64)>::new(0.123);
    let mut hits = 0.0;
    let mut total = 0.0;
    for _ in 0..1_000_000 {
        let (x, y) = qrng.gen();
        if x.hypot(y) < 1.0 {
            hits += 1.0;
        }
        total += 1.0;
    }
    println!("pi is approximately {}", 4.0 * hits / total);
}

Acknowledgments

The technique used in this generator is directly taken from this blog post by Martin Roberts.

Implementations

impl<T: FromUniform> Qrng<T>

pub fn new(seed: f64) -> Self

pub fn gen(&mut self) -> T

impl<T0: FromUniform> Qrng<(T0,)>

pub fn new(seed: f64) -> Self

pub fn gen(&mut self) -> (T0,)

impl<T0: FromUniform, T1: FromUniform> Qrng<(T0, T1)>

pub fn new(seed: f64) -> Self

pub fn gen(&mut self) -> (T0, T1)

impl<T0: FromUniform, T1: FromUniform, T2: FromUniform> Qrng<(T0, T1, T2)>

pub fn new(seed: f64) -> Self

pub fn gen(&mut self) -> (T0, T1, T2)

impl<T0: FromUniform, T1: FromUniform, T2: FromUniform, T3: FromUniform> Qrng<(T0, T1, T2, T3)>

pub fn new(seed: f64) -> Self

pub fn gen(&mut self) -> (T0, T1, T2, T3)

impl<T0: FromUniform, T1: FromUniform, T2: FromUniform, T3: FromUniform, T4: FromUniform> Qrng<(T0, T1, T2, T3, T4)>

pub fn new(seed: f64) -> Self

pub fn gen(&mut self) -> (T0, T1, T2, T3, T4)

impl<T0: FromUniform, T1: FromUniform, T2: FromUniform, T3: FromUniform, T4: FromUniform, T5: FromUniform> Qrng<(T0, T1, T2, T3, T4, T5)>

pub fn new(seed: f64) -> Self

pub fn gen(&mut self) -> (T0, T1, T2, T3, T4, T5)

impl<T0: FromUniform, T1: FromUniform, T2: FromUniform, T3: FromUniform, T4: FromUniform, T5: FromUniform, T6: FromUniform> Qrng<(T0, T1, T2, T3, T4, T5, T6)>

pub fn new(seed: f64) -> Self

pub fn gen(&mut self) -> (T0, T1, T2, T3, T4, T5, T6)

impl<T0: FromUniform, T1: FromUniform, T2: FromUniform, T3: FromUniform, T4: FromUniform, T5: FromUniform, T6: FromUniform, T7: FromUniform> Qrng<(T0, T1, T2, T3, T4, T5, T6, T7)>

pub fn new(seed: f64) -> Self

pub fn gen(&mut self) -> (T0, T1, T2, T3, T4, T5, T6, T7)

impl<T0: FromUniform, T1: FromUniform, T2: FromUniform, T3: FromUniform, T4: FromUniform, T5: FromUniform, T6: FromUniform, T7: FromUniform, T8: FromUniform> Qrng<(T0, T1, T2, T3, T4, T5, T6, T7, T8)>

pub fn new(seed: f64) -> Self

pub fn gen(&mut self) -> (T0, T1, T2, T3, T4, T5, T6, T7, T8)

impl<T0: FromUniform, T1: FromUniform, T2: FromUniform, T3: FromUniform, T4: FromUniform, T5: FromUniform, T6: FromUniform, T7: FromUniform, T8: FromUniform, T9: FromUniform> Qrng<(T0, T1, T2, T3, T4, T5, T6, T7, T8, T9)>

pub fn new(seed: f64) -> Self

pub fn gen(&mut self) -> (T0, T1, T2, T3, T4, T5, T6, T7, T8, T9)

impl<T0: FromUniform, T1: FromUniform, T2: FromUniform, T3: FromUniform, T4: FromUniform, T5: FromUniform, T6: FromUniform, T7: FromUniform, T8: FromUniform, T9: FromUniform, T10: FromUniform> Qrng<(T0, T1, T2, T3, T4, T5, T6, T7, T8, T9, T10)>

pub fn new(seed: f64) -> Self

pub fn gen(&mut self) -> (T0, T1, T2, T3, T4, T5, T6, T7, T8, T9, T10)

impl<T0: FromUniform, T1: FromUniform, T2: FromUniform, T3: FromUniform, T4: FromUniform, T5: FromUniform, T6: FromUniform, T7: FromUniform, T8: FromUniform, T9: FromUniform, T10: FromUniform, T11: FromUniform> Qrng<(T0, T1, T2, T3, T4, T5, T6, T7, T8, T9, T10, T11)>

pub fn new(seed: f64) -> Self

pub fn gen(&mut self) -> (T0, T1, T2, T3, T4, T5, T6, T7, T8, T9, T10, T11)

impl<T0: FromUniform, T1: FromUniform, T2: FromUniform, T3: FromUniform, T4: FromUniform, T5: FromUniform, T6: FromUniform, T7: FromUniform, T8: FromUniform, T9: FromUniform, T10: FromUniform, T11: FromUniform, T12: FromUniform> Qrng<(T0, T1, T2, T3, T4, T5, T6, T7, T8, T9, T10, T11, T12)>

pub fn new(seed: f64) -> Self

pub fn gen(&mut self) -> (T0, T1, T2, T3, T4, T5, T6, T7, T8, T9, T10, T11, T12)

impl<T0: FromUniform, T1: FromUniform, T2: FromUniform, T3: FromUniform, T4: FromUniform, T5: FromUniform, T6: FromUniform, T7: FromUniform, T8: FromUniform, T9: FromUniform, T10: FromUniform, T11: FromUniform, T12: FromUniform, T13: FromUniform> Qrng<(T0, T1, T2, T3, T4, T5, T6, T7, T8, T9, T10, T11, T12, T13)>

pub fn new(seed: f64) -> Self

pub fn gen(
    &mut self
) -> (T0, T1, T2, T3, T4, T5, T6, T7, T8, T9, T10, T11, T12, T13)

impl<T0: FromUniform, T1: FromUniform, T2: FromUniform, T3: FromUniform, T4: FromUniform, T5: FromUniform, T6: FromUniform, T7: FromUniform, T8: FromUniform, T9: FromUniform, T10: FromUniform, T11: FromUniform, T12: FromUniform, T13: FromUniform, T14: FromUniform> Qrng<(T0, T1, T2, T3, T4, T5, T6, T7, T8, T9, T10, T11, T12, T13, T14)>

pub fn new(seed: f64) -> Self

pub fn gen(
    &mut self
) -> (T0, T1, T2, T3, T4, T5, T6, T7, T8, T9, T10, T11, T12, T13, T14)

impl<T0: FromUniform, T1: FromUniform, T2: FromUniform, T3: FromUniform, T4: FromUniform, T5: FromUniform, T6: FromUniform, T7: FromUniform, T8: FromUniform, T9: FromUniform, T10: FromUniform, T11: FromUniform, T12: FromUniform, T13: FromUniform, T14: FromUniform, T15: FromUniform> Qrng<(T0, T1, T2, T3, T4, T5, T6, T7, T8, T9, T10, T11, T12, T13, T14, T15)>

pub fn new(seed: f64) -> Self

pub fn gen(
    &mut self
) -> (T0, T1, T2, T3, T4, T5, T6, T7, T8, T9, T10, T11, T12, T13, T14, T15)

impl<T0: FromUniform, T1: FromUniform, T2: FromUniform, T3: FromUniform, T4: FromUniform, T5: FromUniform, T6: FromUniform, T7: FromUniform, T8: FromUniform, T9: FromUniform, T10: FromUniform, T11: FromUniform, T12: FromUniform, T13: FromUniform, T14: FromUniform, T15: FromUniform, T16: FromUniform> Qrng<(T0, T1, T2, T3, T4, T5, T6, T7, T8, T9, T10, T11, T12, T13, T14, T15, T16)>

pub fn new(seed: f64) -> Self

pub fn gen(
    &mut self
) -> (T0, T1, T2, T3, T4, T5, T6, T7, T8, T9, T10, T11, T12, T13, T14, T15, T16)

impl<T0: FromUniform, T1: FromUniform, T2: FromUniform, T3: FromUniform, T4: FromUniform, T5: FromUniform, T6: FromUniform, T7: FromUniform, T8: FromUniform, T9: FromUniform, T10: FromUniform, T11: FromUniform, T12: FromUniform, T13: FromUniform, T14: FromUniform, T15: FromUniform, T16: FromUniform, T17: FromUniform> Qrng<(T0, T1, T2, T3, T4, T5, T6, T7, T8, T9, T10, T11, T12, T13, T14, T15, T16, T17)>

pub fn new(seed: f64) -> Self

pub fn gen(
    &mut self
) -> (T0, T1, T2, T3, T4, T5, T6, T7, T8, T9, T10, T11, T12, T13, T14, T15, T16, T17)

impl<T0: FromUniform, T1: FromUniform, T2: FromUniform, T3: FromUniform, T4: FromUniform, T5: FromUniform, T6: FromUniform, T7: FromUniform, T8: FromUniform, T9: FromUniform, T10: FromUniform, T11: FromUniform, T12: FromUniform, T13: FromUniform, T14: FromUniform, T15: FromUniform, T16: FromUniform, T17: FromUniform, T18: FromUniform> Qrng<(T0, T1, T2, T3, T4, T5, T6, T7, T8, T9, T10, T11, T12, T13, T14, T15, T16, T17, T18)>

pub fn new(seed: f64) -> Self

pub fn gen(
    &mut self
) -> (T0, T1, T2, T3, T4, T5, T6, T7, T8, T9, T10, T11, T12, T13, T14, T15, T16, T17, T18)

impl<T0: FromUniform, T1: FromUniform, T2: FromUniform, T3: FromUniform, T4: FromUniform, T5: FromUniform, T6: FromUniform, T7: FromUniform, T8: FromUniform, T9: FromUniform, T10: FromUniform, T11: FromUniform, T12: FromUniform, T13: FromUniform, T14: FromUniform, T15: FromUniform, T16: FromUniform, T17: FromUniform, T18: FromUniform, T19: FromUniform> Qrng<(T0, T1, T2, T3, T4, T5, T6, T7, T8, T9, T10, T11, T12, T13, T14, T15, T16, T17, T18, T19)>

pub fn new(seed: f64) -> Self

pub fn gen(
    &mut self
) -> (T0, T1, T2, T3, T4, T5, T6, T7, T8, T9, T10, T11, T12, T13, T14, T15, T16, T17, T18, T19)

impl<T0: FromUniform, T1: FromUniform, T2: FromUniform, T3: FromUniform, T4: FromUniform, T5: FromUniform, T6: FromUniform, T7: FromUniform, T8: FromUniform, T9: FromUniform, T10: FromUniform, T11: FromUniform, T12: FromUniform, T13: FromUniform, T14: FromUniform, T15: FromUniform, T16: FromUniform, T17: FromUniform, T18: FromUniform, T19: FromUniform, T20: FromUniform> Qrng<(T0, T1, T2, T3, T4, T5, T6, T7, T8, T9, T10, T11, T12, T13, T14, T15, T16, T17, T18, T19, T20)>

pub fn new(seed: f64) -> Self

pub fn gen(
    &mut self
) -> (T0, T1, T2, T3, T4, T5, T6, T7, T8, T9, T10, T11, T12, T13, T14, T15, T16, T17, T18, T19, T20)

impl<T0: FromUniform, T1: FromUniform, T2: FromUniform, T3: FromUniform, T4: FromUniform, T5: FromUniform, T6: FromUniform, T7: FromUniform, T8: FromUniform, T9: FromUniform, T10: FromUniform, T11: FromUniform, T12: FromUniform, T13: FromUniform, T14: FromUniform, T15: FromUniform, T16: FromUniform, T17: FromUniform, T18: FromUniform, T19: FromUniform, T20: FromUniform, T21: FromUniform> Qrng<(T0, T1, T2, T3, T4, T5, T6, T7, T8, T9, T10, T11, T12, T13, T14, T15, T16, T17, T18, T19, T20, T21)>

pub fn new(seed: f64) -> Self

pub fn gen(
    &mut self
) -> (T0, T1, T2, T3, T4, T5, T6, T7, T8, T9, T10, T11, T12, T13, T14, T15, T16, T17, T18, T19, T20, T21)

impl<T0: FromUniform, T1: FromUniform, T2: FromUniform, T3: FromUniform, T4: FromUniform, T5: FromUniform, T6: FromUniform, T7: FromUniform, T8: FromUniform, T9: FromUniform, T10: FromUniform, T11: FromUniform, T12: FromUniform, T13: FromUniform, T14: FromUniform, T15: FromUniform, T16: FromUniform, T17: FromUniform, T18: FromUniform, T19: FromUniform, T20: FromUniform, T21: FromUniform, T22: FromUniform> Qrng<(T0, T1, T2, T3, T4, T5, T6, T7, T8, T9, T10, T11, T12, T13, T14, T15, T16, T17, T18, T19, T20, T21, T22)>

pub fn new(seed: f64) -> Self

pub fn gen(
    &mut self
) -> (T0, T1, T2, T3, T4, T5, T6, T7, T8, T9, T10, T11, T12, T13, T14, T15, T16, T17, T18, T19, T20, T21, T22)

impl<T0: FromUniform, T1: FromUniform, T2: FromUniform, T3: FromUniform, T4: FromUniform, T5: FromUniform, T6: FromUniform, T7: FromUniform, T8: FromUniform, T9: FromUniform, T10: FromUniform, T11: FromUniform, T12: FromUniform, T13: FromUniform, T14: FromUniform, T15: FromUniform, T16: FromUniform, T17: FromUniform, T18: FromUniform, T19: FromUniform, T20: FromUniform, T21: FromUniform, T22: FromUniform, T23: FromUniform> Qrng<(T0, T1, T2, T3, T4, T5, T6, T7, T8, T9, T10, T11, T12, T13, T14, T15, T16, T17, T18, T19, T20, T21, T22, T23)>

pub fn new(seed: f64) -> Self

pub fn gen(
    &mut self
) -> (T0, T1, T2, T3, T4, T5, T6, T7, T8, T9, T10, T11, T12, T13, T14, T15, T16, T17, T18, T19, T20, T21, T22, T23)

impl<T0: FromUniform, T1: FromUniform, T2: FromUniform, T3: FromUniform, T4: FromUniform, T5: FromUniform, T6: FromUniform, T7: FromUniform, T8: FromUniform, T9: FromUniform, T10: FromUniform, T11: FromUniform, T12: FromUniform, T13: FromUniform, T14: FromUniform, T15: FromUniform, T16: FromUniform, T17: FromUniform, T18: FromUniform, T19: FromUniform, T20: FromUniform, T21: FromUniform, T22: FromUniform, T23: FromUniform, T24: FromUniform> Qrng<(T0, T1, T2, T3, T4, T5, T6, T7, T8, T9, T10, T11, T12, T13, T14, T15, T16, T17, T18, T19, T20, T21, T22, T23, T24)>

pub fn new(seed: f64) -> Self

pub fn gen(
    &mut self
) -> (T0, T1, T2, T3, T4, T5, T6, T7, T8, T9, T10, T11, T12, T13, T14, T15, T16, T17, T18, T19, T20, T21, T22, T23, T24)

impl<T0: FromUniform, T1: FromUniform, T2: FromUniform, T3: FromUniform, T4: FromUniform, T5: FromUniform, T6: FromUniform, T7: FromUniform, T8: FromUniform, T9: FromUniform, T10: FromUniform, T11: FromUniform, T12: FromUniform, T13: FromUniform, T14: FromUniform, T15: FromUniform, T16: FromUniform, T17: FromUniform, T18: FromUniform, T19: FromUniform, T20: FromUniform, T21: FromUniform, T22: FromUniform, T23: FromUniform, T24: FromUniform, T25: FromUniform> Qrng<(T0, T1, T2, T3, T4, T5, T6, T7, T8, T9, T10, T11, T12, T13, T14, T15, T16, T17, T18, T19, T20, T21, T22, T23, T24, T25)>

pub fn new(seed: f64) -> Self

pub fn gen(
    &mut self
) -> (T0, T1, T2, T3, T4, T5, T6, T7, T8, T9, T10, T11, T12, T13, T14, T15, T16, T17, T18, T19, T20, T21, T22, T23, T24, T25)

impl<T0: FromUniform, T1: FromUniform, T2: FromUniform, T3: FromUniform, T4: FromUniform, T5: FromUniform, T6: FromUniform, T7: FromUniform, T8: FromUniform, T9: FromUniform, T10: FromUniform, T11: FromUniform, T12: FromUniform, T13: FromUniform, T14: FromUniform, T15: FromUniform, T16: FromUniform, T17: FromUniform, T18: FromUniform, T19: FromUniform, T20: FromUniform, T21: FromUniform, T22: FromUniform, T23: FromUniform, T24: FromUniform, T25: FromUniform, T26: FromUniform> Qrng<(T0, T1, T2, T3, T4, T5, T6, T7, T8, T9, T10, T11, T12, T13, T14, T15, T16, T17, T18, T19, T20, T21, T22, T23, T24, T25, T26)>

pub fn new(seed: f64) -> Self

pub fn gen(
    &mut self
) -> (T0, T1, T2, T3, T4, T5, T6, T7, T8, T9, T10, T11, T12, T13, T14, T15, T16, T17, T18, T19, T20, T21, T22, T23, T24, T25, T26)

impl<T0: FromUniform, T1: FromUniform, T2: FromUniform, T3: FromUniform, T4: FromUniform, T5: FromUniform, T6: FromUniform, T7: FromUniform, T8: FromUniform, T9: FromUniform, T10: FromUniform, T11: FromUniform, T12: FromUniform, T13: FromUniform, T14: FromUniform, T15: FromUniform, T16: FromUniform, T17: FromUniform, T18: FromUniform, T19: FromUniform, T20: FromUniform, T21: FromUniform, T22: FromUniform, T23: FromUniform, T24: FromUniform, T25: FromUniform, T26: FromUniform, T27: FromUniform> Qrng<(T0, T1, T2, T3, T4, T5, T6, T7, T8, T9, T10, T11, T12, T13, T14, T15, T16, T17, T18, T19, T20, T21, T22, T23, T24, T25, T26, T27)>

pub fn new(seed: f64) -> Self

pub fn gen(
    &mut self
) -> (T0, T1, T2, T3, T4, T5, T6, T7, T8, T9, T10, T11, T12, T13, T14, T15, T16, T17, T18, T19, T20, T21, T22, T23, T24, T25, T26, T27)

impl<T0: FromUniform, T1: FromUniform, T2: FromUniform, T3: FromUniform, T4: FromUniform, T5: FromUniform, T6: FromUniform, T7: FromUniform, T8: FromUniform, T9: FromUniform, T10: FromUniform, T11: FromUniform, T12: FromUniform, T13: FromUniform, T14: FromUniform, T15: FromUniform, T16: FromUniform, T17: FromUniform, T18: FromUniform, T19: FromUniform, T20: FromUniform, T21: FromUniform, T22: FromUniform, T23: FromUniform, T24: FromUniform, T25: FromUniform, T26: FromUniform, T27: FromUniform, T28: FromUniform> Qrng<(T0, T1, T2, T3, T4, T5, T6, T7, T8, T9, T10, T11, T12, T13, T14, T15, T16, T17, T18, T19, T20, T21, T22, T23, T24, T25, T26, T27, T28)>

pub fn new(seed: f64) -> Self

pub fn gen(
    &mut self
) -> (T0, T1, T2, T3, T4, T5, T6, T7, T8, T9, T10, T11, T12, T13, T14, T15, T16, T17, T18, T19, T20, T21, T22, T23, T24, T25, T26, T27, T28)

impl<T0: FromUniform, T1: FromUniform, T2: FromUniform, T3: FromUniform, T4: FromUniform, T5: FromUniform, T6: FromUniform, T7: FromUniform, T8: FromUniform, T9: FromUniform, T10: FromUniform, T11: FromUniform, T12: FromUniform, T13: FromUniform, T14: FromUniform, T15: FromUniform, T16: FromUniform, T17: FromUniform, T18: FromUniform, T19: FromUniform, T20: FromUniform, T21: FromUniform, T22: FromUniform, T23: FromUniform, T24: FromUniform, T25: FromUniform, T26: FromUniform, T27: FromUniform, T28: FromUniform, T29: FromUniform> Qrng<(T0, T1, T2, T3, T4, T5, T6, T7, T8, T9, T10, T11, T12, T13, T14, T15, T16, T17, T18, T19, T20, T21, T22, T23, T24, T25, T26, T27, T28, T29)>

pub fn new(seed: f64) -> Self

pub fn gen(
    &mut self
) -> (T0, T1, T2, T3, T4, T5, T6, T7, T8, T9, T10, T11, T12, T13, T14, T15, T16, T17, T18, T19, T20, T21, T22, T23, T24, T25, T26, T27, T28, T29)

impl<T0: FromUniform, T1: FromUniform, T2: FromUniform, T3: FromUniform, T4: FromUniform, T5: FromUniform, T6: FromUniform, T7: FromUniform, T8: FromUniform, T9: FromUniform, T10: FromUniform, T11: FromUniform, T12: FromUniform, T13: FromUniform, T14: FromUniform, T15: FromUniform, T16: FromUniform, T17: FromUniform, T18: FromUniform, T19: FromUniform, T20: FromUniform, T21: FromUniform, T22: FromUniform, T23: FromUniform, T24: FromUniform, T25: FromUniform, T26: FromUniform, T27: FromUniform, T28: FromUniform, T29: FromUniform, T30: FromUniform> Qrng<(T0, T1, T2, T3, T4, T5, T6, T7, T8, T9, T10, T11, T12, T13, T14, T15, T16, T17, T18, T19, T20, T21, T22, T23, T24, T25, T26, T27, T28, T29, T30)>

pub fn new(seed: f64) -> Self

pub fn gen(
    &mut self
) -> (T0, T1, T2, T3, T4, T5, T6, T7, T8, T9, T10, T11, T12, T13, T14, T15, T16, T17, T18, T19, T20, T21, T22, T23, T24, T25, T26, T27, T28, T29, T30)

impl<T0: FromUniform, T1: FromUniform, T2: FromUniform, T3: FromUniform, T4: FromUniform, T5: FromUniform, T6: FromUniform, T7: FromUniform, T8: FromUniform, T9: FromUniform, T10: FromUniform, T11: FromUniform, T12: FromUniform, T13: FromUniform, T14: FromUniform, T15: FromUniform, T16: FromUniform, T17: FromUniform, T18: FromUniform, T19: FromUniform, T20: FromUniform, T21: FromUniform, T22: FromUniform, T23: FromUniform, T24: FromUniform, T25: FromUniform, T26: FromUniform, T27: FromUniform, T28: FromUniform, T29: FromUniform, T30: FromUniform, T31: FromUniform> Qrng<(T0, T1, T2, T3, T4, T5, T6, T7, T8, T9, T10, T11, T12, T13, T14, T15, T16, T17, T18, T19, T20, T21, T22, T23, T24, T25, T26, T27, T28, T29, T30, T31)>

pub fn new(seed: f64) -> Self

pub fn gen(
    &mut self
) -> (T0, T1, T2, T3, T4, T5, T6, T7, T8, T9, T10, T11, T12, T13, T14, T15, T16, T17, T18, T19, T20, T21, T22, T23, T24, T25, T26, T27, T28, T29, T30, T31)

Trait Implementations

impl<T: Clone + Quasirandom> Clone for Qrng<T> where
    T::State: Clone, 

fn clone(&self) -> Qrng<T>

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl<T: Debug + Quasirandom> Debug for Qrng<T> where
    T::State: Debug, 

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<T: Default + Quasirandom> Default for Qrng<T> where
    T::State: Default, 

fn default() -> Qrng<T>

Returns the “default value” for a type.