com.numericalmethod.suanshu.stats.random.concurrent

Class ConcurrentCachedRNG

java.lang.Object

com.numericalmethod.suanshu.stats.random.concurrent.ConcurrentCachedRNG

All Implemented Interfaces:

RandomNumberGenerator, java.io.Serializable

public class ConcurrentCachedRNG
extends java.lang.Object
implements RandomNumberGenerator

This is a fast thread-safe wrapper for random number generators. This class is backed by ConcurrentCachedGenerator.

See Also:

Serialized Form

Constructor Summary

Constructors

Constructor and Description
ConcurrentCachedRNG(RandomNumberGenerator rng) Construct a new instance which wraps the given random number generator and uses a cache which has 8 entries per available core.
ConcurrentCachedRNG(RandomNumberGenerator rng, int cacheSize) Constructs a new instance which wraps the given random number generator and uses a cache of the specified size.

Method Summary

Modifier and Type	Method and Description
double	nextDouble() Get the next random double.
void	seed(long... seeds) Delegate to the underlying random number generator.

Methods inherited from class java.lang.Object

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

Constructor Detail

ConcurrentCachedRNG

public ConcurrentCachedRNG(RandomNumberGenerator rng,
                           int cacheSize)

Constructs a new instance which wraps the given random number generator and uses a cache of the specified size. A larger cache will make the simulation slightly faster at the expense of increased memory usage, but can lead to the computation of unnecessary values at the tail.

Parameters:

rng - the underlying generator

cacheSize - the cache size

See Also:

ConcurrentCachedGenerator.ConcurrentCachedGenerator(com.numericalmethod.suanshu.stats.random.concurrent.ConcurrentCachedGenerator.Generator, int)

ConcurrentCachedRNG

public ConcurrentCachedRNG(RandomNumberGenerator rng)

Construct a new instance which wraps the given random number generator and uses a cache which has 8 entries per available core.

Parameters:

rng - the underlying generator

Method Detail

nextDouble

public double nextDouble()

Description copied from interface: RandomNumberGenerator

Get the next random double.

Specified by:

nextDouble in interface RandomNumberGenerator

Returns:

the next random number

seed

public void seed(long... seeds)

Delegate to the underlying random number generator. Note: this method is NOT thread-safe.

Specified by:

seed in interface RandomNumberGenerator

Parameters:

seeds - the seeds