utils.edu.cornell.lassp.houle.rngPack

Class RandomSynchronized

java.lang.Object

utils.edu.cornell.lassp.houle.rngPack.RandomElement

utils.edu.cornell.lassp.houle.rngPack.RandomSynchronized

All Implemented Interfaces:

java.io.Serializable, java.lang.Cloneable

public abstract class RandomSynchronized
extends RandomElement
implements java.io.Serializable

RandomSynchronized is a wrapper class that makes a random number generator safe for multi-threaded operation by serializing access in time. For high-performance applications, it is better for each thread to have it's own random number generator. Note this class is declared serializable, but serialization won't be successful if it's wrapping a non-serializable generator.

Source code is available.

Author:

Paul Houle (E-mail: paul@honeylocust.com)

See Also:

RandomElement, Serialized Form

Field Summary

Fields

Modifier and Type	Field and Description
private RandomElement	rng

Fields inherited from class utils.edu.cornell.lassp.houle.rngPack.RandomElement

BMoutput

Constructor Summary

Constructors

Constructor and Description
RandomSynchronized(RandomElement rng)

Method Summary

Modifier and Type	Method and Description
int	choose(int lo, int hi) Wrapped so generators can override.
double	gaussian() Must be synchronized because state is stored in BMoutput
double	raw() Synchronized the raw() method, which is generally not threadsafe.
void	raw(double[] d, int n) This method probably isn't threadsafe in implementations, so it's synchronized
private void	readObject(java.io.ObjectInputStream in)
private void	writeObject(java.io.ObjectOutputStream out) We wouldn't want some sneaky person to serialize this in the middle of generating a number

Methods inherited from class utils.edu.cornell.lassp.houle.rngPack.RandomElement

choose, clone, coin, coin, gaussian, powlaw, raw, uniform

Methods inherited from class java.lang.Object

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

Field Detail

rng

private RandomElement rng

Constructor Detail

RandomSynchronized

public RandomSynchronized(RandomElement rng)

Method Detail

raw

public double raw()

Synchronized the raw() method, which is generally not threadsafe.

Specified by:

raw in class RandomElement

Returns:

a random double in the range [0,1]

See Also:

RandomJava

raw

public void raw(double[] d,
                int n)

This method probably isn't threadsafe in implementations, so it's synchronized

Overrides:

raw in class RandomElement

Parameters:

d - array to be filled with doubles

n - number of doubles to generate

choose

public int choose(int lo,
                  int hi)

Wrapped so generators can override.

Overrides:

choose in class RandomElement

Parameters:

lo - lower limit of range

hi - upper limit of range

Returns:

a random integer in the range lo, lo+1, ... ,hi

gaussian

public double gaussian()

Must be synchronized because state is stored in BMoutput

Overrides:

gaussian in class RandomElement

Returns:

a random real with a gaussian distribution, standard deviation

writeObject

private void writeObject(java.io.ObjectOutputStream out)
                  throws java.io.IOException

We wouldn't want some sneaky person to serialize this in the middle of generating a number

Throws:

java.io.IOException

readObject

private void readObject(java.io.ObjectInputStream in)
                 throws java.io.IOException,
                        java.lang.ClassNotFoundException

Throws:

java.io.IOException

java.lang.ClassNotFoundException