org.openimaj.data

Class RandomData

java.lang.Object

org.openimaj.data.RandomData

public class RandomData
extends Object

Utility functions for creating random data

Author:

Jonathon Hare (jsh2@ecs.soton.ac.uk)

Constructor Summary

Constructors

Constructor and Description
RandomData()

Method Summary

Modifier and Type	Method and Description
static byte[]	getRandomByteArray(int length, byte min, byte max) Returns a one dimensional array of pseudorandom, uniformly distributed byte values between min (inclusive) and max (exclusive), drawn from this random number generator's sequence.
static byte[]	getRandomByteArray(int length, byte min, byte max, int seed) Returns a one dimensional array of pseudorandom, uniformly distributed byte values between min (inclusive) and max (exclusive), drawn from this random number generator's sequence.
static byte[]	getRandomByteArray(int length, byte min, byte max, cern.jet.random.engine.MersenneTwister mt) Returns a one dimensional array of pseudorandom, uniformly distributed byte values between min (inclusive) and max (exclusive), drawn from this random number generator's sequence.
static byte[][]	getRandomByteArray(int rows, int cols, byte min, byte max) Returns a two dimensional array of pseudorandom, uniformly distributed byte values between min (inclusive) and max (exclusive), drawn from this random number generator's sequence.
static byte[][]	getRandomByteArray(int rows, int cols, byte min, byte max, int seed) Returns a two dimensional array of pseudorandom, uniformly distributed byte values between min (inclusive) and max (exclusive), drawn from this random number generator's sequence.
static double[]	getRandomDoubleArray(int length, double min, double max) Returns a one dimensional array of pseudorandom, uniformly distributed double values between min (inclusive) and max (exclusive), drawn from this random number generator's sequence.
static double[]	getRandomDoubleArray(int length, double min, double max, int seed) Returns a one dimensional array of pseudorandom, uniformly distributed double values between min (inclusive) and max (exclusive), drawn from this random number generator's sequence.
static double[]	getRandomDoubleArray(int length, double min, double max, cern.jet.random.engine.MersenneTwister mt) Returns a one dimensional array of pseudorandom, uniformly distributed double values between min (inclusive) and max (exclusive), drawn from this random number generator's sequence.
static double[][]	getRandomDoubleArray(int rows, int cols, double min, double max) Returns a two dimensional array of pseudorandom, uniformly distributed double values between min (inclusive) and max (exclusive), drawn from this random number generator's sequence.
static double[][]	getRandomDoubleArray(int rows, int cols, double min, double max, int seed) Returns a two dimensional array of pseudorandom, uniformly distributed double values between min (inclusive) and max (exclusive), drawn from this random number generator's sequence.
static float[]	getRandomFloatArray(int length, float min, float max) Returns a one dimensional array of pseudorandom, uniformly distributed float values between min (inclusive) and max (exclusive), drawn from this random number generator's sequence.
static float[]	getRandomFloatArray(int length, float min, float max, int seed) Returns a one dimensional array of pseudorandom, uniformly distributed float values between min (inclusive) and max (exclusive), drawn from this random number generator's sequence.
static float[]	getRandomFloatArray(int length, float min, float max, cern.jet.random.engine.MersenneTwister mt) Returns a one dimensional array of pseudorandom, uniformly distributed float values between min (inclusive) and max (exclusive), drawn from this random number generator's sequence.
static float[][]	getRandomFloatArray(int rows, int cols, float min, float max) Returns a two dimensional array of pseudorandom, uniformly distributed float values between min (inclusive) and max (exclusive), drawn from this random number generator's sequence.
static float[][]	getRandomFloatArray(int rows, int cols, float min, float max, int seed) Returns a two dimensional array of pseudorandom, uniformly distributed float values between min (inclusive) and max (exclusive), drawn from this random number generator's sequence.
static int[]	getRandomIntArray(int length, int min, int max) Returns a one dimensional array of pseudorandom, uniformly distributed int values between min (inclusive) and max (exclusive), drawn from this random number generator's sequence.
static int[]	getRandomIntArray(int length, int min, int max, int seed) Returns a one dimensional array of pseudorandom, uniformly distributed int values between min (inclusive) and max (exclusive), drawn from this random number generator's sequence.
static int[][]	getRandomIntArray(int rows, int cols, int min, int max, int seed) Returns a two dimensional array of pseudorandom, uniformly distributed int values between min (inclusive) and max (exclusive), drawn from this random number generator's sequence.
static int[]	getRandomIntArray(int length, int min, int max, cern.jet.random.engine.MersenneTwister mt) Returns a one dimensional array of pseudorandom, uniformly distributed int values between min (inclusive) and max (exclusive), drawn from this random number generator's sequence.
static long[][]	getRandomLongArray(int rows, int cols, long min, long max) Returns a two dimensional array of pseudorandom, uniformly distributed long values between min (inclusive) and max (exclusive), drawn from this random number generator's sequence.
static long[][]	getRandomLongArray(int rows, int cols, long min, long max, int seed) Returns a two dimensional array of pseudorandom, uniformly distributed long values between min (inclusive) and max (exclusive), drawn from this random number generator's sequence.
static long[]	getRandomLongArray(int length, long min, long max) Returns a one dimensional array of pseudorandom, uniformly distributed long values between min (inclusive) and max (exclusive), drawn from this random number generator's sequence.
static long[]	getRandomLongArray(int length, long min, long max, int seed) Returns a one dimensional array of pseudorandom, uniformly distributed long values between min (inclusive) and max (exclusive), drawn from this random number generator's sequence.
static long[]	getRandomLongArray(int length, long min, long max, cern.jet.random.engine.MersenneTwister mt) Returns a one dimensional array of pseudorandom, uniformly distributed long values between min (inclusive) and max (exclusive), drawn from this random number generator's sequence.
static short[][]	getRandomShortArray(int rows, int cols, short min, short max, int seed) Returns a two dimensional array of pseudorandom, uniformly distributed short values between min (inclusive) and max (exclusive), drawn from this random number generator's sequence.
static short[]	getRandomShortArray(int length, short min, short max, int seed) Returns a one dimensional array of pseudorandom, uniformly distributed short values between min (inclusive) and max (exclusive), drawn from this random number generator's sequence.
static short[]	getRandomShortArray(int length, short min, short max, cern.jet.random.engine.MersenneTwister mt) Returns a one dimensional array of pseudorandom, uniformly distributed short values between min (inclusive) and max (exclusive), drawn from this random number generator's sequence.
static int[]	getUniqueRandomInts(int N, int min, int max) Returns an array of N unique pseudorandom, uniformly distributed int values between min (inclusive) and max (exclusive).
static int[]	getUniqueRandomInts(int N, int min, int max, Random rng) Returns an array of N unique pseudorandom, uniformly distributed int values between min (inclusive) and max (exclusive).
static int[]	getUniqueRandomIntsA(int N, int min, int max) Returns an array of N unique pseudorandom, uniformly distributed int values between min (inclusive) and max (exclusive).
static int[]	getUniqueRandomIntsA(int N, int min, int max, Random rnd) Returns an array of N unique pseudorandom, uniformly distributed int values between min (inclusive) and max (exclusive).
static int[]	getUniqueRandomIntsS(int N, int min, int max) Returns an array of N unique pseudorandom, uniformly distributed int values between min (inclusive) and max (exclusive).
static int[]	getUniqueRandomIntsS(int N, int min, int max, Random rnd) Returns an array of N unique pseudorandom, uniformly distributed int values between min (inclusive) and max (exclusive).

