Package org.moeaframework.parallel.util

Class ThreadLocalMersenneTwister

java.lang.Object

java.util.Random

org.moeaframework.parallel.util.ThreadLocalMersenneTwister

All Implemented Interfaces:

Serializable, RandomGenerator

public class ThreadLocalMersenneTwister
extends Random

A thread-safe version of the MersenneTwister random number generator (RNG). Each thread is assigned a unique instance of the RNG with its own seed. To use:

   PRNG.setRandom(ThreadLocalMersenneTwister.getInstance());
 

Note: Java also has the that can provide similar access to random numbers across threads. The Mersenne Twister, however, has better characteristics (extremely long period, high equidistribution, etc.).

See Also:

• Serialized Form

Nested Class Summary

Nested classes/interfaces inherited from interface java.util.random.RandomGenerator

RandomGenerator.ArbitrarilyJumpableGenerator, RandomGenerator.JumpableGenerator, RandomGenerator.LeapableGenerator, RandomGenerator.SplittableGenerator, RandomGenerator.StreamableGenerator

Method Summary

Modifier and Type	Method	Description
static ThreadLocalMersenneTwister	getInstance()	Returns the singleton instance of this synchronized Mersenne Twister RNG.
boolean	nextBoolean()
void	nextBytes(byte[] bytes)
double	nextDouble()
float	nextFloat()
double	nextGaussian()
int	nextInt()
int	nextInt(int n)
long	nextLong()
void	setSeed(long seed)

Methods inherited from class java.util.Random

doubles, doubles, doubles, doubles, ints, ints, ints, ints, longs, longs, longs, longs, next

Methods inherited from class java.lang.Object

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

Methods inherited from interface java.util.random.RandomGenerator

isDeprecated, nextDouble, nextDouble, nextExponential, nextFloat, nextFloat, nextGaussian, nextInt, nextLong, nextLong

Method Details

getInstance

public static ThreadLocalMersenneTwister getInstance()

Returns the singleton instance of this synchronized Mersenne Twister RNG.

Returns:

the singleton instance

setSeed

public void setSeed(long seed)

Overrides:

setSeed in class Random

nextBytes

public void nextBytes(byte[] bytes)

Specified by:

nextBytes in interface RandomGenerator

Overrides:

nextBytes in class Random

nextInt

public int nextInt()

Specified by:

nextInt in interface RandomGenerator

Overrides:

nextInt in class Random

nextInt

public int nextInt(int n)

Specified by:

nextInt in interface RandomGenerator

Overrides:

nextInt in class Random

nextLong

public long nextLong()

Specified by:

nextLong in interface RandomGenerator

Overrides:

nextLong in class Random

nextBoolean

public boolean nextBoolean()

Specified by:

nextBoolean in interface RandomGenerator

Overrides:

nextBoolean in class Random

nextFloat

public float nextFloat()

Specified by:

nextFloat in interface RandomGenerator

Overrides:

nextFloat in class Random

nextDouble

public double nextDouble()

Specified by:

nextDouble in interface RandomGenerator

Overrides:

nextDouble in class Random

nextGaussian

public double nextGaussian()

Specified by:

nextGaussian in interface RandomGenerator

Overrides:

nextGaussian in class Random