com.numericalmethod.suanshu.stats.random.concurrent

Class ConcurrentCachedRLG

java.lang.Object

com.numericalmethod.suanshu.stats.random.concurrent.ConcurrentCachedRLG

All Implemented Interfaces:

RandomLongGenerator, RandomNumberGenerator, java.io.Serializable

public class ConcurrentCachedRLG
extends java.lang.Object
implements RandomLongGenerator

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

See Also:

Serialized Form

Constructor Summary

Constructors

Constructor and Description
ConcurrentCachedRLG(RandomLongGenerator rlg) Construct a new instance which wraps the given random long generator and uses a cache which has 8 entries per available core.
ConcurrentCachedRLG(RandomLongGenerator rlg, int cacheSize) Constructs a new instance which wraps the given random long generator and uses a cache of the specified size.

Method Summary

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

Methods inherited from class java.lang.Object

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

Constructor Detail

ConcurrentCachedRLG

public ConcurrentCachedRLG(RandomLongGenerator rlg,
                           int cacheSize)

Constructs a new instance which wraps the given random long 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 unnecessary computation of values at the tail.

Parameters:

rlg - the underlying generator

cacheSize - the cache size

See Also:

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

ConcurrentCachedRLG

public ConcurrentCachedRLG(RandomLongGenerator rlg)

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

Parameters:

rlg - the underlying generator

Method Detail

nextLong

public long nextLong()

Description copied from interface: RandomLongGenerator

Get the next random long.

Specified by:

nextLong in interface RandomLongGenerator

Returns:

the next random long

seed

public void seed(long... seeds)

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

Specified by:

seed in interface RandomNumberGenerator

Parameters:

seeds - the seeds

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