Methods inherited from class java.lang.Object

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

Constructor Detail

RandomData

public RandomData()

Method Detail

getRandomFloatArray

public static float[][] getRandomFloatArray(int rows,
                                            int cols,
                                            float min,
                                            float max)

Returns a two dimensional array of pseudorandom, uniformly distributed float values between min (inclusive) and max (exclusive), drawn from this random number generator's sequence. The generator is seeded with the time at which the method is called.

Parameters:

rows - number of rows

cols - number of cols

min - minimum value

max - maximum value

Returns:

2d array of random floats

See Also:

Uniform

getRandomFloatArray

public static float[][] getRandomFloatArray(int rows,
                                            int cols,
                                            float min,
                                            float max,
                                            int seed)

Returns a two dimensional array of pseudorandom, uniformly distributed float values between min (inclusive) and max (exclusive), drawn from this random number generator's sequence.

Parameters:

rows - number of rows

cols - number of cols

min - minimum value

max - maximum value

seed - random seed

Returns:

2d array of random floats

See Also:

Uniform

getRandomDoubleArray

public static double[][] getRandomDoubleArray(int rows,
                                              int cols,
                                              double min,
                                              double max)

Returns a two dimensional array of pseudorandom, uniformly distributed double values between min (inclusive) and max (exclusive), drawn from this random number generator's sequence. The generator is seeded with the time at which the method is called.

Parameters:

