/*
Copyright � 1999 CERN - European Organization for Nuclear Research.
Permission to use, copy, modify, distribute and sell this software and its documentation for any purpose
is hereby granted without fee, provided that the above copyright notice appear in all copies and
that both that copyright notice and this permission notice appear in supporting documentation.
CERN makes no representations about the suitability of this software for any purpose.
It is provided "as is" without expressed or implied warranty.
*/
package cern.jet.random.engine;
/**
* Deterministic seed generator for pseudo-random number generators.
* The sole purpose of this class is to decorrelate seeds and uniform random number generators.
* (If a generator would be used to generate seeds for itself, the result could be correlations.)
* <p>
* This class has entirelly deterministic behaviour:
* Constructing two instances with the same parameters at any two distinct points in time will produce identical seed sequences.
* However, it does not (at all) generate uniformly distributed numbers. Do not use it as a uniformly distributed random number generator!
* <p>
* Each generated sequence of seeds has a period of 10<sup>9</sup> numbers.
* Internally uses {@link RandomSeedTable}.
*
* @author wolfgang.hoschek@cern.ch
* @version 1.0, 09/24/99
*/
public class RandomSeedGenerator extends cern.colt.PersistentObject {
protected int row;
protected int column;
/**
* Constructs and returns a new seed generator.
*/
public RandomSeedGenerator() {
this(0,0);
}
/**
* Constructs and returns a new seed generator; you normally won't need to use this method.
* <p>
* The position <tt>[row,column]</tt> indicates the iteration starting point within a (virtual) seed matrix.
* The seed matrix is a n*m matrix with <tt>1 + Integer.MAX_VALUE</tt> (virtual) rows and <tt>RandomSeedTable.COLUMNS</tt> columns.
* Successive calls to method <tt>nextSeed()</tt> will cycle over the given column, in ascending order:
* <tt>nextSeed()</tt> returns the seed <tt>s[row,column], s[row+1,column], ... s[Integer.MAX_VALUE,column], s[0,column], s[1,column], ...</tt>
*
* @param row should be in <tt>[0,Integer.MAX_VALUE]</tt>.
* @param column should be in <tt>[0,RandomSeedTable.COLUMNS - 1]</tt>.
*/
public RandomSeedGenerator(int row, int column) {
this.row = row;
this.column = column;
}
/**
* Prints the generated seeds for the given input parameters.
*/
public static void main(String args[]) {
int row = Integer.parseInt(args[0]);
int column = Integer.parseInt(args[1]);
int size = Integer.parseInt(args[2]);
new RandomSeedGenerator(row,column).print(size);
}
/**
* Returns the next seed.
*/
public int nextSeed() {
return RandomSeedTable.getSeedAtRowColumn(row++, column);
}
/**
* Prints the next <tt>size</tt> generated seeds.
*/
public void print(int size) {
System.out.println("Generating "+size+" random seeds...");
RandomSeedGenerator copy = (RandomSeedGenerator) this.clone();
for (int i=0; i<size; i++) {
int seed = copy.nextSeed();
System.out.println(seed);
}
System.out.println("\ndone.");
}
}