cubecl-random 0.8.1

CubeCL Random Number Generation.
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

#[macro_export]
macro_rules! testgen_random_interval {
    () => {
        mod test_random_interval {
            use super::*;

            #[cube(launch)]
            pub(crate) fn kernel_to_unit_interval_co(input: &Array<u32>, output: &mut Array<f32>) {
                output[ABSOLUTE_POS] = super::to_unit_interval_closed_open(input[ABSOLUTE_POS]);
            }

            #[cube(launch)]
            pub(crate) fn kernel_to_unit_interval_oo(input: &Array<u32>, output: &mut Array<f32>) {
                output[ABSOLUTE_POS] = super::to_unit_interval_open(input[ABSOLUTE_POS]);
            }

            #[test]
            fn values_closed_open_interval() {
                let client = TestRuntime::client(&Default::default());

                let input = client.create(u32::as_bytes(&[0, u32::MAX]));
                let output = client.empty(input.size() as usize);

                kernel_to_unit_interval_co::launch::<TestRuntime>(
                    &client,
                    CubeCount::Static(1, 1, 1),
                    CubeDim::default(),
                    unsafe { ArrayArg::from_raw_parts::<u32>(&input, 2, 1) },
                    unsafe { ArrayArg::from_raw_parts::<f32>(&output, 2, 1) },
                );

                let actual = client.read_one(output);
                let actual = f32::from_bytes(&actual);

                // Previous implementation would map to `[0, 1]` but the interval should be half open `[0, 1)`
                assert_eq!(
                    actual[0], 0.0,
                    "Expected 0 to map to 0.0, but got {}",
                    actual[0]
                );

                assert!(
                    actual[1] < 1.0,
                    "Expected u32::MAX to map to a value strictly less than 1.0, but got {}",
                    actual[1]
                );

                assert!(
                    actual[1] >= 0.9999999,
                    "Expected u32::MAX to map close to 1.0, but got {}",
                    actual[1]
                );
            }

            #[test]
            fn values_open_interval() {
                let client = TestRuntime::client(&Default::default());

                let input = client.create(u32::as_bytes(&[0, u32::MAX]));
                let output = client.empty(input.size() as usize);

                kernel_to_unit_interval_oo::launch::<TestRuntime>(
                    &client,
                    CubeCount::Static(1, 1, 1),
                    CubeDim::default(),
                    unsafe { ArrayArg::from_raw_parts::<u32>(&input, 2, 1) },
                    unsafe { ArrayArg::from_raw_parts::<f32>(&output, 2, 1) },
                );

                let actual = client.read_one(output);
                let actual = f32::from_bytes(&actual);

                assert!(
                    actual[0] > 0.0,
                    "Expected 0 to map to a value strictly greater than 0.0, but got {}",
                    actual[0]
                );

                assert!(
                    actual[1] < 1.0,
                    "Expected u32::MAX to map to a value strictly less than 1.0, but got {}",
                    actual[1]
                );

                assert!(
                    actual[1] >= 0.9999999,
                    "Expected u32::MAX to map close to 1.0, but got {}",
                    actual[1]
                );
            }
        }
    };
}