tiny_prng 0.2.5

Tiny pseudo number generator set (MT, Xorshift and PCG)
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
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157

#[macro_export]
macro_rules! generate_real64 {
    () => {
         pub fn generate_real(&mut self) -> f64 {
            let r = self.generate();
            let upper = (r>>32) as f64;
            let lower = (r&0xfffffffc) as f64; // 53bit
            upper * (1.0/(4294967295.0)) + lower * (1.0/(18446744073709551615.0))
        }

         pub fn generate_real_in_range(&mut self, lower: f64, upper: f64) -> f64 {
            let v = self.generate_real();
            lower + (upper - lower) * v
        }

        pub fn generate_real_closed(&mut self) -> f64{
            let r = self.generate();
            let upper = (r>>32) as f64;
            let lower = (r&0xfffffffc) as f64; // 53bit
            upper * (1.0/(4294967296.0)) + lower * (1.0/(18446744073709551616.0))
        }
    }
}

#[macro_export]
macro_rules! generate_real32 {
    () => {
    pub fn generate_real(&mut self) -> f64 {
        (self.generate() as f64) *(1.0/4294967295.0)
    }

    pub fn generate_real_in_range(&mut self, lower: f64, upper: f64) -> f64 {
        let v = self.generate_real();
        lower + (upper - lower) * v
    }

    pub fn generate_real_closed(&mut self) -> f64{
            (self.generate() as f64) *(1.0/4294967296.0)
        }
    }
}

#[macro_export]
macro_rules! generate_real128 {
    () => {
        pub fn generate_real(&mut self) -> f64 {
            let r = self.generate();
            let upper1 = (r >> 96) as f64;
            let upper2 = ((r >> 64) & 0xfffffffc) as f64;
            upper1 * (1.0 / (4294967295.0)) + upper2 * (1.0 / (18446744073709551615.0))
        }

        pub fn generate_real_in_range(&mut self, lower: f64, upper: f64) -> f64 {
            let v = self.generate_real();
            lower + (upper - lower) * v
        }

        pub fn generate_real_closed(&mut self) -> f64 {
            let r = self.generate();
            let upper1 = (r >> 96) as f64;
            let upper2 = ((r >> 64) & 0xfffffffc) as f64; // 53bit
            upper1 * (1.0 / (4294967296.0)) + upper2 * (1.0 / (18446744073709551616.0))
        }
    }
}

#[macro_export]
macro_rules! gen_delta_rate {
    () => {
        100
    };
}

#[macro_export]
macro_rules! generate_unit_test {
    ($constructor:ident, $name:ident, $primitive:ident, $seed:literal, $count:ident) => {
        #[test]
        fn $name() {
            let mut s = $constructor::with_seed($seed);
            let mut sum = 0;
            let acceptable_delta = $primitive::MAX / (gen_delta_rate!() as $primitive);
            for _ in 0..$count {
                sum += s.generate() / $count as $primitive;
            }
            let real_delta = match sum > $primitive::MAX / 2 {
                true => sum - $primitive::MAX / 2,
                false => $primitive::MAX / 2 - sum,
            };
            assert!(real_delta < acceptable_delta);
        }

    };
}


#[macro_export]
macro_rules! generate_unit_test_real1 {
    ($constructor:ident, $name:ident, $primitive:ident, $seed:literal, $count:ident) => {
        #[test]
        fn $name() {
            let mut p = $constructor::with_seed($seed);
            let mut sum = 0.0;
            let max_count = 100 * $count;
            let acceptable_delta = 1.0 / (gen_delta_rate!() as $primitive);
            for _ in 0..max_count {
                sum += p.generate_real() / max_count as $primitive;
            }
            let diff = match sum > 0.5 {
                true => sum - 0.5,
                false => 0.5 - sum,
            };
            assert_eq!(true, diff < acceptable_delta);
        }
    };
}

#[macro_export]
macro_rules! generate_unit_test_real2 {
    ($constructor:ident, $name:ident, $primitive:ident, $seed:literal, $count:ident) => {
        #[test]
        fn $name() {
            let mut p = $constructor::with_seed($seed);
            let mut sum = 0.0;
            let max_count = $count;
            let acceptable_delta = 1.0 / (gen_delta_rate!() as $primitive);
            for _ in 0..max_count {
                sum += p.generate_real_closed() / max_count as $primitive;
            }
            let diff = match sum > 0.5 {
                true => sum - 0.5,
                false => 0.5 - sum,
            };
            assert_eq!(true, diff < acceptable_delta);
        }
    };
}

#[macro_export]
macro_rules! generate_unit_test_real_ranged {
    ($constructor:ident, $name:ident, $primitive:ident, $seed:literal, $count:ident) => {
        #[test]
        fn $name() {
            let mut p = $constructor::with_seed($seed);
            let mut sum = 0.0;
            let max_count = $count;
            let acceptable_delta = 2000.0 / (gen_delta_rate!() as $primitive);
            for _ in 0..max_count {
                sum += p.generate_real_in_range(-1000.0, 1000.0) ;
            }
            let diff = match sum > 0.0 {
                true => sum / max_count as $primitive,
                false => -(sum / max_count as $primitive),
            };
            assert_eq!(true, diff < acceptable_delta);
        }
    };
}