utils.edu.cornell.lassp.houle.rngPack

Class RandomShuffle

java.lang.Object

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

utils.edu.cornell.lassp.houle.rngPack.RandomShuffle

All Implemented Interfaces:

java.lang.Cloneable

public class RandomShuffle
extends RandomElement

RandomShuffle uses one random number generator to shuffle the numbers produced by another to obliterate sequential correlations. To initialize a RandomShuffle, pass it two RandomElements. The first RandomElement is used to generate a table of random numbers and the second is used to choose one from the table. An example of usage is,

 RandomElement markov=new RandomShuffle(new Ranecu(),new Ranmar(),32)
 

which would generate a deck of 32 numbers from RANECU and use RANMAR to choose from the deck.
References:

• F. James; Comp. Phys. Comm. 60 (1990) p 329-344
• D. Knuth; The Art of Computer Programming vol. 2, sec 3.2.2

Source code is available.

Author:

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

Field Summary

Fields

Modifier and Type	Field and Description
(package private) double[]	deck
(package private) int	decksize
(package private) RandomElement	generatorA
(package private) RandomElement	generatorB

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

BMoutput

Constructor Summary

Constructors

Constructor and Description
RandomShuffle(RandomElement ga, RandomElement gb, int ds)

Method Summary

Modifier and Type	Method and Description
double	raw() The generator.
private void	stackdeck()

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

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

Methods inherited from class java.lang.Object

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

Field Detail

generatorA

RandomElement generatorA

generatorB

RandomElement generatorB

decksize

int decksize

deck

double[] deck

Constructor Detail

RandomShuffle

public RandomShuffle(RandomElement ga,
                     RandomElement gb,
                     int ds)

Parameters:

ga - generator to fill shuffle deck

gb - geberator to choose from shuffle deck

ds - the size of the shuffle deck

Method Detail

raw

public double raw()

The generator.

Specified by:

raw in class RandomElement

Returns:

a random double in the range [0,1]

See Also:

RandomElement.raw()

stackdeck

private void stackdeck()