AbstractVector (LingPipe API)

java.lang.Object
- com.aliasi.matrix.AbstractVector

All Implemented Interfaces:

Vector

Direct Known Subclasses:

DenseVector, SparseFloatVector
```
public abstract class AbstractVector
extends Object
implements Vector
```
An AbstractVector implements most of a vector's functionality in terms of methods for dimensionality and values.

Since:

LingPipe2.0

Version:

3.5.1

Author:

Bob Carpenter

Constructor Summary

Constructors
Modifier Constructor and Description

protected AbstractVector()
Construct an abstract vector.

Constructors
Modifier	Constructor and Description
`protected`	`AbstractVector()` Construct an abstract vector.

Method Summary

All Methods Instance Methods Abstract Methods Concrete Methods
Modifier and Type	Method and Description
`Vector`	`add(Vector v)` Returns the result of adding the specified vector to this vector.
`double`	`cosine(Vector v)` Returns the cosine of this vector and the specified vector.
`double`	`dotProduct(Vector v)` Returns the dot product (inner product) of this vector with the specified vector.
`boolean`	`equals(Object that)` Returns `true` if the specified object is a vector with the same dimensionality and values as this vector.
`int`	`hashCode()` Returns the hash code for this vector according to the specification.
`void`	`increment(double scale, Vector v)` Adds the specified vector multiplied by the specified scalar to this vector.
`double`	`length()` Returns the length of this vector.
`int[]`	`nonZeroDimensions()` Returns an array with the non-zero dimensions of this vector.
`abstract int`	`numDimensions()` Returns the number of dimensions of this vector.
`void`	`setValue(int dimension, double value)` Throws an unsupported operation exception.
`abstract double`	`value(int dimension)` The value of this vector for the specified dimension.

Methods inherited from class java.lang.Object
clone, finalize, getClass, notify, notifyAll, toString, wait, wait, wait

- Constructor Detail
  - AbstractVector
```
protected AbstractVector()
```
    Construct an abstract vector.
- Method Detail
  - nonZeroDimensions
```
public int[] nonZeroDimensions()
```
    Returns an array with the non-zero dimensions of this vector. The implementation in this class is makes two passes over the input data, first collecting the count of non-zero dimensions, and then filling in the values.
    
    Specified by:
    
    nonZeroDimensions in interface Vector
    
    Returns:
    
    The non-zero dimensions of this vector.
  - increment
```
public void increment(double scale,
                      Vector v)
```
    Adds the specified vector multiplied by the specified scalar to this vector.
    
    Specified by:
    
    increment in interface Vector
    
    Parameters:
    
    scale - The scalar multiplier for the added vector.
    
    v - Vector to scale and add to this vector.
    
    Throws:
    
    IllegalArgumentException - If the specified vector is not of the same dimensionality as this vector.
  - numDimensions
```
public abstract int numDimensions()
```
    Returns the number of dimensions of this vector. Concrete subclasses must implement at least this method and value(int).
    
    Specified by:
    
    numDimensions in interface Vector
    
    Returns:
    
    The number of dimensions of this vector.
  - value
```
public abstract double value(int dimension)
```
    The value of this vector for the specified dimension. Concrete subclasses must implement at least this method and numDimensions().
    
    Specified by:
    
    value in interface Vector
    
    Parameters:
    
    dimension - Dimension whose value is returned.
    
    Returns:
    
    Value of this vector for the specified dimension.
    
    Throws:
    
    IndexOutOfBoundsException - If the dimension is less than zero or greater than or equal to the number of dimensions.
  - setValue
```
public void setValue(int dimension,
                     double value)
```
    Throws an unsupported operation exception. Subclasses with mutable values should override this method.
    
    Specified by:
    
    setValue in interface Vector
    
    Parameters:
    
    dimension - Ignored.
    
    value - Ignored.
    
    Throws:
    
    UnsupportedOperationException - Always.
  - length
```
public double length()
```
    Returns the length of this vector.
    the implementation iterates over the dimensions once accessing each value.
    
    Specified by:
    
    length in interface Vector
    
    Returns:
    
    The length of this vector.
  - add
```
public Vector add(Vector v)
```
    Returns the result of adding the specified vector to this vector.
    Implementation Note: The result is a dense vector and this method iterates over the dimensions adding. Subclasses may override this with a more specific implementation and then fall back on this implementation for the general case.
    
    Specified by:
    
    add in interface Vector
    
    Parameters:
    
    v - Vector to add to this vector.
    
    Returns:
    
    The result of adding the specified vector to this vector.
    
    Throws:
    
    IllegalArgumentException - If the specified vector does not have the same dimensionality as this vector.
  - dotProduct
```
public double dotProduct(Vector v)
```
    Returns the dot product (inner product) of this vector with the specified vector.
    Implementation Note: This method iterates over the dimensions, accessing values for this vector and the specified vector for each dimension.
    
    Specified by:
    
    dotProduct in interface Vector
    
    Parameters:
    
    v - The specified vector.
    
    Returns:
    
    The dot product of this vector with the specified vector.
    
    Throws:
    
    IllegalArgumentException - If the specified vector is not of the same dimensionality as this vector.
  - cosine
```
public double cosine(Vector v)
```
    Returns the cosine of this vector and the specified vector.
    Implementation Note: This method iterates over the dimensions once and accesses the value of each vector once per dimension.
    
    Specified by:
    
    cosine in interface Vector
    
    Parameters:
    
    v - The specified vector.
    
    Returns:
    
    The cosine of this vector with the specified vector.
    
    Throws:
    
    IllegalArgumentException - If the specified vector is not of the same dimensionality as this vector.
  - equals
```
public boolean equals(Object that)
```
    Returns true if the specified object is a vector with the same dimensionality and values as this vector. Note that labels are not considered for equality. This implementation is consistent with hash codes.
    
    Specified by:
    
    equals in interface Vector
    
    Overrides:
    
    equals in class Object
    
    Parameters:
    
    that - Specified object.
    
    Returns:
    
    true if the specified object is a vector with the same dimensionality and values as this vector.
  - hashCode
```
public int hashCode()
```
    Returns the hash code for this vector according to the specification. This hash code is compatible with equality. Implementation Note: The implementation iterates over the dimensions accessing the value of each dimension once.
    
    Specified by:
    
    hashCode in interface Vector
    
    Overrides:
    
    hashCode in class Object
    
    Returns:
    
    The hash code for this vector.

Class AbstractVector

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Constructor Detail

AbstractVector

Method Detail

nonZeroDimensions

increment

numDimensions

value

setValue

length

add

dotProduct

cosine

equals

hashCode