mikera.arrayz

Class NDArray

java.lang.Object

mikera.arrayz.impl.AbstractArray<INDArray>

mikera.arrayz.impl.BaseNDArray

mikera.arrayz.NDArray

All Implemented Interfaces:

Serializable, Cloneable, Iterable<INDArray>, IStridedArray, INDArray

public final class NDArray
extends BaseNDArray

General purpose NDArray class

Author:

Mike

See Also:

Serialized Form

Field Summary

Fields inherited from class mikera.arrayz.impl.BaseNDArray

data, dimensions, offset, shape, stride

Method Summary

Methods

Modifier and Type	Method and Description
void	add(double a) Adds a double value to all elements in this array
void	add(INDArray a) Adds all the elements of another array to this array, in an elementwise order.
void	applyOp(IOperator op) Applies a unary operator to all elements of the array (in-place)
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
AVector	asVector() Constructs a view of the array as a single vector in row-major order.
INDArray	broadcast(int... dimensions) Returns a view of this array broadcasted up to a larger shape
INDArray	clone() Returns a clone of the array, as a new array which will be fully mutable and may be of a different class to the original.
Iterator<Double>	elementIterator() Returns an iterator over all elements in this array.
boolean	equals(INDArray a) Returns true if the two arrays are exactly equal in value and shape
boolean	equals(NDArray a)
NDArray	exactClone() Returns an exact deep clone of an array (i.e.
double[]	getArray()
List<INDArray>	getSlices() Returns a list of all major slices of this array.
INDArray	getTranspose() Returns the transpose of this array.
INDArray	getTransposeView() Returns a transposed view of the array.
INDArray	immutable() Returns an immutable version of this INDArray's data
INDArray	innerProduct(INDArray a) Calculates the inner product of this array with another array.
boolean	isElementConstrained() Returns true if this array has some constraints on element values
boolean	isFullyMutable() If this method returns true, the INDArray is guaranteed to be fully mutable in all positions i.e.
boolean	isMutable() Returns true if the INDArray is mutable (at least partially)
boolean	isView() Return true if this array is a view type
void	multiply(double d) Multiplies all elements of the array by a given double value
static NDArray	newArray(int... shape)
INDArray	outerProduct(INDArray a) Calculates the outer product of this array with another array.
INDArray	reshape(int... dimensions) Returns a new array by rearranging the elements of this array into the desired shape Truncates or zero-pads the elements as required to fill the new shape
void	set(double value) Sets all elements of an array to a specific double value
void	set(int[] indexes, double value)
void	set(int x, double value)
void	set(int x, int y, double value)
void	setElements(double[] values, int offset, int length) Sets all elements in an array using the given double values
INDArray	slice(int majorSlice) Returns the specified major slice of this array as a view (slice along dimension 0)
INDArray	slice(int dimension, int index) Returns a slice view of this array along the specified dimension
void	sub(INDArray a) Subtracts all the elements of another array from this array, in an elementwise order.
NDArray	subArray(int[] offsets, int[] shape) Returns a subarray view of a larger array
void	toDoubleBuffer(DoubleBuffer dest) Copies the elements of this INDArray to the specified double buffer
void	validate() Validates the internal data structure of the INDArray.
static NDArray	wrap(double[] data, int[] shape)
static NDArray	wrap(INDArray a)
static NDArray	wrap(IStridedArray a)
static NDArray	wrap(Matrix m)
static NDArray	wrap(Vector v)
static INDArray	wrapStrided(double[] data, int offset, int[] shape, int[] strides)

Methods inherited from class mikera.arrayz.impl.BaseNDArray

dimensionality, elementCount, get, get, get, get, getArrayOffset, getIndex, getLongShape, getShape, getShape, getShapeClone, getStride, getStrides, isPackedArray, sliceCount

Methods inherited from class mikera.arrayz.impl.AbstractArray

abs, asElementList, broadcastCloneLike, broadcastLike, clamp, copyTo, density, divide, divide, elementMax, elementMin, elementSquaredSum, elementSum, ensureMutable, epsilonEquals, epsilonEquals, equals, exp, fill, getElements, getSlices, getSliceViews, getTransposeCopy, hashCode, isBoolean, isSameShape, isZero, iterator, join, log, multiply, mutable, negate, nonZeroCount, pow, reciprocal, rotateView, scale, scaleAdd, set, set, setElements, signum, sparse, sqrt, square, sub, toArray, toDoubleArray, toString, toVector

Methods inherited from class java.lang.Object

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

Methods inherited from interface mikera.arrayz.INDArray

abs, asElementList, broadcastCloneLike, broadcastLike, clamp, copyTo, divide, divide, elementMax, elementMin, elementSquaredSum, elementSum, ensureMutable, epsilonEquals, epsilonEquals, exp, fill, getElements, getSlices, getSliceViews, getTransposeCopy, isBoolean, isSameShape, isZero, join, log, multiply, mutable, negate, nonZeroCount, pow, reciprocal, rotateView, scale, scaleAdd, set, set, setElements, signum, sparse, sqrt, square, sub, toArray, toDoubleArray, toVector

Method Detail

wrap

public static NDArray wrap(double[] data,
           int[] shape)

wrap

public static NDArray wrap(Vector v)

wrap

public static NDArray wrap(Matrix m)

wrap

public static NDArray wrap(IStridedArray a)

wrap

public static NDArray wrap(INDArray a)

newArray

public static NDArray newArray(int... shape)

set

public void set(double value)

Description copied from interface: INDArray

Sets all elements of an array to a specific double value

Specified by:

set in interface INDArray

Overrides:

set in class AbstractArray<INDArray>

set

public void set(int x,
       double value)

Specified by:

set in interface INDArray

Overrides:

set in class AbstractArray<INDArray>

set

public void set(int x,
       int y,
       double value)

Specified by:

set in interface INDArray

Overrides:

set in class AbstractArray<INDArray>

set

public void set(int[] indexes,
       double value)

add

public void add(double a)

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 AbstractArray<INDArray>

add

public void add(INDArray a)

Description copied from interface: INDArray

Adds all the elements of another array to this array, in an elementwise order.

Specified by:

add in interface INDArray

Overrides:

add in class AbstractArray<INDArray>

sub

public void sub(INDArray a)

Description copied from interface: INDArray

Subtracts all the elements of another array from this array, in an elementwise order.

Specified by:

sub in interface INDArray

Overrides:

sub in class AbstractArray<INDArray>

innerProduct

public INDArray innerProduct(INDArray a)

Description copied from interface: INDArray

Calculates the inner product of this array with another array.

Specified by:

innerProduct in interface INDArray

Overrides:

innerProduct in class AbstractArray<INDArray>

Returns:

outerProduct

public INDArray outerProduct(INDArray a)

Description copied from interface: INDArray

Calculates the outer product of this array with another array.

Specified by:

outerProduct in interface INDArray

Overrides:

outerProduct in class AbstractArray<INDArray>

Returns:

getTranspose

public INDArray getTranspose()

Description copied from interface: INDArray

Returns the transpose of this array. A transpose of an array is equivalent to reversing the order of dimensions

Specified by:

getTranspose in interface INDArray

Overrides:

getTranspose in class AbstractArray<INDArray>

Returns:

getTransposeView

public INDArray getTransposeView()

Description copied from interface: INDArray

Returns a transposed view of the array. May throw UnsupportedOperationException if the array does not support this capability

Specified by:

getTransposeView in interface INDArray

Overrides:

getTransposeView in class AbstractArray<INDArray>

Returns:

asVector

public AVector asVector()

Description copied from interface: INDArray

Constructs a view of the array as a single vector in row-major order.

Specified by:

asVector in interface INDArray

Overrides:

asVector in class AbstractArray<INDArray>

Returns:

reshape

public INDArray reshape(int... dimensions)

Description copied from interface: INDArray

Returns a new array by rearranging the elements of this array into the desired shape Truncates or zero-pads the elements as required to fill the new shape

Specified by:

reshape in interface INDArray

Overrides:

reshape in class AbstractArray<INDArray>

Returns:

broadcast

public INDArray broadcast(int... dimensions)

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 AbstractArray<INDArray>

Returns:

slice

public INDArray slice(int majorSlice)

Description copied from interface: INDArray

Returns the specified major slice of this array as a view (slice along dimension 0)

Returns:

slice

public INDArray slice(int dimension,
             int index)

Description copied from interface: INDArray

Returns a slice view of this array along the specified dimension

Returns:

subArray

public NDArray subArray(int[] offsets,
               int[] shape)

Description copied from interface: INDArray

Returns a subarray view of a larger array

Specified by:

subArray in interface INDArray

Overrides:

subArray in class AbstractArray<INDArray>

Returns:

isMutable

public boolean isMutable()

Description copied from interface: INDArray

Returns true if the INDArray is mutable (at least partially)

Specified by:

isMutable in interface INDArray

Overrides:

isMutable in class AbstractArray<INDArray>

Returns:

isFullyMutable

public boolean isFullyMutable()

Description copied from interface: INDArray

If this method returns true, the INDArray is guaranteed to be fully mutable in all positions i.e. every position can store any valid double value

Specified by:

isFullyMutable in interface INDArray

Overrides:

isFullyMutable in class AbstractArray<INDArray>

Returns:

isElementConstrained

public boolean isElementConstrained()

Description copied from interface: INDArray

Returns true if this array has some constraints on element values

Specified by:

isElementConstrained in interface INDArray

Overrides:

isElementConstrained in class AbstractArray<INDArray>

isView

public boolean isView()

Description copied from interface: INDArray

Return true if this array is a view type

Returns:

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 AbstractArray<INDArray>

applyOp

public void applyOp(IOperator 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 AbstractArray<INDArray>

equals

public boolean equals(NDArray a)

equals

public boolean equals(INDArray a)

Description copied from interface: INDArray

Returns true if the two arrays are exactly equal in value and shape

Specified by:

equals in interface INDArray

Overrides:

equals in class AbstractArray<INDArray>

Returns:

exactClone

public NDArray exactClone()

Description copied from interface: INDArray

Returns an exact deep clone of an array (i.e. of the same class as the original).

Returns:

clone

public INDArray clone()

Description copied from interface: INDArray

Returns a clone of the array, as a new array which will be fully mutable and may be of a different class to the original. Clone should attempt to return the most efficient possible array type.

Specified by:

clone in interface INDArray

Overrides:

clone in class AbstractArray<INDArray>

Returns:

multiply

public void multiply(double d)

Description copied from interface: INDArray

Multiplies all elements of the array by a given double value

Specified by:

multiply in interface INDArray

Overrides:

multiply in class AbstractArray<INDArray>

setElements

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

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 AbstractArray<INDArray>

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 AbstractArray<INDArray>

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 AbstractArray<INDArray>

getSlices

public List<INDArray> getSlices()

Description copied from interface: INDArray

Returns a list of all major slices of this array.

Specified by:

getSlices in interface INDArray

Overrides:

getSlices in class AbstractArray<INDArray>

Returns:

elementIterator

public Iterator<Double> elementIterator()

Description copied from interface: INDArray

Returns an iterator over all elements in this array.

Specified by:

elementIterator in interface INDArray

Overrides:

elementIterator in class AbstractArray<INDArray>

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 AbstractArray<INDArray>

immutable

public INDArray immutable()

Description copied from interface: INDArray

Returns an immutable version of this INDArray's data

Specified by:

immutable in interface INDArray

Overrides:

immutable in class AbstractArray<INDArray>

getArray

public double[] getArray()

wrapStrided

public static INDArray wrapStrided(double[] data,
                   int offset,
                   int[] shape,
                   int[] strides)