mir-random 2.2.16
Dlang Random Number Generators
To use this package, run the following command in your project's root directory:
Manual usage
Put the following dependency into your project's dependences section:
mir-random
Advanced Random Number Generators
Documentation - http://mir-random.libmir.org/
This library is for general-purpose random number generation. Do not use it for cryptography or secret generation.
Example (3 seconds)
void main()
{
import mir.random;
import mir.random.variable: normalVar;
import mir.random.algorithm: randomSlice;
auto sample = normalVar.randomSlice(10);
import std.stdio;
sample[$.randIndex].writeln;
}
Example (10 seconds)
void main()
{
import mir.random;
import mir.random.variable: normalVar;
import mir.random.algorithm: randomSlice;
// Engines are allocated on stack or global
auto rng = Random(unpredictableSeed);
auto sample = rng.randomSlice(normalVar, 10);
import std.stdio;
sample[rng.randIndex($)].writeln;
}
Comparison with Phobos
- Does not depend on DRuntime (Better C concept)
random
(new implementation and API)
- Mir Random
rand!float
/rand!double
/rand!real
generates saturated real random numbers in(-1, 1)
. For example,rand!real
can produce more than 2^78 unique numbers. In other hand,std.random.uniform01!real
produces less than2^31
unique numbers with default Engine. - Mir Random fixes Phobos integer underflow bugs.
- Additional optimization was added for enumerated types.
- Random nd-array (ndslice) generation.
- Bounded integer generation in
randIndex
uses Daniel Lemire's fast alternative to modulo reduction. The throughput increase measured forrandIndex!uint
on an x86-64 processor compiled with LDC 1.6.0 was 1.40x forMt19937_64
and 1.73x forXoroshiro128Plus
. The throughput increase measured forrandIndex!ulong
was 2.36x forMt19937_64
and 4.25x forXoroshiro128Plus
.
random.variable
(new)
- Uniform
- Exponential
- Gamma
- Normal
- Cauchy
- ...
random.ndvariable
(new)
- Simplex
- Sphere
- Multivariate Normal
- ...
random.algorithm
(new)
- Ndslice and range API adaptors
random.engine.*
(fixed, reworked, new)
opCall
API instead of range interface is used (similar to C++)- No default and copy constructors are allowed for generators.
unpredictableSeed
has not state, returnssize_t
unpredictableSeed!UIntType
overload for seeds of any unsigned type (merged to Phobos)- Any unsigned generators are allowed.
min
property was removed. Any integer generator can normalize its minimum down to zero.- Mt19937: +100% performance for initialization. (merged to Phobos)
- Mt19937: +54% performance for generation. (merged to Phobos)
- Mt19937: fixed to be more CPU cache friendly. (merged to Phobos)
- 64-bit Mt19937 initialization is fixed (merged to Phobos)
- 64-bit Mt19937 is default for 64-bit targets
- Permuted Congruential Generators (new)
- SplitMix generators (new)
- Fixed XorshiftEngine's support for non-
uint
word sizes & allow various shift directions (merged to Phobos) - XorshiftStar Generators (new)
- Xoroshiro128Plus generator (new)
- Xoshiro256StarStar & Xoshiro128StarStar_32 generators (new)
- Registered by Ilia Ki
- 2.2.16 released 3 years ago
- libmir/mir-random
- BSL-1.0 (default), Apache License, Version 2.0 for PCG
- Copyright © 2016-2018, Ilya Yaroshenko (default), see also copyright per file
- Authors:
- Dependencies:
- mir-core, mir-linux-kernel
- Versions:
-
2.2.19 2021-Sep-01 2.2.18 2021-May-20 2.2.17 2021-May-20 2.2.16 2021-Mar-22 2.2.15 2020-Sep-01 - Download Stats:
-
-
34 downloads today
-
383 downloads this week
-
1430 downloads this month
-
305231 downloads total
-
- Score:
- 4.8
- Short URL:
- mir-random.dub.pm