edu.ucla.sspace.index

Class RandomOrthogonalVectorGenerator

java.lang.Object

edu.ucla.sspace.index.RandomOrthogonalVectorGenerator

All Implemented Interfaces:

DoubleVectorGenerator<DoubleVector>, Generator<DoubleVector>, Serializable

public class RandomOrthogonalVectorGenerator
extends Object
implements DoubleVectorGenerator<DoubleVector>, Serializable

An class that generates DoubleVectors that are orthogonal to each other based on configurable properties using the Gram-Schmidt orthogonalization process. This class supports three properties:

Property: "edu.ucla.sspace.index.RandomOrthogonalVectorGenerator.mean"
Default: 0

This variable sets the gaussian mean for generating values in random vectors.

Property: "edu.ucla.sspace.index.RandomOrthogonalVectorGenerator.std"
Default: 1

This variable sets the std when generating gaussian values for random vectors.

Property: "edu.ucla.sspace.index.RandomOrthogonalVectorGenerator.length"
Default: 1000

This variable sets the length of vectors to create. Note that vector lengths passed to generateRandomVector is ignored.

See Also:

Serialized Form

Field Summary

Fields

Modifier and Type	Field and Description
static int	DEFAULT_VECTOR_LENGTH The default number of dimensions to create in each TernaryVector.
static int	DEFAULT_VECTOR_MEAN The default number of values to set in an TernaryVector.
static int	DEFAULT_VECTOR_STANDARD_DEVIATION The default random std in the number of values that are set in an TernaryVector.
static Random	RANDOM A random number generator that can be accessed to other classes which will rely on the same source of random values.
static String	VECTOR_LENGTH_PROPERTY
static String	VECTOR_MEAN_PROPERTY The property to specify the number of values to set in an TernaryVector.
static String	VECTOR_STANDARD_DEVIATION_PROPERTY The property to specify the std in the number of values to set in an TernaryVector.

Constructor Summary

Constructors

Constructor and Description
RandomOrthogonalVectorGenerator(int vectorLength) Constructs this instance using the system properties and no initial vector.
RandomOrthogonalVectorGenerator(int vectorLength, DoubleVector originalVector) Contructs this instance using the system properties and the provided intial vector.
RandomOrthogonalVectorGenerator(int vectorLength, Properties properties, DoubleVector originalVector) Constructs this instance using the provided properties and uses an initial vector.

Method Summary

Methods

Modifier and Type	Method and Description
DoubleVector	generate() Creates an VectorVector with the provided length.

Methods inherited from class java.lang.Object

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

Field Detail

RANDOM

public static final Random RANDOM

A random number generator that can be accessed to other classes which will rely on the same source of random values.

VECTOR_MEAN_PROPERTY

public static final String VECTOR_MEAN_PROPERTY

The property to specify the number of values to set in an TernaryVector.

See Also:

Constant Field Values

VECTOR_STANDARD_DEVIATION_PROPERTY

public static final String VECTOR_STANDARD_DEVIATION_PROPERTY

The property to specify the std in the number of values to set in an TernaryVector.

See Also:

Constant Field Values

VECTOR_LENGTH_PROPERTY

public static final String VECTOR_LENGTH_PROPERTY

See Also:

Constant Field Values

DEFAULT_VECTOR_MEAN

public static final int DEFAULT_VECTOR_MEAN

The default number of values to set in an TernaryVector.

See Also:

Constant Field Values

DEFAULT_VECTOR_LENGTH

public static final int DEFAULT_VECTOR_LENGTH

The default number of dimensions to create in each TernaryVector.

See Also:

Constant Field Values

DEFAULT_VECTOR_STANDARD_DEVIATION

public static final int DEFAULT_VECTOR_STANDARD_DEVIATION

The default random std in the number of values that are set in an TernaryVector.

See Also:

Constant Field Values

Constructor Detail

RandomOrthogonalVectorGenerator

public RandomOrthogonalVectorGenerator(int vectorLength)

Constructs this instance using the system properties and no initial vector.

RandomOrthogonalVectorGenerator

public RandomOrthogonalVectorGenerator(int vectorLength,
                               DoubleVector originalVector)

Contructs this instance using the system properties and the provided intial vector.

RandomOrthogonalVectorGenerator

public RandomOrthogonalVectorGenerator(int vectorLength,
                               Properties properties,
                               DoubleVector originalVector)

Constructs this instance using the provided properties and uses an initial vector.

Method Detail

generate

public DoubleVector generate()

Description copied from interface: DoubleVectorGenerator

Creates an VectorVector with the provided length.

Specified by:

generate in interface DoubleVectorGenerator<DoubleVector>

Specified by:

generate in interface Generator<DoubleVector>

Parameters:

length - CAUTION: This value is ignored

Returns:

A random vector that is orthogonal to all previously created vectors