rows - number of rows

cols - number of cols

min - minimum value

max - maximum value

Returns:

2d array of random doubles

See Also:

Uniform

getRandomDoubleArray

public static double[][] getRandomDoubleArray(int rows,
                                              int cols,
                                              double min,
                                              double max,
                                              int seed)

Returns a two dimensional array of pseudorandom, uniformly distributed double values between min (inclusive) and max (exclusive), drawn from this random number generator's sequence.

Parameters:

rows - number of rows

cols - number of cols

min - minimum value

max - maximum value

seed - random seed

Returns:

2d array of random doubles

See Also:

Uniform

getRandomIntArray

public static int[][] getRandomIntArray(int rows,
                                        int cols,
                                        int min,
                                        int max,
                                        int seed)

Returns a two dimensional array of pseudorandom, uniformly distributed int values between min (inclusive) and max (exclusive), drawn from this random number generator's sequence.

Parameters:

rows - number of rows

cols - number of cols

min - minimum value

max - maximum value

seed - random seed

Returns:

2d array of random ints

See Also:

Uniform

getRandomLongArray

public static long[][] getRandomLongArray(int rows,
                                          int cols,
                                          long min,
                                          long max)

Returns a two dimensional array of pseudorandom, uniformly distributed long values between min (inclusive) and max (exclusive), drawn from this random number generator's sequence. The generator is seeded with the time at which the method is called.

Parameters:

rows - number of rows

cols - number of cols

min - minimum value

max - maximum value

Returns:

2d array of random longs

See Also:

Uniform

getRandomLongArray

public static long[][] getRandomLongArray(int rows,
                                          int cols,
                                          long min,
                                          long max,
                                          int seed)

Returns a two dimensional array of pseudorandom, uniformly distributed long values between min (inclusive) and max (exclusive), drawn from this random number generator's sequence.

Parameters:

rows - number of rows

cols - number of cols

min - minimum value

max - maximum value

seed - random seed

Returns:

2d array of random longs

See Also:

Uniform

getRandomShortArray

public static short[][] getRandomShortArray(int rows,
                                            int cols,
                                            short min,
                                            short max,
                                            int seed)

Returns a two dimensional array of pseudorandom, uniformly distributed short values between min (inclusive) and max (exclusive), drawn from this random number generator's sequence.

Parameters:

rows - number of rows

cols - number of cols

min - minimum value

max - maximum value

seed - random seed

Returns:

2d array of random shorts

See Also:

Uniform

getRandomByteArray

public static byte[][] getRandomByteArray(int rows,
                                          int cols,
                                          byte min,
                                          byte max)

Returns a two dimensional array of pseudorandom, uniformly distributed byte values between min (inclusive) and max (exclusive), drawn from this random number generator's sequence. The generator is seeded with the time at which the method is called.

Parameters:

rows - number of rows

cols - number of cols

min - minimum value

max - maximum value

Returns:

2d array of random bytes

See Also:

Uniform

getRandomByteArray

public static byte[][] getRandomByteArray(int rows,
                                          int cols,
                                          byte min,
                                          byte max,
                                          int seed)

Returns a two dimensional array of pseudorandom, uniformly distributed byte values between min (inclusive) and max (exclusive), drawn from this random number generator's sequence.

Parameters:

rows - number of rows

cols - number of cols

min - minimum value

max - maximum value

seed - random seed

Returns:

2d array of random bytes

See Also:

Uniform

getUniqueRandomIntsA

public static int[] getUniqueRandomIntsA(int N,
                                         int min,
                                         int max)

Returns an array of N unique pseudorandom, uniformly distributed int values between min (inclusive) and max (exclusive). Internally this method creates an array of all the numbers in the range min->max and shuffles. The array is then cropped to N elements.

Parameters:

N - number of unique random numbers

min - minimum value

max - maximum value

Returns:

array of N unique ints

getUniqueRandomIntsS

public static int[] getUniqueRandomIntsS(int N,
                                         int min,
                                         int max)

Returns an array of N unique pseudorandom, uniformly distributed int values between min (inclusive) and max (exclusive). Internally this method uses a hashset to store numbers. The hashset is continually filled with random numbers in the range min->max until its size is N.

Parameters:

N - number of unique random numbers

min - minimum value

max - maximum value

Returns:

array of N unique ints

getUniqueRandomInts

public static int[] getUniqueRandomInts(int N,
                                        int min,
                                        int max)

