mikera.vectorz

Class Vector

java.lang.Object

mikera.arrayz.impl.AbstractArray<Double>

mikera.vectorz.AVector

mikera.vectorz.impl.AStridedVector

mikera.vectorz.impl.AArrayVector

mikera.vectorz.Vector

All Implemented Interfaces:

Serializable, Cloneable, Comparable<AVector>, Iterable<Double>, IStridedArray, INDArray, IVector

public final class Vector
extends AArrayVector

General purpose vector of arbitrary length, backed by an internal double[] array. This is the most efficient Vectorz type for 1D vectors.

Author:

Mike

See Also:

Serialized Form

Field Summary

Fields

Modifier and Type	Field and Description
double[]	data

Constructor Summary

Constructors

Constructor and Description
Vector(AVector source) Copy constructor from an arbitrary vector

Method Summary

Methods

Modifier and Type	Method and Description
void	abs() Sets each component of the vector to its absolute value
void	add(AArrayVector src, int srcOffset)
void	add(AVector v) Adds another vector to this one
void	add(double constant) Adds a double value to all elements in this array
void	add(Vector v)
void	addAt(int i, double v) Adds a value to a specific element of the vector This function does not perform bounds checking
void	addMultiple(AArrayVector v, double factor)
void	addMultiple(AVector v, double factor) Adds a scaled multiple of another vector to this one
void	addMultiple(Index destToSource, Vector source, double factor) Adds to this vector at taking values from source at the specified indexes which should map from this->source
void	addMultiple(Vector source, Index index, double factor) Adds source vector to this vector at the specified indexes which should map from source->this
void	addProduct(AVector a, AVector b)
void	addProduct(Vector a, Vector b)
void	addProduct(Vector a, Vector b, double factor)
void	addWeighted(AArrayVector v, double factor)
void	addWeighted(AVector v, double factor) Updates a weighted average of this vector with another vector
void	applyOp(Op op) Applies a unary operator to all elements of the array (in-place)
double[]	asDoubleArray() Returns the underlying double array representing the packed elements of this array Returns nil if there is no such underlying array
void	clamp(double min, double max) Clamps all values in the vector to a given range
Vector	clone() Clones the vector, creating a new mutable copy of all data.
static Vector	create(AIndex a)
static Vector	create(AVector a)
static Vector	create(double[] data)
static Vector	createFromVector(AVector source, int length) Creates a new vector using the elements in the specified vector.
static Vector	createLength(int length) Create an empty (zero-filled) vector of a specified length
double	distance(AVector v)
double	distance(Vector v)
double	distanceSquared(Vector v)
double	dotProduct(AVector v)
double	dotProduct(AVector v, Index ix)
double	dotProduct(double[] data, int offset) Fast dot product with a double[] array.
double	dotProduct(Vector v)
double	dotProduct(Vector v, Index ix)
double	elementSum() Returns the sum of all elements in a vector
Vector	ensureMutable() Ensures the array is a fully mutable, efficient representation that is not a view.
Vector	exactClone() Returns an exact clone of this vector, i.e.
void	fill(double value) Fills the entire vector with a given value
double	get(int i) Returns the double value at the specified position in a 1D vector
double[]	getArray()
int	getArrayOffset()
void	getElements(double[] dest, int offset) Gets all elements of the array, copying them into a double array
int	hashCode() Computes the hashcode of a vector.
Scalar	innerProduct(AVector v)
Scalar	innerProduct(Vector v)
boolean	isPackedArray()
boolean	isView() Returns true if this vector is of a view type that references other vectors / data.
int	length()
void	logistic()
void	multiply(AVector v)
void	multiply(double factor) Multiplies the vector by a constant factor
void	multiply(Vector v)
long	nonZeroCount() Returns the number of non-zero elements in the array.
static Vector	of(double... values) Create a vector with specific component values.
void	scaleAdd(double factor, double constant) Scales this vector and adds a constant to every element
void	set(AVector a) Sets the vector to equal the value of another vector
void	set(int i, double value)
void	setRange(int offset, double[] data, int dataOffset, int length) Set a subrange of this vector from a double array
void	signum() Sets each component of the vector to its sign value (-1, 0 or 1)
void	square() Squares all elements of the vector
void	sub(AArrayVector v)
void	sub(AArrayVector src, int srcOffset)
void	sub(AVector v) Subtracts a vector from this vector
void	tanh()
void	toDoubleBuffer(DoubleBuffer dest) Copies the elements of this INDArray to the specified double buffer
Vector	toNormal() Creates a new mutable vector representing the normalised value of this vector
double	unsafeGet(int i)
void	unsafeSet(int i, double value)
static Vector	wrap(double[] source) Wraps a double array into a Vector, does *no defensive copy* so use with caution

