/* Written in 2016 by David Blackman and Sebastiano Vigna (vigna@acm.org) To the extent possible under law, the author has dedicated all copyright and related and neighboring rights to this software to the public domain worldwide. This software is distributed without any warranty. See . */ #include "xoroshiro128_plus.h" /* This is the successor to xorshift128+. It is the fastest full-period generator passing BigCrush without systematic failures, but due to the relatively short period it is acceptable only for applications with a mild amount of parallelism; otherwise, use a xorshift1024* generator. Beside passing BigCrush, this generator passes the PractRand test suite up to (and included) 16TB, with the exception of binary rank tests, which fail due to the lowest bit being an LFSR; all other bits pass all tests. We suggest to use a sign test to extract a random Boolean value. Note that the generator uses a simulated rotate operation, which most C compilers will turn into a single instruction. In Java, you can use Long.rotateLeft(). In languages that do not make low-level rotation instructions accessible xorshift128+ could be faster. The state must be seeded so that it is not everywhere zero. If you have a 64-bit seed, we suggest to seed a splitmix64 generator and use its output to fill s. */ // Sample seed: // uint64_t s[2]; // or // xoroshiro128_plus_seed my_seed[XOROSHIRO128_PLUS_SEED_LENGTH] static inline uint64_t rotl(const uint64_t x, int k) { return (x << k) | (x >> (64 - k)); } // Advance the state of the generator uint64_t next(uint64_t seed[]) { const uint64_t s0 = seed[0]; uint64_t s1 = seed[1]; const uint64_t result = s0 + s1; s1 ^= s0; seed[0] = rotl(s0, 55) ^ s1 ^ (s1 << 14); // a, b seed[1] = rotl(s1, 36); // c return result; } /* This is the jump function for the generator. It is equivalent to 2^64 calls to next(); it can be used to generate 2^64 non-overlapping subsequences for parallel computations. */ void jump(uint64_t in_seed[], uint64_t out_seed[]) { static const uint64_t JUMP[] = { 0xbeac0467eba5facb, 0xd86b048b86aa9922 }; uint64_t s0 = 0; uint64_t s1 = 0; for(int i = 0; i < sizeof JUMP / sizeof *JUMP; i++) for(int b = 0; b < 64; b++) { if (JUMP[i] & 1ULL << b) { s0 ^= in_seed[0]; s1 ^= in_seed[1]; } next(in_seed); } out_seed[0] = s0; out_seed[1] = s1; } // Next double in range (0,1] // From the text in http://xoroshiro.di.unimi.it/ double next_double(uint64_t seed[]) { const union { uint64_t i; double d; } u = { .i = UINT64_C(0x3FF) << 52 | next(seed) >> 12 }; return u.d - 1.0; } // Next float in range (0,1] float next_float(uint64_t seed[]) { const union { uint32_t i; float d; } u = { .i = UINT32_C(0x7F) << 23 | (uint32_t) ( next(seed) >> 41) }; return u.d - 1.0f; }