Returns an array of N unique pseudorandom, uniformly distributed int values between min (inclusive) and max (exclusive). Internally this method chooses between the array and hashset methods depending on the ratio of the range between min and max and the number of ints required.

Parameters:

N - number of unique random numbers

min - minimum value

max - maximum value

Returns:

array of N unique ints

getUniqueRandomIntsA

public static int[] getUniqueRandomIntsA(int N,
                                         int min,
                                         int max,
                                         Random rnd)

Returns an array of N unique pseudorandom, uniformly distributed int values between min (inclusive) and max (exclusive). Internally this method creates an array of all the numbers in the range min->max and shuffles. The array is then cropped to N elements.

Parameters:

N - number of unique random numbers

min - minimum value

max - maximum value

rnd - random generator to use

Returns:

array of N unique ints

getUniqueRandomIntsS

public static int[] getUniqueRandomIntsS(int N,
                                         int min,
                                         int max,
                                         Random rnd)

Returns an array of N unique pseudorandom, uniformly distributed int values between min (inclusive) and max (exclusive). Internally this method uses a hashset to store numbers. The hashset is continually filled with random numbers in the range min->max until its size is N.

Parameters:

N - number of unique random numbers

min - minimum value

max - maximum value

rnd - random generator to use

Returns:

array of N unique ints

getUniqueRandomInts

public static int[] getUniqueRandomInts(int N,
                                        int min,
                                        int max,
                                        Random rng)

Returns an array of N unique pseudorandom, uniformly distributed int values between min (inclusive) and max (exclusive). Internally this method chooses between the array and hashset methods depending on the ratio of the range between min and max and the number of ints required.

Parameters:

N - number of unique random numbers

min - minimum value

max - maximum value

rng - random generator to use

Returns:

array of N unique ints

getRandomFloatArray

public static float[] getRandomFloatArray(int length,
                                          float min,
                                          float max)

Returns a one dimensional array of pseudorandom, uniformly distributed float values between min (inclusive) and max (exclusive), drawn from this random number generator's sequence. The generator is seeded with the time at which the method is called.

Parameters:

length - length of array

min - minimum value

max - maximum value

Returns:

array of random floats

See Also:

Uniform

getRandomFloatArray

public static float[] getRandomFloatArray(int length,
                                          float min,
                                          float max,
                                          int seed)

Returns a one dimensional array of pseudorandom, uniformly distributed float values between min (inclusive) and max (exclusive), drawn from this random number generator's sequence.

Parameters:

length - length of array

min - minimum value

max - maximum value

seed - random seed

Returns:

array of random floats

See Also:

Uniform

getRandomDoubleArray

public static double[] getRandomDoubleArray(int length,
                                            double min,
                                            double max)

Returns a one dimensional array of pseudorandom, uniformly distributed double values between min (inclusive) and max (exclusive), drawn from this random number generator's sequence. The generator is seeded with the time at which the method is called.

Parameters:

length - length of array

min - minimum value

max - maximum value

Returns:

array of random doubles

See Also:

Uniform

getRandomDoubleArray

public static double[] getRandomDoubleArray(int length,
                                            double min,
                                            double max,
                                            int seed)

Returns a one dimensional array of pseudorandom, uniformly distributed double values between min (inclusive) and max (exclusive), drawn from this random number generator's sequence.

Parameters:

length - length of array

min - minimum value

max - maximum value

seed - random seed

Returns:

array of random doubles

See Also:

Uniform

getRandomIntArray

public static int[] getRandomIntArray(int length,
                                      int min,
                                      int max)

Returns a one dimensional array of pseudorandom, uniformly distributed int values between min (inclusive) and max (exclusive), drawn from this random number generator's sequence. The generator is seeded with the time at which the method is called.

Parameters:

length - length of array

min - minimum value

max - maximum value

Returns:

array of random ints

See Also:

Uniform

getRandomIntArray

public static int[] getRandomIntArray(int length,
                                      int min,
                                      int max,
                                      int seed)

Returns a one dimensional array of pseudorandom, uniformly distributed int values between min (inclusive) and max (exclusive), drawn from this random number generator's sequence.

Parameters:

length - length of array

min - minimum value

max - maximum value

seed - random seed

Returns:

array of random ints

See Also:

Uniform

getRandomLongArray

public static long[] getRandomLongArray(int length,
                                        long min,
                                        long max)

Returns a one dimensional array of pseudorandom, uniformly distributed long values between min (inclusive) and max (exclusive), drawn from this random number generator's sequence. The generator is seeded with the time at which the method is called.

Parameters:

length - length of array

min - minimum value