Methods inherited from class mikera.vectorz.impl.AArrayVector

add, add, add, add, add, addMultipleToArray, addProduct, addProduct, addProductToArray, addProductToArray, addToArray, copyTo, copyTo, copyTo, divide, divide, divideTo, equals, equalsArray, equalsArray, exp, fillRange, getStride, isZero, join, join, join, log, magnitude, magnitudeSquared, multiply, multiplyTo, pow, reciprocal, set, setElements, slice, sqrt, subVector, validate

Methods inherited from class mikera.vectorz.impl.AStridedVector

broadcast, broadcastLike, broadcastLike, getStride, getStrides, iterator

Methods inherited from class mikera.vectorz.AVector

add, add, addMultiple, addMultiple, addMultiple, addMultiple, addMultiple, addToArray, angle, applyOp, asElementList, asVector, clampMax, clampMin, compareTo, copyTo, copyTo, copyTo, copyTo, crossProduct, dimensionality, distanceL1, distanceLinf, distanceSquared, divide, divide, elementCount, elementIterator, elementSquaredSum, epsilonEquals, epsilonEquals, epsilonEquals, epsilonEquals, equals, equals, get, get, get, getLongShape, getShape, getShape, getSlices, getTranspose, getTransposeCopy, getTransposeView, immutable, innerProduct, innerProduct, innerProduct, interpolate, interpolate, isElementConstrained, isFullyMutable, isMutable, isSameShape, isSameShape, isUnitLengthVector, maxAbsElement, multiply, mutable, negate, normalise, normaliseMaxAbsElement, outerProduct, outerProduct, projectToPlane, reshape, scale, scaleAdd, scaleToMagnitude, set, set, set, set, set, set, set, setElements, setValues, slice, sliceCount, sub, sub, subMultiple, toDoubleArray, toList, toString, toVector, zeroCount

Methods inherited from class mikera.arrayz.impl.AbstractArray

broadcastCloneLike, get, getSliceViews, isBoolean, scale, set, set, toArray

Methods inherited from class java.lang.Object

finalize, getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface mikera.arrayz.impl.IStridedArray

getShape

Methods inherited from interface mikera.arrayz.INDArray

add, applyOp, asElementList, asVector, broadcastCloneLike, copyTo, dimensionality, divide, divide, elementCount, elementIterator, elementSquaredSum, epsilonEquals, epsilonEquals, equals, get, get, get, getLongShape, getShape, getSlices, getSliceViews, getTranspose, getTransposeCopy, getTransposeView, innerProduct, isBoolean, isElementConstrained, isFullyMutable, isMutable, isSameShape, multiply, negate, outerProduct, reshape, scale, set, set, set, set, set, setElements, slice, sliceCount, sub, sub, toArray, toDoubleArray, toVector

Field Detail

data

public final double[] data

Constructor Detail

Vector

public Vector(AVector source)

Copy constructor from an arbitrary vector

Parameters:

source -

Method Detail

wrap

public static Vector wrap(double[] source)

Wraps a double array into a Vector, does *no defensive copy* so use with caution

Parameters:

source -

Returns:

create

public static Vector create(double[] data)

of

public static Vector of(double... values)

Create a vector with specific component values. Creates a copy of the value array

Parameters:

values -

Returns:

createLength

public static Vector createLength(int length)

Create an empty (zero-filled) vector of a specified length

Parameters:

length -

Returns:

create

public static Vector create(AVector a)

create

public static Vector create(AIndex a)

length

public int length()

Specified by:

length in interface IVector

Specified by:

length in class AVector

get

public double get(int i)

Description copied from interface: INDArray

Returns the double value at the specified position in a 1D vector

Specified by:

get in interface INDArray

Specified by:

get in interface IVector

Specified by:

get in class AArrayVector

Returns:

unsafeGet

public double unsafeGet(int i)

Specified by:

unsafeGet in class AArrayVector

set

public void set(int i,
       double value)

Specified by:

set in interface INDArray

Specified by:

set in interface IVector

Specified by:

