Releases: libmir/mir-random
Add .save property to XoshiroEngine, Xoroshiro128Plus, PermutedCongruentialEngine, and PhobosRandom wrapper
Makes mir.random
PRNGs that satisfy Phobos std.random.isUniformRNG
also satisfy std.range.primitives.isForwardRange
. Affected PRNGs and templates:
mir.random.engine.xoshiro
:Xoshiro256StarStar
,Xoshiro128StarStar_32
,Xoroshiro128Plus
,XoshiroEngine
.mir.random.engine.pcg
:pcg32
,pcg32_oneseq
,pcg32_fast
,pcg8_once_insecure
,pcg16_once_insecure
,pcg32_once_insecure
,pcg64_once_insecure
,pcg8_oneseq_once_insecure
,pcg16_oneseq_once_insecure
,pcg32_oneseq_once_insecure
,pcg64_oneseq_once_insecure
;PermutedCongruentialEngine
as long asoutput_previous
is true andstreamType
is notstream_t.unique
.mir.random.engine.PhobosRandom!Engine
as long as the representation ofEngine
contains no pointers other than function pointers and itsopCall()
and destructor (if any) are@safe
andpure
. All PRNGs defined inmir.random
meet these conditions.
Prior to this the only mir.random
PRNGs that implemented .save
were mir.random.engine.splitmix.SplitMix64
and Splittable64
.
v2.2.10: Upgrade pyd to v0.13.0 (#121)
* Upgrade pyd to v0.13.0 Use a newer version which does not depend on class deallocator. * List dub explicitly to work around segfault
Optional Mir Algorithm dependency
v2.1.0 Mark mir.random.variable & mir.random.ndvariable opCall as const when…
v2.0.0
API and safety improvements
- default params from random variable constructors was removed
- convention functions for random variable construction were added
randomSlice
was added tomir.random.algorithm
field
API rework for complex numbers- default engine
rne
was added to some algorithms
Fix 32bit DMD `double` generation.
v0.3.6 fix travis config
API Improvements
Most of the API is duplicated to be used with default thread-local random engine. See also the first example in the README.
v0.3.0
Release v0.3.0
Performance Increases
We now use Daniel Lemire's fast alternative to modulo reduction. Compiling with LDC 1.6.0 for x86-64, Mt19937_64 randIndex
throughput increased 40% for uint and 136% for ulong. Xoroshiro128Plus randIndex
throughput increased 73% for uint and 325% for ulong.
The required mir-algorithm version has increased to v0.7.0 because extMul is necessary for the ulong version.
New since v0.2.8:
- New engine: SplitMix64 / Splittable64
- Convenience functions related to thread-local randoms:
rne
(like std.randomrndGen
);threadLocal!Engine
for arbitrary engine; & ways of mucking about with the bookkeeping state that most people won't need but a few have requested in the past. - Made some engines compatible with APIs that expect std.random-style UniformRNG. Compatible as-is: Xoroshiro128Plus; all predefined PCG engines; and the new SplitMix64/Splittable64 engines. For any others there is an adaptor. Copy-constructors are disabled so they will only work with functions that "do the right thing" and take PRNGs by reference and don't make implicit copies of them.
Fixed since v0.2.8:
- Changed many parts of the library to be
@safe
. - Linux
GETRANDOM
inunpredictableSeed
now works on non-x86/x86-64 architectures. - Removed endian-dependency when producing 64-bit values from a native-32-bit PRNG.
Changed APIs
- The versions of
genRandomBlocking
/genRandomNonBlocking
that take a pointer and a length are no longer@trusted
. Instead there are trusted overloads for both that take aubyte[]
. mir.random.algorithm
has been changed in the interest of memory safety. You can still write unsafe code but now if you try to write@safe
code the library will let you. Instead of taking engines by reference and storing their addresses (which could result in the stored address outliving the engine), instead the various functions require arguments to be either objects or pointers to structs. For local-scoped engines there are templates with alias parameters. This is a major API change so feedback/criticism is welcome.
v0.2.8
Release v0.2.8
Additions:
- Added xorshift1024*φ and xoroshiro128+ generators (
mir.random.engine.xorshift : Xorshift1024StarPhi, Xoroshiro128Plus
) Mt19937
andMt19937_64
can be seeded from array or ndslicemir.random.engine.preferHighBits!T
to query new optional enumpreferHighBits
Improvements:
- When the high bits of a PRNG's output are known to have better statistical properties than the low bits, use high bits when not all bits of output are required.
- On macOS, OpenBSD, and NetBSD, use arc4random_buf in
unpredictableSeed
andgenRandomNonBlocking
.
Bugfixes:
- Fix
isSaturatedRandomEngine!T
not working whenT.opCall
is a function template. - Fix address-based increment for PCGs in unique_stream mode.
- Incorporated upstream fix for seeding a MCG with a seed that's a multiple of the modulus.
Major additions
- System level
genRandomNonBlocking
andgenRandomBlocking
was added tomir.random.engine
by Sebastian Wilzbach (@wilzbach).unpredictableSeed
became more secure. - Permuted Congruential Generator (PCG) was added by Nicholas Wilson (@thewilsonator) After a while it will replace Mersenne Twister for default engine (
Random
alias). SphereVariable
,SimplexVariable
,DirichletVariable
, andMultivariateNormalVariable
was added tomir.random.ndvariable
by Simon Bürger (@krox). Multivariate normal RNG uses private Cholesky decomposition, which has not unittests yet. PRs are welcome.