org.apache.commons.rng.examples.stress

Class RandomStressTester

java.lang.Object

org.apache.commons.rng.examples.stress.RandomStressTester

public class RandomStressTester
extends Object

Class that can be used for testing a generator by piping the values returned by its UniformRandomProvider.nextInt() method to a program that reads int values from its standard input and writes an analysis report to standard output. The "dieharder" test suite is such a software. Example of command line, assuming that "examples.jar" specifies this class as the "main" class (see main method):

  $ java -jar examples.jar \
    report/dh_ \
    4 \
    org.apache.commons.rng.examples.stress.GeneratorsList \
    /usr/bin/dieharder -a -g 200 -Y 1 -k 2
 

Method Summary

Modifier and Type	Method and Description
static void	main(String[] args) Program's entry point.

Methods inherited from class java.lang.Object

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

Method Detail

main

public static void main(String[] args)

Program's entry point.

Parameters:

args - Application's arguments. The order is as follows:

1. Output prefix: Filename prefix where the output of the analysis will written to. The appended suffix is the index of the instance within the list of generators to be tested.
2. Number of threads to use concurrently: One thread will process one of the generators to be tested.
3. Name of a class that implements Iterable<UniformRandomProvider> (and defines a default constructor): Each generator of the list will be tested by one instance of the analyzer program
4. Path to the executable: this is the analyzer software that reads 32-bits integers from stdin.
5. All remaining arguments are passed to the executable.