set in class AArrayVector

unsafeSet

public void unsafeSet(int i,
             double value)

Specified by:

unsafeSet in class AArrayVector

setRange

public void setRange(int offset,
            double[] data,
            int dataOffset,
            int length)

Description copied from class: AVector

Set a subrange of this vector from a double array

Overrides:

setRange in class AArrayVector

set

public void set(AVector a)

Description copied from class: AVector

Sets the vector to equal the value of another vector

Overrides:

set in class AArrayVector

getArray

public double[] getArray()

Specified by:

getArray in interface IStridedArray

Specified by:

getArray in class AStridedVector

getElements

public void getElements(double[] dest,
               int offset)

Description copied from interface: INDArray

Gets all elements of the array, copying them into a double array

Specified by:

getElements in interface INDArray

Overrides:

getElements in class AArrayVector

getArrayOffset

public int getArrayOffset()

Specified by:

getArrayOffset in interface IStridedArray

Specified by:

getArrayOffset in class AStridedVector

applyOp

public void applyOp(Op op)

Description copied from interface: INDArray

Applies a unary operator to all elements of the array (in-place)

Specified by:

applyOp in interface INDArray

Overrides:

applyOp in class AArrayVector

fill

public void fill(double value)

Description copied from class: AVector

Fills the entire vector with a given value

Specified by:

fill in interface INDArray

Overrides:

fill in class AArrayVector

clamp

public void clamp(double min,
         double max)

Description copied from class: AVector

Clamps all values in the vector to a given range

Specified by:

clamp in interface INDArray

Overrides:

clamp in class AArrayVector

square

public void square()

Description copied from class: AVector

Squares all elements of the vector

Specified by:

square in interface INDArray

Overrides:

square in class AArrayVector

tanh

public void tanh()

Overrides:

tanh in class AVector

logistic

public void logistic()

Overrides:

logistic in class AVector

elementSum

public double elementSum()

Description copied from class: AVector

Returns the sum of all elements in a vector

Specified by:

elementSum in interface INDArray

Overrides:

elementSum in class AArrayVector

Returns:

nonZeroCount

public long nonZeroCount()

Description copied from interface: INDArray

Returns the number of non-zero elements in the array.

Specified by:

nonZeroCount in interface INDArray

Overrides:

nonZeroCount in class AArrayVector

Returns:

signum

public void signum()

Description copied from class: AArrayVector

Sets each component of the vector to its sign value (-1, 0 or 1)

Specified by:

signum in interface INDArray

Overrides:

signum in class AArrayVector

abs

public void abs()

Description copied from class: AVector

Sets each component of the vector to its absolute value

Specified by:

abs in interface INDArray

Overrides:

abs in class AArrayVector

add

public void add(AArrayVector src,
       int srcOffset)

Overrides:

add in class AArrayVector

addMultiple

public void addMultiple(AArrayVector v,
               double factor)

Overrides:

addMultiple in class AArrayVector

add

public void add(AVector v)

Description copied from class: AVector

Adds another vector to this one

Overrides:

add in class AArrayVector

add

public void add(Vector v)

Overrides:

add in class AStridedVector

scaleAdd

public void scaleAdd(double factor,
            double constant)

Description copied from class: AVector

Scales this vector and adds a constant to every element

Specified by:

scaleAdd in interface INDArray

Overrides:

scaleAdd in class AArrayVector

add

public void add(double constant)

Description copied from interface: INDArray

Adds a double value to all elements in this array

Specified by:

add in interface INDArray

Overrides:

add in class AArrayVector

addProduct

public void addProduct(AVector a,
              AVector b)

Overrides:

addProduct in class AVector

addProduct

public void addProduct(Vector a,
              Vector b)

addProduct

public void addProduct(Vector a,
              Vector b,
              double factor)

addAt

public void addAt(int i,
         double v)

Description copied from class: AVector

Adds a value to a specific element of the vector This function does not perform bounds checking

Overrides:

addAt in class AArrayVector

sub

public void sub(AVector v)

Description copied from class: AVector

Subtracts a vector from this vector

Overrides:

sub in class AVector

dotProduct

public double dotProduct(AVector v,
                Index ix)

Overrides:

dotProduct in class AVector

dotProduct

public double dotProduct(Vector v,
                Index ix)

dotProduct

public double dotProduct(double[] data,
                int offset)

Description copied from class: AVector

Fast dot product with a double[] array.

