gpu_rand

Module xoroshiro

Source
Expand description

Xoroshiro pseudorandom generators, Fast, fairly random, and small-state.

§64-bit generators

  • Xoshiro256StarStar: Recommended for all purposes. Excellent speed and a state space (256 bits) large enough for any parallel application.
  • Xoshiro256PlusPlus: Recommended for all purposes. Excellent speed and a state space (256 bits) large enough for any parallel application.
  • Xoshiro256Plus: Recommended for generating 64-bit floating-point numbers. About 15% faster than Xoshiro256StarStar, but has a low linear complexity in the lowest bits (which are discarded when generating floats), making it fail linearity tests. This is unlikely to have any impact in practice.
  • Xoroshiro128StarStar: An alternative to Xoshiro256StarStar, having the same speed but using half the state. Only suited for low-scale parallel applications.
  • Xoroshiro128PlusPlus: An alternative to Xoshiro256PlusPlus, having the same speed but using half the state. Only suited for low-scale parallel applications.
  • Xoroshiro128Plus: An alternative to Xoshiro256Plus, having the same speed but using half the state. Only suited for low-scale parallel applications. Has a low linear complexity in the lowest bits (which are discarded when generating floats), making it fail linearity tests. This is unlikely to have any impact in practice.
  • Xoshiro512StarStar: An alternative to Xoshiro256StarStar with more state and the same speed.
  • Xoshiro512PlusPlus: An alternative to Xoshiro256PlusPlus with more state and the same speed.
  • Xoshiro512Plus: An alternative to Xoshiro512Plus with more state and the same speed. Has a low linear complexity in the lowest bits (which are discarded when generating floats), making it fail linearity tests. This is unlikely to have any impact in practice.
  • SplitMix64: Recommended for initializing generators of the xoshiro familiy from a 64-bit seed. Used for implementing seed_from_u64.

§32-bit generators

  • Xoshiro128StarStar: Recommended for all purposes. Excellent speed.
  • Xoshiro128PlusPlus: Recommended for all purposes. Excellent speed.
  • Xoshiro128Plus: Recommended for generating 32-bit floating-point numbers. Faster than Xoshiro128StarStar, but has a low linear complexity in the lowest bits (which are discarded when generating floats), making it fail linearity tests. This is unlikely to have any impact in practice.
  • Xoroshiro64StarStar: An alternative to Xoshiro128StarStar, having the same speed but using half the state.
  • Xoroshiro64Star: An alternative to Xoshiro128Plus, having the same speed but using half the state. Has a low linear complexity in the lowest bits (which are discarded when generating floats), making it fail linearity tests. This is unlikely to have any impact in practice.

The *PlusPlus generators perform similarily to the *StarStar generators. See the xoshiro paper, where the differences are discussed in detail.

Re-exports§

pub use rand_core;

Structs§

Seed512
512-bit seed for a generator.
SplitMix64
A splitmix64 random number generator.
Xoroshiro64Star
A xoroshiro64* random number generator.
Xoroshiro64StarStar
A xoroshiro64** random number generator.
Xoroshiro128Plus
A xoroshiro128+ random number generator.
Xoroshiro128PlusPlus
A xoroshiro128++ random number generator.
Xoroshiro128StarStar
A xoroshiro128** random number generator.
Xoshiro128Plus
A xoshiro128+ random number generator.
Xoshiro128PlusPlus
A xoshiro128++ random number generator.
Xoshiro128StarStar
A xoshiro128** random number generator.
Xoshiro256Plus
A xoshiro256+ random number generator.
Xoshiro256PlusPlus
A xoshiro256++ random number generator.
Xoshiro256StarStar
A xoshiro256** random number generator.
Xoshiro512Plus
A xoshiro512+ random number generator.
Xoshiro512PlusPlus
A xoshiro512++ random number generator.
Xoshiro512StarStar
A xoshiro512** random number generator.