math.rng

Class Lcg64Xor1024Mix

java.lang.Object

math.rng.AbstractRng64

math.rng.Lcg64Xor1024Mix

All Implemented Interfaces:

PseudoRandom, PseudoRandomStream, SplittablePseudoRandom

public class Lcg64Xor1024Mix
extends AbstractRng64
implements SplittablePseudoRandom

The L64X1024MixRandom algorithm from JDK 17 which uses a linear congruential generator (LCG) as a first subgenerator and a Xor-based generator (xoroshiro1024) as a second subgenerator and then applies a 64-bit mixing function identified by Doug Lea.

This generator has a 1088-bit state and a period of 2⁶⁴(2¹⁰²⁴−1).

This generator is 16-dimensionally equidistributed.

Field Summary

Fields inherited from class math.rng.AbstractRng64

DOUBLE_NORM, FLOAT_NORM, nextGaussian, unused

Constructor Summary

Constructors

Modifier	Constructor and Description
	Lcg64Xor1024Mix()
	Lcg64Xor1024Mix(long seed)
	Lcg64Xor1024Mix(long[] seed)
protected	Lcg64Xor1024Mix(long a, long s, long[] seed)

Method Summary

Modifier and Type	Method and Description
static SplittablePseudoRandom	getDefault()
long	nextLong()
Lcg64Xor1024Mix	split() Constructs and returns a new SplittablePseudoRandom instance that shares no mutable state with the current instance.

Methods inherited from class math.rng.AbstractRng64

beta, beta, cauchy, cauchy, chiSquare, chiSquare, doubles, doubles, doubles, doubles, exponential, exponential, gamma, gamma, getAlgorithm, getSeed, ints, ints, ints, ints, logNormal, logNormal, longs, longs, longs, longs, next, nextBoolean, nextBytes, nextDouble, nextDouble, nextDoubles, nextFloat, nextFloat, nextGaussian, nextGaussian, nextInt, nextInt, nextInt, nextLong, nextLong, nextLongs, normal, normal, saveSeed, saveSeed, studentT, studentT, weibull, weibull

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface math.rng.PseudoRandom

getAlgorithm, getSeed, next, nextBoolean, nextBytes, nextDouble, nextDouble, nextDoubles, nextFloat, nextFloat, nextGaussian, nextGaussian, nextInt, nextInt, nextInt, nextLong, nextLong, nextLongs

Methods inherited from interface math.rng.PseudoRandomStream

beta, beta, cauchy, cauchy, chiSquare, chiSquare, doubles, doubles, doubles, doubles, exponential, exponential, gamma, gamma, ints, ints, ints, ints, logNormal, logNormal, longs, longs, longs, longs, normal, normal, studentT, studentT, weibull, weibull

Constructor Detail

Lcg64Xor1024Mix

public Lcg64Xor1024Mix()

Lcg64Xor1024Mix

public Lcg64Xor1024Mix(long seed)

Lcg64Xor1024Mix

public Lcg64Xor1024Mix(long[] seed)

Lcg64Xor1024Mix

protected Lcg64Xor1024Mix(long a,
                          long s,
                          long[] seed)

Method Detail

split

public Lcg64Xor1024Mix split()

Description copied from interface: SplittablePseudoRandom

Constructs and returns a new SplittablePseudoRandom instance that shares no mutable state with the current instance. However, with very high probability, the values collectively generated by the two instances have the same statistical properties as if the same quantity of values were generated by a single thread using a single SplittablePseudoRandom instance. Instances of SplittablePseudoRandom are not thread-safe. They are designed to be split, not shared, across threads.

Specified by:

split in interface SplittablePseudoRandom

Returns:

a new SplittablePseudoRandom instance that shares no mutable state with the current instance

nextLong

public final long nextLong()

Specified by:

nextLong in interface PseudoRandom

Specified by:

nextLong in class AbstractRng64

getDefault

public static SplittablePseudoRandom getDefault()