max - maximum value

Returns:

array of random longs

See Also:

Uniform

getRandomLongArray

public static long[] getRandomLongArray(int length,
                                        long min,
                                        long max,
                                        int seed)

Returns a one dimensional array of pseudorandom, uniformly distributed long values between min (inclusive) and max (exclusive), drawn from this random number generator's sequence.

Parameters:

length - length of array

min - minimum value

max - maximum value

seed - random seed

Returns:

array of random longs

See Also:

Uniform

getRandomShortArray

public static short[] getRandomShortArray(int length,
                                          short min,
                                          short max,
                                          int seed)

Returns a one dimensional array of pseudorandom, uniformly distributed short values between min (inclusive) and max (exclusive), drawn from this random number generator's sequence.

Parameters:

length - length of array

min - minimum value

max - maximum value

seed - random seed

Returns:

array of random shorts

See Also:

Uniform

getRandomByteArray

public static byte[] getRandomByteArray(int length,
                                        byte min,
                                        byte max)

Returns a one dimensional array of pseudorandom, uniformly distributed byte values between min (inclusive) and max (exclusive), drawn from this random number generator's sequence. The generator is seeded with the time at which the method is called.

Parameters:

length - length of array

min - minimum value

max - maximum value

Returns:

array of random bytes

See Also:

Uniform

getRandomByteArray

public static byte[] getRandomByteArray(int length,
                                        byte min,
                                        byte max,
                                        int seed)

Returns a one dimensional array of pseudorandom, uniformly distributed byte values between min (inclusive) and max (exclusive), drawn from this random number generator's sequence.

Parameters:

length - length of array

min - minimum value

max - maximum value

seed - random seed

Returns:

array of random bytes

See Also:

Uniform

getRandomFloatArray

public static float[] getRandomFloatArray(int length,
                                          float min,
                                          float max,
                                          cern.jet.random.engine.MersenneTwister mt)

Returns a one dimensional array of pseudorandom, uniformly distributed float values between min (inclusive) and max (exclusive), drawn from this random number generator's sequence.

Parameters:

length - length of array

min - minimum value

max - maximum value

mt - Mersenne twister

Returns:

array of random floats

See Also:

Uniform

getRandomDoubleArray

public static double[] getRandomDoubleArray(int length,
                                            double min,
                                            double max,
                                            cern.jet.random.engine.MersenneTwister mt)

Returns a one dimensional array of pseudorandom, uniformly distributed double values between min (inclusive) and max (exclusive), drawn from this random number generator's sequence.

Parameters:

length - length of array

min - minimum value

max - maximum value

mt - Mersenne twister

Returns:

array of random doubles

See Also:

Uniform

getRandomIntArray

public static int[] getRandomIntArray(int length,
                                      int min,
                                      int max,
                                      cern.jet.random.engine.MersenneTwister mt)

Returns a one dimensional array of pseudorandom, uniformly distributed int values between min (inclusive) and max (exclusive), drawn from this random number generator's sequence.

Parameters:

length - length of array

min - minimum value

max - maximum value

mt - Mersenne twister

Returns:

array of random ints

See Also:

Uniform

getRandomLongArray

public static long[] getRandomLongArray(int length,
                                        long min,
                                        long max,
                                        cern.jet.random.engine.MersenneTwister mt)

Returns a one dimensional array of pseudorandom, uniformly distributed long values between min (inclusive) and max (exclusive), drawn from this random number generator's sequence.

Parameters:

length - length of array

min - minimum value

max - maximum value

mt - Mersenne twister

Returns:

array of random longs

See Also:

Uniform

getRandomShortArray

public static short[] getRandomShortArray(int length,
                                          short min,
                                          short max,
                                          cern.jet.random.engine.MersenneTwister mt)

Returns a one dimensional array of pseudorandom, uniformly distributed short values between min (inclusive) and max (exclusive), drawn from this random number generator's sequence.

Parameters:

length - length of array

min - minimum value

max - maximum value

mt - Mersenne twister

Returns:

array of random shorts

See Also:

Uniform

getRandomByteArray

public static byte[] getRandomByteArray(int length,
                                        byte min,
                                        byte max,
                                        cern.jet.random.engine.MersenneTwister mt)

Returns a one dimensional array of pseudorandom, uniformly distributed byte values between min (inclusive) and max (exclusive), drawn from this random number generator's sequence.

Parameters:

length - length of array

min - minimum value

max - maximum value

mt - Mersenne twister

Returns:

array of random bytes

See Also:

Uniform