Overrides:

dotProduct in class AArrayVector

Returns:

dotProduct

public double dotProduct(AVector v)

Overrides:

dotProduct in class AArrayVector

innerProduct

public Scalar innerProduct(AVector v)

Overrides:

innerProduct in class AVector

innerProduct

public Scalar innerProduct(Vector v)

Overrides:

innerProduct in class AVector

dotProduct

public double dotProduct(Vector v)

Overrides:

dotProduct in class AVector

distanceSquared

public double distanceSquared(Vector v)

distance

public double distance(Vector v)

distance

public double distance(AVector v)

Overrides:

distance in class AVector

sub

public void sub(AArrayVector v)

sub

public void sub(AArrayVector src,
       int srcOffset)

addMultiple

public void addMultiple(AVector v,
               double factor)

Description copied from class: AVector

Adds a scaled multiple of another vector to this one

Overrides:

addMultiple in class AArrayVector

addWeighted

public void addWeighted(AVector v,
               double factor)

Description copied from class: AVector

Updates a weighted average of this vector with another vector

Overrides:

addWeighted in class AVector

addWeighted

public void addWeighted(AArrayVector v,
               double factor)

addMultiple

public void addMultiple(Vector source,
               Index index,
               double factor)

Description copied from class: AVector

Adds source vector to this vector at the specified indexes which should map from source->this

Overrides:

addMultiple in class AVector

addMultiple

public void addMultiple(Index destToSource,
               Vector source,
               double factor)

Description copied from class: AVector

Adds to this vector at taking values from source at the specified indexes which should map from this->source

Overrides:

addMultiple in class AVector

multiply

public void multiply(double factor)

Description copied from class: AVector

Multiplies the vector by a constant factor

Specified by:

multiply in interface INDArray

Overrides:

multiply in class AArrayVector

Parameters:

factor - Factor by which to multiply each component of the vector

multiply

public void multiply(AVector v)

Overrides:

multiply in class AArrayVector

multiply

public void multiply(Vector v)

isView

public boolean isView()

Description copied from class: AVector

Returns true if this vector is of a view type that references other vectors / data.

Specified by:

isView in interface INDArray

Overrides:

isView in class AArrayVector

Returns:

clone

public Vector clone()

Description copied from class: AVector

Clones the vector, creating a new mutable copy of all data. The clone is: - not guaranteed to be of the same type. - guaranteed to be fully mutable - guaranteed not to contain a reference (i.e. is a full deep copy)

Specified by:

clone in interface INDArray

Overrides:

clone in class AStridedVector

Returns:

hashCode

public int hashCode()

Description copied from class: AVector

Computes the hashcode of a vector. Currently defined to be equal to List.hashCode for a equivalent list of Double values, this may change in future versions.

Overrides:

hashCode in class AVector

ensureMutable

public Vector ensureMutable()

Description copied from interface: INDArray

Ensures the array is a fully mutable, efficient representation that is not a view. Returns either the same array or a new clone.

Specified by:

ensureMutable in interface INDArray

Overrides:

ensureMutable in class AStridedVector

exactClone

public Vector exactClone()

Description copied from class: AVector

Returns an exact clone of this vector, i.e. of the same type

Specified by:

exactClone in interface INDArray

Specified by:

exactClone in class AVector

Returns:

isPackedArray

public boolean isPackedArray()

Specified by:

isPackedArray in interface IStridedArray

Overrides:

isPackedArray in class AArrayVector

toDoubleBuffer

public void toDoubleBuffer(DoubleBuffer dest)

Description copied from interface: INDArray

Copies the elements of this INDArray to the specified double buffer

Specified by:

toDoubleBuffer in interface INDArray

Overrides:

toDoubleBuffer in class AArrayVector

toNormal

public Vector toNormal()

Description copied from class: AVector

Creates a new mutable vector representing the normalised value of this vector

Overrides:

toNormal in class AVector

Returns:

asDoubleArray

public double[] asDoubleArray()

Description copied from interface: INDArray

Returns the underlying double array representing the packed elements of this array Returns nil if there is no such underlying array

Specified by:

asDoubleArray in interface INDArray

Overrides:

asDoubleArray in class AStridedVector

createFromVector

public static Vector createFromVector(AVector source,
                      int length)

Creates a new vector using the elements in the specified vector. Truncates or zero-pads the data as required to fill the new vector

Parameters:

data -

Returns: