mikera.vectorz.impl

Class AStridedVector

java.lang.Object

mikera.arrayz.impl.AbstractArray<Double>

mikera.vectorz.AVector

mikera.vectorz.impl.ASizedVector

mikera.vectorz.impl.AArrayVector

mikera.vectorz.impl.AStridedVector

All Implemented Interfaces:

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

Direct Known Subclasses:

ADenseArrayVector, BaseStridedVector, ImmutableVector

public abstract class AStridedVector
extends AArrayVector
implements IStridedArray

Abstract base class for vectors backed by a double[] array with a constant stride The double array can be directly accessed for performance purposes

Author:

Mike

See Also:

Serialized Form

Field Summary

Fields inherited from class mikera.vectorz.impl.AArrayVector

data

Fields inherited from class mikera.vectorz.impl.ASizedVector

length

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	AStridedVector(int length, double[] data)

Method Summary

Modifier and Type	Method and Description
void	add(int offset, AVector a, int aOffset, int length) Adds a segment of another vector into this one, at the specified offset
abstract void	addAt(int i, double v) Adds a value to a specific element of the vector This function does not perform bounds checking, i.e.
void	addMultipleToArray(double factor, int offset, double[] destData, int destOffset, int length) Adds a multiple of a subvector of this vector into a double array at the specified offset
void	addToArray(double[] dest, int destOffset, int destStride) Adds this vector to a double[] array, using the specified offset and stride into the destination array
void	addToArray(int offset, double[] destData, int destOffset, int length) Adds a subvector of this vector into a double array at the specified offset
abstract void	applyOp(Op op) Applies a unary operator to all elements of the array (in-place)
Vector	applyOpCopy(Op op) Applies a unary operator to all elements of the array (creating a new array)
double[]	asDoubleArray() Returns the underlying double array representing the densely packed elements of this array Returns null if there is no such array
INDArray	broadcast(int... shape) Returns a view of this array broadcasted up to a larger shape
AStridedMatrix	broadcastLike(AMatrix target) Broadcasts an array to match the shape of the target matrix
Vector	clone() Clones the vector, creating a new mutable copy of all data.
void	copyTo(int offset, double[] dest, int destOffset, int length, int stride) Copies a subset of this vector to a specified destination array offset using the given stride.
double	dotProduct(AVector v) Returns the dot product of this vector with another vector The vectors must have the same length: if not the result is undefined
double	dotProduct(double[] data, int offset) Fast dot product with a double[] array.
double	elementMax() Returns the maximum element value in this array.
double	elementMin() Returns the maximum element value in this array.
double	elementProduct() Returns the product of all elements in the array.
double	elementSquaredSum() Returns the sum of squared elements in this array.
double	elementSum() Returns the sum of all elements in a vector
AStridedVector	ensureMutable() Ensures the array is a fully mutable, efficient representation that is not a view.
boolean	equalsArray(double[] vs, int offset) Returns true if this vector exactly matches the elements in double[] array, starting from the specified offset
double[]	getArray() Gets the underlying double[] data array for this vector
abstract int	getArrayOffset() Gets the offset into the underlying double[] data array for the first element of this vector
void	getElements(double[] dest, int destOffset) Gets all elements of the array, copying them into a double array at the specified offset
void	getElements(double[] dest, int destOffset, int[] indices) Gets the elements in this vector from the specified indices, storing at the specified offset in the destination array
abstract int	getStride() Gets the stride of this strided vector.
int	getStride(int dimension) Gets the stide for a specific dimension in this strided array.
int[]	getStrides() Gets the strides for each dimension of this strided array.
boolean	hasUncountable() Returns true if any element is this array is NaN or infinite
boolean	isPackedArray() Checks if this array is fully packed in row major order.
boolean	isRangeZero(int start, int length) Returns true if a sub-vector range is completely zero.
Iterator<Double>	iterator()
double	reduce(Op2 op) Reduces over all elements of the array in row-major order.
double	reduce(Op2 op, double init) Reduces over all elements of the array in row-major order.
AVector	selectView(int... inds) Selects a subset of indices from a vector, returning a view
abstract void	set(AVector v) Sets the vector to equal the value of another vector
abstract void	setElements(double[] values, int offset) Sets all elements in an array using the given double values
abstract void	setElements(int pos, double[] values, int offset, int length) Sets elements in an array using the given double values.
void	validate() Validates the internal data structure of the INDArray.

Methods inherited from class mikera.vectorz.impl.AArrayVector

index, slice

Methods inherited from class mikera.vectorz.impl.ASizedVector

checkIndex, checkLength, checkRange, checkSameLength, checkSameLength, elementCount, equalsArray, get, getShape, getShapeClone, isSameShape, length, sliceCount

Methods inherited from class mikera.vectorz.AVector

abs, absCopy, add, add, add, add, add, add, add, add, addAt, addCopy, addCopy, addCopy, addInnerProduct, addInnerProduct, addInnerProduct, addMultiple, addMultiple, addMultiple, addMultiple, addMultiple, addMultiple, addMultiple, addMultiple, addMultipleCopy, addMultipleToArray, addPower, addPower, addPower, addProduct, addProduct, addProduct, addProductCopy, addProductCopy, addProductToArray, addProductToArray, addToArray, addWeighted, angle, applyOp, applyOp, applyOp, applyOp, asElementList, asVector, broadcastLike, broadcastLike, checkDimension, checkSameLength, clamp, clampMax, clampMin, compareTo, copy, copyTo, copyTo, copyTo, copyTo, crossProduct, crossProduct, dense, denseClone, dimensionality, distance, distanceL1, distanceLinf, distanceSquared, divide, divide, divide, divide, divideCopy, divideCopy, divideTo, dotProduct, dotProduct, dotProduct, elementAbsPowSum, elementIterator, elementPowSum, elementsEqual, epsilonEquals, epsilonEquals, epsilonEquals, epsilonEquals, equals, equals, equals, exactClone, fill, fillRange, get, get, get, get, get, getElements, getLongShape, getShape, getSlices, getTranspose, getTransposeCopy, getTransposeView, hashCode, immutable, innerProduct, innerProduct, innerProduct, innerProduct, innerProduct, innerProduct, interpolate, isElementConstrained, isFullyMutable, isMutable, isSameShape, isUnitLengthVector, isUnitLengthVector, isView, isZero, join, join, join, log, logistic, magnitude, magnitudeSquared, maxAbsElement, maxAbsElementIndex, maxElement, maxElementIndex, minElement, minElementIndex, multiply, multiply, multiply, multiply, multiply, multiplyCopy, multiplyCopy, multiplyCopy, multiplyTo, mutable, negate, negateCopy, nonSparseIndex, nonZeroCount, nonZeroIndices, nonZeroValues, normalise, normaliseCopy, normaliseMaxAbsElement, outerProduct, outerProduct, pow, projectToPlane, reduceSlices, reduceSlices, reorder, reorder, reshape, rotateCopy, rotateView, rotateView, scale, scaleAdd, scaleAdd, scaleAdd, scaleAdd, scaleCopy, scaleToMagnitude, select, selectClone, set, set, set, set, set, set, set, set, set, set, setElements, setInnerProduct, setInnerProduct, setInnerProduct, setMultiple, setMultiple, setMultiple, setMultiple, shiftCopy, signum, slice, sliceValue, softmax, softmaxCopy, sparse, sparseClone, sqrtCopy, square, squareCopy, sub, sub, subArray, subAt, subCopy, subCopy, subMultiple, subVector, tanh, toDoubleArray, toDoubleBuffer, toList, toNormal, toSliceArray, toString, toStringFull, toVector, tryEfficientJoin, unsafeGet, unsafeSet

Methods inherited from class mikera.arrayz.impl.AbstractArray

add, addInnerProduct, addInnerProduct, addOuterProduct, broadcastCloneLike, broadcastCopyLike, checkMutable, componentCount, density, exp, get, get, get, getComponent, getComponents, getElements, getElements, getSlices, getSliceViews, isBoolean, isDense, isSparse, reciprocal, reciprocalCopy, scale, set, set, signumCopy, sqrt, sub, sub, toArray, withComponents

Methods inherited from class java.lang.Object

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

Methods inherited from interface mikera.arrayz.INDArray

abs, absCopy, add, add, addAt, addCopy, addCopy, addInnerProduct, addMultiple, addOuterProduct, addPower, addPower, addToArray, applyOp, applyOp, applyOp, asElementList, asVector, broadcastCloneLike, broadcastCopyLike, broadcastLike, broadcastLike, checkMutable, clamp, componentCount, copy, dense, denseClone, dimensionality, divide, divide, divideCopy, elementAbsPowSum, elementCount, elementIterator, elementPowSum, elementsEqual, epsilonEquals, epsilonEquals, equals, equalsArray, exactClone, exp, fill, get, get, get, get, get, get, get, get, get, getComponent, getComponents, getElements, getElements, getElements, getLongShape, getShape, getShape, getShapeClone, getSlices, getSlices, getSliceViews, getTranspose, getTransposeCopy, getTransposeView, immutable, innerProduct, innerProduct, innerProduct, innerProduct, isBoolean, isDense, isElementConstrained, isFullyMutable, isMutable, isSameShape, isSparse, isView, isZero, join, join, log, multiply, multiply, multiplyCopy, multiplyCopy, mutable, negate, negateCopy, nonZeroCount, outerProduct, pow, reciprocal, reciprocalCopy, reduceSlices, reduceSlices, reorder, reorder, reshape, rotateView, scale, scaleAdd, scaleAdd, scaleCopy, set, set, set, set, set, set, set, setElements, setInnerProduct, setMultiple, setMultiple, signum, signumCopy, slice, slice, sliceCount, sliceValue, sparse, sparseClone, sqrt, square, squareCopy, sub, sub, subArray, subCopy, toArray, toDoubleArray, toDoubleBuffer, toSliceArray, toVector, withComponents

Methods inherited from interface java.lang.Iterable

forEach, spliterator

Constructor Detail

AStridedVector

protected AStridedVector(int length,
                         double[] data)

Method Detail

getArray

public final double[] getArray()

Gets the underlying double[] data array for this vector

Specified by:

getArray in interface IStridedArray

Returns:

getArrayOffset

public abstract int getArrayOffset()

Gets the offset into the underlying double[] data array for the first element of this vector

Specified by:

getArrayOffset in interface IStridedArray

Returns:

getStride

public abstract int getStride()

Gets the stride of this strided vector.

Returns:

ensureMutable

public AStridedVector 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 AbstractArray<Double>

isRangeZero

public boolean isRangeZero(int start,
                           int length)

Description copied from class: AVector

Returns true if a sub-vector range is completely zero. Unsafe operation - does not perform bounds checking, results are undefined if sub-vector is out of range

Overrides:

isRangeZero in class AVector

Returns:

dotProduct

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

Description copied from class: AVector

Fast dot product with a double[] array. Performs no bounds checking. Likely to be faster than most other dot product operations

Specified by:

dotProduct in class AVector

dotProduct

public double dotProduct(AVector v)

Description copied from class: AVector

Returns the dot product of this vector with another vector The vectors must have the same length: if not the result is undefined

Overrides:

dotProduct in class AVector

Returns:

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 AVector

elementProduct

public double elementProduct()

Description copied from interface: INDArray

Returns the product of all elements in the array.

Specified by:

elementProduct in interface INDArray

Overrides:

elementProduct in class AVector

Returns:

elementMax

public double elementMax()

Description copied from interface: INDArray

Returns the maximum element value in this array. Throws an error if there are no elements.

Specified by:

elementMax in interface INDArray

Overrides:

elementMax in class AVector

elementMin

public double elementMin()

Description copied from interface: INDArray

Returns the maximum element value in this array. Throws an error if there are no elements.

Specified by:

elementMin in interface INDArray

Overrides:

elementMin in class AVector

broadcast

public INDArray broadcast(int... shape)

Description copied from interface: INDArray

Returns a view of this array broadcasted up to a larger shape

Specified by:

broadcast in interface INDArray

Overrides:

broadcast in class AVector

broadcastLike

public AStridedMatrix broadcastLike(AMatrix target)

Description copied from interface: INDArray

Broadcasts an array to match the shape of the target matrix

Specified by:

broadcastLike in interface INDArray

Overrides:

broadcastLike in class AVector

Parameters:

target - The target matrix

selectView

public AVector selectView(int... inds)

Description copied from class: AVector

Selects a subset of indices from a vector, returning a view

Overrides:

selectView in class AArrayVector

Returns:

a view of the selected indices

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

Specified by:

clone in interface IVector

Overrides:

clone in class AVector

set

public abstract void set(AVector v)

Description copied from class: AVector

Sets the vector to equal the value of another vector

Overrides:

set in class AVector

setElements

public abstract void setElements(double[] values,
                                 int offset)

Description copied from interface: INDArray

Sets all elements in an array using the given double values

Specified by:

setElements in interface INDArray

Overrides:

setElements in class AVector

Parameters:

values - Element values in a double[] array. There must be at least as many element values as elements in this array.

offset - Position in the values array from which to start taking values.

setElements

public abstract void setElements(int pos,
                                 double[] values,
                                 int offset,
                                 int length)

Description copied from interface: INDArray

Sets elements in an array using the given double values. The source array must contain at least the specified length in terms of number of elements

Specified by:

setElements in interface INDArray

Overrides:

setElements in class AVector

Parameters:

pos - Offset into this array, expressed in terms of number of elements in row major order

values - Element values in a double[] array. There must be at least as many element values as elements in this array.

offset - Position in the values array from which to start taking values.

length - Number of elements to set.

add

public void add(int offset,
                AVector a,
                int aOffset,
                int length)

Description copied from class: AVector

Adds a segment of another vector into this one, at the specified offset

Overrides:

add in class AVector

addAt

public abstract 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, i.e. is an unsafe operation

Overrides:

addAt in class AVector

addToArray

public void addToArray(int offset,
                       double[] destData,
                       int destOffset,
                       int length)

Description copied from class: AVector

Adds a subvector of this vector into a double array at the specified offset

Overrides:

addToArray in class AVector

addMultipleToArray

public void addMultipleToArray(double factor,
                               int offset,
                               double[] destData,
                               int destOffset,
                               int length)

Description copied from class: AVector

Adds a multiple of a subvector of this vector into a double array at the specified offset

Overrides:

addMultipleToArray in class AVector

addToArray

public void addToArray(double[] dest,
                       int destOffset,
                       int destStride)

Description copied from class: AVector

Adds this vector to a double[] array, using the specified offset and stride into the destination array

Overrides:

addToArray in class AVector

applyOp

public abstract 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 AVector

applyOpCopy

public final Vector applyOpCopy(Op op)

Description copied from interface: INDArray

Applies a unary operator to all elements of the array (creating a new array)

Specified by:

applyOpCopy in interface INDArray

Overrides:

applyOpCopy in class AVector

reduce

public double reduce(Op2 op,
                     double init)

Description copied from interface: INDArray

Reduces over all elements of the array in row-major order. Applies the operator to the initial/previous result at each step. Returns the final result.

Specified by:

reduce in interface INDArray

Overrides:

reduce in class AVector

reduce

public double reduce(Op2 op)

Description copied from interface: INDArray

Reduces over all elements of the array in row-major order. Applies the operator to the previous result at each step. Returns the final result.

Specified by:

reduce in interface INDArray

Overrides:

reduce in class AVector

copyTo

public void copyTo(int offset,
                   double[] dest,
                   int destOffset,
                   int length,
                   int stride)

Description copied from class: AVector

Copies a subset of this vector to a specified destination array offset using the given stride. Unsafe operation: performs no bounds checking

Overrides:

copyTo in class AVector

hasUncountable

public boolean hasUncountable()

Description copied from class: AbstractArray

Returns true if any element is this array is NaN or infinite

Specified by:

hasUncountable in interface INDArray

Overrides:

hasUncountable in class AVector

Returns:

True if any element is this array is NaN or infinite, false otherwise

asDoubleArray

public double[] asDoubleArray()

Description copied from interface: INDArray

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

Specified by:

asDoubleArray in interface INDArray

Overrides:

asDoubleArray in class AVector

isPackedArray

public boolean isPackedArray()

Description copied from interface: IStridedArray

Checks if this array is fully packed in row major order.

Specified by:

isPackedArray in interface IStridedArray

Returns:

getStrides

public int[] getStrides()

Description copied from interface: IStridedArray

Gets the strides for each dimension of this strided array. The returned array should not be modified

Specified by:

getStrides in interface IStridedArray

Returns:

iterator

public Iterator<Double> iterator()

Specified by:

iterator in interface Iterable<Double>

Overrides:

iterator in class AVector

getStride

public int getStride(int dimension)

Description copied from interface: IStridedArray

Gets the stide for a specific dimension in this strided array.

Specified by:

getStride in interface IStridedArray

Returns:

elementSquaredSum

public double elementSquaredSum()

Description copied from interface: INDArray

Returns the sum of squared elements in this array.

Specified by:

elementSquaredSum in interface INDArray

Overrides:

elementSquaredSum in class AVector

getElements

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

Description copied from interface: INDArray

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

Specified by:

getElements in interface INDArray

Overrides:

getElements in class AVector

getElements

public void getElements(double[] dest,
                        int destOffset,
                        int[] indices)

Description copied from class: AVector

Gets the elements in this vector from the specified indices, storing at the specified offset in the destination array

Overrides:

getElements in class AVector

equalsArray

public boolean equalsArray(double[] vs,
                           int offset)

Description copied from class: AVector

Returns true if this vector exactly matches the elements in double[] array, starting from the specified offset

Specified by:

equalsArray in interface INDArray

Overrides:

equalsArray in class ASizedVector

Parameters:

vs - Array of double element values to check for equality

offset - Offset into the data array

Returns:

validate

public void validate()

Description copied from interface: INDArray

Validates the internal data structure of the INDArray. Throws an exception on failure. Failure indicates a serious bug and/or data corruption.

Specified by:

validate in interface INDArray

Overrides:

validate in class AVector