Package org.flag4j.arrays.sparse

Class CooCTensor

java.lang.Object

org.flag4j.core.TensorBase<CooCTensor,CTensor,CooCTensor,CTensor,CooTensor,CNumber[],CNumber>

org.flag4j.core.sparse_base.SparseTensorBase<CooCTensor,CTensor,CooCTensor,CTensor,CooTensor,CNumber[],CNumber>

org.flag4j.core.sparse_base.ComplexSparseTensorBase<CooCTensor,CTensor,CooTensor>

org.flag4j.arrays.sparse.CooCTensor

All Implemented Interfaces:

Serializable, ComplexTensorExclusiveMixin<CooCTensor>, ComplexTensorMixin<CooCTensor,CooTensor>, SparseTensorMixin, TensorComparisonsMixin, TensorExclusiveMixin<CooCTensor,CTensor,CooCTensor,CooCTensor>, TensorManipulationsMixin<CooCTensor>, TensorOperationsMixin<CooCTensor,CTensor,CooCTensor,CTensor,CooTensor,CNumber>, TensorPropertiesMixin

public class CooCTensor
extends ComplexSparseTensorBase<CooCTensor,CTensor,CooTensor>
implements ComplexTensorExclusiveMixin<CooCTensor>

Complex sparse tensor. Stored in coordinate (COO) format.

See Also:

• Serialized Form

Field Summary

Fields inherited from class org.flag4j.core.sparse_base.SparseTensorBase

indices, nnz

Fields inherited from class org.flag4j.core.TensorBase

DEFAULT_ROUND_TO_ZERO_THRESHOLD, entries, shape

Constructor Summary

Constructors

Constructor	Description
CooCTensor(CooCTensor A)	Constructs a sparse complex tensor whose non-zero values, indices, and shape are specified by another sparse complex tensor.
CooCTensor(Shape shape)	Creates a sparse tensor with specified shape filled with zeros.
CooCTensor(Shape shape, double[] nonZeroEntries, int[][] indices)	Creates a sparse tensor with specified shape filled with zeros.
CooCTensor(Shape shape, int[] nonZeroEntries, int[][] indices)	Creates a sparse tensor with specified shape filled with zeros.
CooCTensor(Shape shape, List<CNumber> nonZeroEntries, List<int[]> indices)	Creates a sparse tensor with specified shape and non-zero values/indices.
CooCTensor(Shape shape, CNumber[] nonZeroEntries, int[][] indices)	Creates a sparse tensor with specified shape filled with zeros.

Method Summary

Modifier and Type	Method	Description
CTensor	add(double a)	Adds specified value to all entries of this tensor.
CTensor	add(CTensor B)	Computes the element-wise addition between two tensors of the same rank.
CTensor	add(Tensor B)	Computes the element-wise addition between two tensors of the same rank.
CooCTensor	add(CooCTensor B)	Computes the element-wise addition between two tensors of the same rank.
CooCTensor	add(CooTensor B)	Computes the element-wise addition between two tensors of the same rank.
CTensor	add(CNumber a)	Adds specified value to all entries of this tensor.
void	addEq(Tensor B)	Computes the element-wise addition of two tensors of the same rank and stores the result in this tensor.
void	addEq(CooCTensor B)	Computes the element-wise addition of two tensors of the same rank and stores the result in this tensor.
boolean	allClose(CooCTensor tensor, double relTol, double absTol)	Checks if all entries of this tensor are close to the entries of the argument tensor.
CooCTensor	copy()	Creates a copy of this tensor.
CooCTensor	elemDiv(CTensor B)	Computes the element-wise division between two tensors.
CooCTensor	elemDiv(Tensor B)	Computes the element-wise division between two tensors.
CTensor	elemMult(CTensor B)	Computes the element-wise multiplication between two tensors.
CooCTensor	elemMult(Tensor B)	Computes the element-wise multiplication between two tensors.
CooCTensor	elemMult(CooCTensor B)	Computes the element-wise multiplication between two tensors.
CooCTensor	elemMult(CooTensor B)	Computes the element-wise multiplication between two tensors.
boolean	equals(Object object)	Checks if an object is equal to this sparse COO tensor.
CooCTensor	flatten()	Flattens tensor to single dimension.
CooCTensor	flatten(int axis)	Flattens a tensor along the specified axis.
static CooCTensor	fromDense(CTensor src)	Converts a sparse CooCTensor from a dense Tensor.
CNumber	get(int... indices)	Gets the element in this tensor at the specified indices.
protected CooCTensor	getSelf()	Simply returns a reference of this tensor.
CooCTensor	H()	Computes the conjugate transpose of this tensor.
CooCTensor	H(int... axes)	Computes the conjugate transpose of this tensor.
CooCTensor	H(int axis1, int axis2)	Computes the transpose of a tensor.
CooCTensor	hermTranspose()	Computes the conjugate transpose of this tensor.
protected CooTensor	makeRealTensor(Shape shape, double[] entries, int[][] indices)	A factory for creating a real sparse tensor.
protected CooCTensor	makeTensor(Shape shape, CNumber[] entries, int[][] indices)	A factory for creating a complex sparse tensor.
CooCTensor	reshape(Shape newShape)	Copies and reshapes tensor if possible.
CooCTensor	set(double value, int... indices)	Sets an index of this tensor to a specified value.
CooCTensor	set(CNumber value, int... indices)	Sets an index of this tensor to a specified value.
void	sortIndices()	Sorts the indices of this tensor in lexicographical order while maintaining the associated value for each index.
CTensor	sub(double a)	Adds specified value to all entries of this tensor.
CTensor	sub(CTensor B)	Computes the element-wise subtraction between two tensors of the same rank.
CTensor	sub(Tensor B)	Computes the element-wise addition between two tensors of the same rank.
CooCTensor	sub(CooCTensor B)	Computes the element-wise subtraction between two tensors of the same rank.
CooCTensor	sub(CooTensor B)	Computes the element-wise subtraction between two tensors of the same rank.
CTensor	sub(CNumber a)	Subtracts a specified value from all entries of this tensor.
void	subEq(Tensor B)	Computes the element-wise subtraction of two tensors of the same rank and stores the result in this tensor.
void	subEq(CooCTensor B)	Computes the element-wise subtraction of two tensors of the same rank and stores the result in this tensor.
CooCTensor	T()	Computes the transpose of a tensor.
CooCTensor	T(int... axes)	Computes the transpose of this tensor.
CooCTensor	T(int axis1, int axis2)	Computes the transpose of a tensor.
CTensor	tensorDot(CooCTensor src2, int[] aAxes, int[] bAxes)	Computes the tensor contraction of this tensor with a specified tensor over the specified set of axes.
CTensor	tensorInv(int numIndices)	Computes the 'inverse' of this tensor.
CTensor	toDense()	Converts this sparse tensor to an equivalent dense tensor.
CooCMatrix	toMatrix(Shape matShape)	Converts this tensor to a matrix with the specified shape.
CooCTensor	transpose()	Computes the transpose of a tensor.

Methods inherited from class org.flag4j.core.sparse_base.ComplexSparseTensorBase

abs, argMax, argMin, conj, div, div, isComplex, isOnes, isReal, isZeros, max, maxAbs, min, minAbs, mult, mult, nonZeroEntries, recip, reshape, round, round, roundToZero, roundToZero, sqrt, sum, toReal, toRealSafe

Methods inherited from class org.flag4j.core.sparse_base.SparseTensorBase

density, sparsity

Methods inherited from class org.flag4j.core.TensorBase

allClose, getEntries, getRank, getShape, sameLength, sameShape, tensorEquals, totalEntries

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.flag4j.core.ComplexTensorExclusiveMixin

hermTranspose, hermTranspose

Methods inherited from interface org.flag4j.core.TensorExclusiveMixin

getRank, tensorDot, tensorDot, tensorDot, tensorInv, transpose, transpose

Constructor Details

CooCTensor

public CooCTensor(Shape shape)

Creates a sparse tensor with specified shape filled with zeros.

Parameters:

shape - Shape of the tensor.

CooCTensor

public CooCTensor(Shape shape,
 double[] nonZeroEntries,
 int[][] indices)

Creates a sparse tensor with specified shape filled with zeros.

Parameters:

shape - Shape of the tensor.

nonZeroEntries - Non-zero entries of the tensor.

indices - Indices of the non-zero entries of the tensor.

CooCTensor

public CooCTensor(Shape shape,
 int[] nonZeroEntries,
 int[][] indices)

Creates a sparse tensor with specified shape filled with zeros.

Parameters:

shape - Shape of the tensor.

nonZeroEntries - Non-zero entries of the tensor.

indices - Indices of the non-zero entries of the tensor.

CooCTensor

public CooCTensor(Shape shape,
 CNumber[] nonZeroEntries,
 int[][] indices)

Creates a sparse tensor with specified shape filled with zeros.

Parameters:

shape - Shape of the tensor.

nonZeroEntries - Non-zero entries of the tensor.

indices - Indices of the non-zero entries of the tensor.

CooCTensor

public CooCTensor(Shape shape,
 List<CNumber> nonZeroEntries,
 List<int[]> indices)

Creates a sparse tensor with specified shape and non-zero values/indices.

Parameters:

shape - Shape of the tensor.

nonZeroEntries - Non-zero entries of the tensor.

indices - Indices of the non-zero entries of the tensor.

CooCTensor

public CooCTensor(CooCTensor A)

Constructs a sparse complex tensor whose non-zero values, indices, and shape are specified by another sparse complex tensor.

Parameters:

A - The sparse complex tensor to construct a copy of.

Method Details

equals

public boolean equals(Object object)

Checks if an object is equal to this sparse COO tensor.

Specified by:

equals in interface TensorComparisonsMixin

Overrides:

equals in class Object

Parameters:

object - Object to compare this sparse COO tensor to.

Returns:

True if the object is a CooCTensor, has the same shape as this tensor, and is element-wise equal to this tensor.

getSelf

protected CooCTensor getSelf()

Simply returns a reference of this tensor.

Specified by:

getSelf in class TensorBase<CooCTensor,CTensor,CooCTensor,CTensor,CooTensor,CNumber[],CNumber>

Returns:

A reference to this tensor.

allClose

public boolean allClose(CooCTensor tensor,
 double relTol,
 double absTol)

Description copied from class: TensorBase

Checks if all entries of this tensor are close to the entries of the argument tensor.

Specified by:

allClose in class TensorBase<CooCTensor,CTensor,CooCTensor,CTensor,CooTensor,CNumber[],CNumber>

Parameters:

tensor - Tensor to compare this tensor to.

relTol - Relative tolerance.

absTol - Absolute tolerance.

Returns:

True if the argument tensor is the same shape as this tensor and all entries are 'close', i.e. elements a and b at the same positions in the two tensors respectively satisfy |a-b| <= (atol + rtol*|b|). Otherwise, returns false.

See Also:

• TensorBase.allClose(Object)

hermTranspose

public CooCTensor hermTranspose()

Computes the conjugate transpose of this tensor. In the context of a tensor, this swaps the first and last axes and takes the complex conjugate of the elements along these axes. Same as H().

Specified by:

hermTranspose in interface ComplexTensorMixin<CooCTensor,CooTensor>

Returns:

The complex transpose of this tensor.

H

public CooCTensor H()

Computes the conjugate transpose of this tensor. In the context of a tensor, this swaps the first and last axes and takes the complex conjugate of the elements along these axes. Same as hermTranspose().

Specified by:

H in interface ComplexTensorMixin<CooCTensor,CooTensor>

Returns:

The complex transpose of this tensor.

set

public CooCTensor set(CNumber value,
 int... indices)

Sets an index of this tensor to a specified value.

Specified by:

set in interface ComplexTensorMixin<CooCTensor,CooTensor>

Parameters:

value - Value to set.

indices - The indices of this matrix for which to set the value.

Returns:

A reference to this tensor.

Throws:

IllegalArgumentException - If the number of indices is not equal to the rank of this tensor.

IndexOutOfBoundsException - If any of the indices are not within this tensor.

set

public CooCTensor set(double value,
 int... indices)

Sets an index of this tensor to a specified value.

Specified by:

set in interface TensorManipulationsMixin<CooCTensor>

Parameters:

value - Value to set.

indices - The indices of this tensor for which to set the value.

Returns:

A reference to this tensor.

reshape

public CooCTensor reshape(Shape newShape)

Copies and reshapes tensor if possible. The total number of entries in this tensor must match the total number of entries in the reshaped tensor.

Specified by:

reshape in interface TensorManipulationsMixin<CooCTensor>

Parameters:

newShape - Shape of the new tensor.

Returns:

A tensor which is equivalent to this tensor but with the specified shape.

Throws:

IllegalArgumentException - If this tensor cannot be reshaped to the specified dimensions.

flatten

public CooCTensor flatten()

Flattens tensor to single dimension. To flatten tensor along a single axis.

Specified by:

flatten in interface TensorManipulationsMixin<CooCTensor>

Returns:

The flattened tensor.

tensorDot

public CTensor tensorDot(CooCTensor src2,
 int[] aAxes,
 int[] bAxes)

Computes the tensor contraction of this tensor with a specified tensor over the specified set of axes. That is, computes the sum of products between the two tensors along the specified set of axes.

Specified by:

tensorDot in interface TensorExclusiveMixin<CooCTensor,CTensor,CooCTensor,CooCTensor>

Parameters:

src2 - Tensor to contract with this tensor.

aAxes - Axes along which to compute products for this tensor.

bAxes - Axes along which to compute products for src2 tensor.

Returns:

The tensor dot product over the specified axes.

Throws:

IllegalArgumentException - If the two tensors shapes do not match along the specified axes pairwise in aAxes and bAxes.

IllegalArgumentException - If aAxes and bAxes do not match in length, or if any of the axes are out of bounds for the corresponding tensor.

T

public CooCTensor T(int axis1,
 int axis2)

Computes the transpose of a tensor. Same as TensorExclusiveMixin.transpose(int, int). In the context of a tensor, this exchanges the specified axes. Also see transpose() and T() to exchange first and last axes.

Specified by:

T in interface TensorExclusiveMixin<CooCTensor,CTensor,CooCTensor,CooCTensor>

Parameters:

axis1 - First axis to exchange.

axis2 - Second axis to exchange.

Returns:

The transpose of this tensor.

T

public CooCTensor T(int... axes)

Computes the transpose of this tensor. That is, interchanges the axes of this tensor so that it matches the specified axes permutation. Same as TensorExclusiveMixin.transpose(int[]).

Specified by:

T in interface TensorExclusiveMixin<CooCTensor,CTensor,CooCTensor,CooCTensor>

Parameters:

axes - Permutation of tensor axis. If the tensor has rank N, then this must be an array of length N which is a permutation of {0, 1, 2, ..., N-1}.

Returns:

The transpose of this tensor with its axes permuted by the axes array.

Throws:

IllegalArgumentException - If axes is not a permutation of {1, 2, 3, ... N-1}.

add

public CooCTensor add(CooTensor B)

Computes the element-wise addition between two tensors of the same rank.

Specified by:

add in interface TensorExclusiveMixin<CooCTensor,CTensor,CooCTensor,CooCTensor>

Parameters:

B - Second tensor in the addition.

Returns:

The result of adding the tensor B to this tensor element-wise.

Throws:

IllegalArgumentException - If this tensor and B have different shapes.

add

public CTensor add(Tensor B)

Computes the element-wise addition between two tensors of the same rank.

Specified by:

add in interface TensorExclusiveMixin<CooCTensor,CTensor,CooCTensor,CooCTensor>

Parameters:

B - Second tensor in the addition.

Returns:

The result of adding the tensor B to this tensor element-wise.

Throws:

IllegalArgumentException - If this tensor and B have different shapes.

sub

public CTensor sub(Tensor B)

Computes the element-wise addition between two tensors of the same rank.

Specified by:

sub in interface TensorExclusiveMixin<CooCTensor,CTensor,CooCTensor,CooCTensor>

Parameters:

B - Second tensor in the addition.

Returns:

The result of adding the tensor B to this tensor element-wise.

Throws:

IllegalArgumentException - If this tensor and B have different shapes.

add

public CTensor add(CTensor B)

Computes the element-wise addition between two tensors of the same rank.

Specified by:

add in interface TensorExclusiveMixin<CooCTensor,CTensor,CooCTensor,CooCTensor>

Parameters:

B - Second tensor in the addition.

Returns:

The result of adding the tensor B to this tensor element-wise.

Throws:

IllegalArgumentException - If this tensor and B have different shapes.

add

public CooCTensor add(CooCTensor B)

Computes the element-wise addition between two tensors of the same rank.

Specified by:

add in interface TensorExclusiveMixin<CooCTensor,CTensor,CooCTensor,CooCTensor>

Specified by:

add in interface TensorOperationsMixin<CooCTensor,CTensor,CooCTensor,CTensor,CooTensor,CNumber>

Parameters:

B - Second tensor in the addition.

Returns:

The result of adding the tensor B to this tensor element-wise.

Throws:

IllegalArgumentException - If this tensor and B have different shapes.

sub

public CooCTensor sub(CooTensor B)

Computes the element-wise subtraction between two tensors of the same rank.

Specified by:

sub in interface TensorExclusiveMixin<CooCTensor,CTensor,CooCTensor,CooCTensor>

Parameters:

B - Second tensor in element-wise subtraction.

Returns:

The result of subtracting the tensor B from this tensor element-wise.

Throws:

IllegalArgumentException - If this tensor and B have different shapes.

sub

public CTensor sub(CTensor B)

Computes the element-wise subtraction between two tensors of the same rank.

Specified by:

sub in interface TensorExclusiveMixin<CooCTensor,CTensor,CooCTensor,CooCTensor>

Parameters:

B - Second tensor in element-wise subtraction.

Returns:

The result of subtracting the tensor B from this tensor element-wise.

Throws:

IllegalArgumentException - If this tensor and B have different shapes.

add

public CTensor add(double a)

Adds specified value to all entries of this tensor.

Specified by:

add in interface TensorOperationsMixin<CooCTensor,CTensor,CooCTensor,CTensor,CooTensor,CNumber>

Parameters:

a - Value to add to all entries of this tensor.

Returns:

The result of adding the specified value to each entry of this tensor.

add

public CTensor add(CNumber a)

Adds specified value to all entries of this tensor.

Specified by:

add in interface TensorOperationsMixin<CooCTensor,CTensor,CooCTensor,CTensor,CooTensor,CNumber>

Parameters:

a - Value to add to all entries of this tensor.

Returns:

The result of adding the specified value to each entry of this tensor.

sub

public CooCTensor sub(CooCTensor B)

Computes the element-wise subtraction between two tensors of the same rank.

Specified by:

sub in interface TensorExclusiveMixin<CooCTensor,CTensor,CooCTensor,CooCTensor>

Specified by:

sub in interface TensorOperationsMixin<CooCTensor,CTensor,CooCTensor,CTensor,CooTensor,CNumber>

Parameters:

B - Second tensor in element-wise subtraction.

Returns:

The result of subtracting the tensor B from this tensor element-wise.

Throws:

IllegalArgumentException - If this tensor and B have different shapes.

elemMult

public CooCTensor elemMult(Tensor B)

Computes the element-wise multiplication between two tensors.

Specified by:

elemMult in interface TensorExclusiveMixin<CooCTensor,CTensor,CooCTensor,CooCTensor>

Parameters:

B - Tensor to element-wise multiply to this tensor.

Returns:

The result of the element-wise tensor multiplication.

Throws:

IllegalArgumentException - If the tensors do not have the same shape.

elemMult

public CooCTensor elemMult(CooTensor B)

Computes the element-wise multiplication between two tensors.

Specified by:

elemMult in interface TensorExclusiveMixin<CooCTensor,CTensor,CooCTensor,CooCTensor>

Parameters:

B - Tensor to element-wise multiply to this tensor.

Returns:

The result of the element-wise tensor multiplication.

Throws:

IllegalArgumentException - If the tensors do not have the same shape.

elemMult

public CTensor elemMult(CTensor B)

Computes the element-wise multiplication between two tensors.

Specified by:

elemMult in interface TensorExclusiveMixin<CooCTensor,CTensor,CooCTensor,CooCTensor>

Parameters:

B - Tensor to element-wise multiply to this tensor.

Returns:

The result of the element-wise tensor multiplication.

Throws:

IllegalArgumentException - If the tensors do not have the same shape.

sub

public CTensor sub(double a)

Adds specified value to all entries of this tensor.

Specified by:

sub in interface TensorOperationsMixin<CooCTensor,CTensor,CooCTensor,CTensor,CooTensor,CNumber>

Parameters:

a - Value to add to all entries of this tensor.

Returns:

The result of adding the specified value to each entry of this tensor.

sub

public CTensor sub(CNumber a)

Subtracts a specified value from all entries of this tensor.

Specified by:

sub in interface TensorOperationsMixin<CooCTensor,CTensor,CooCTensor,CTensor,CooTensor,CNumber>

Parameters:

a - Value to subtract from all entries of this tensor.

Returns:

The result of subtracting the specified value from each entry of this tensor.

transpose

public CooCTensor transpose()

Computes the transpose of a tensor. Same as T().

Specified by:

transpose in interface TensorOperationsMixin<CooCTensor,CTensor,CooCTensor,CTensor,CooTensor,CNumber>

Returns:

The transpose of this tensor.

T

public CooCTensor T()

Computes the transpose of a tensor. Same as transpose().

Specified by:

T in interface TensorOperationsMixin<CooCTensor,CTensor,CooCTensor,CTensor,CooTensor,CNumber>

Returns:

The transpose of this tensor.

get

public CNumber get(int... indices)

Gets the element in this tensor at the specified indices.

Specified by:

get in interface TensorOperationsMixin<CooCTensor,CTensor,CooCTensor,CTensor,CooTensor,CNumber>

Parameters:

indices - Indices of element.

Returns:

The element at the specified indices.

Throws:

IllegalArgumentException - If the number of indices does not match the rank of this tensor.

copy

public CooCTensor copy()

Creates a copy of this tensor.

Specified by:

copy in interface TensorOperationsMixin<CooCTensor,CTensor,CooCTensor,CTensor,CooTensor,CNumber>

Returns:

A copy of this tensor.

elemMult

public CooCTensor elemMult(CooCTensor B)

Computes the element-wise multiplication between two tensors.

Specified by:

elemMult in interface TensorExclusiveMixin<CooCTensor,CTensor,CooCTensor,CooCTensor>

Specified by:

elemMult in interface TensorOperationsMixin<CooCTensor,CTensor,CooCTensor,CTensor,CooTensor,CNumber>

Parameters:

B - Tensor to element-wise multiply to this tensor.

Returns:

The result of the element-wise tensor multiplication.

Throws:

IllegalArgumentException - If this tensor and B do not have the same shape.

elemDiv

public CooCTensor elemDiv(CTensor B)

Computes the element-wise division between two tensors.

Specified by:

elemDiv in interface TensorExclusiveMixin<CooCTensor,CTensor,CooCTensor,CooCTensor>

Specified by:

elemDiv in interface TensorOperationsMixin<CooCTensor,CTensor,CooCTensor,CTensor,CooTensor,CNumber>

Parameters:

B - Tensor to element-wise divide with this tensor.

Returns:

The result of the element-wise tensor multiplication.

Throws:

IllegalArgumentException - If this tensor and B do not have the same shape.

elemDiv

public CooCTensor elemDiv(Tensor B)

Computes the element-wise division between two tensors.

Specified by:

elemDiv in interface TensorExclusiveMixin<CooCTensor,CTensor,CooCTensor,CooCTensor>

Parameters:

B - Tensor to element-wise divide from this tensor.

Returns:

The result of the element-wise tensor division.

Throws:

IllegalArgumentException - If the tensors do not have the same shape.

tensorInv

public CTensor tensorInv(int numIndices)

Computes the 'inverse' of this tensor. That is, computes the tensor X=this.tensorInv() such that this.tensorDot(X, numIndices) is the 'identity' tensor for the tensor dot product operation. A tensor I is the identity for a tensor dot product if this.tensorDot(I, numIndices).equals(this).

WARNING: This method will convert this tensor to a dense tensor.

Specified by:

tensorInv in interface TensorExclusiveMixin<CooCTensor,CTensor,CooCTensor,CooCTensor>

Parameters:

numIndices - The number of first numIndices which are involved in the inverse sum.

Returns:

The 'inverse' of this tensor as defined in the above sense.

See Also:

• TensorExclusiveMixin.tensorInv()

flatten

public CooCTensor flatten(int axis)

Flattens a tensor along the specified axis.

Specified by:

flatten in interface TensorManipulationsMixin<CooCTensor>

Parameters:

axis - Axis along which to flatten tensor.

Throws:

IllegalArgumentException - If the axis is not positive or larger than this.TensorBase.getRank()-1.

makeTensor

protected CooCTensor makeTensor(Shape shape,
 CNumber[] entries,
 int[][] indices)

A factory for creating a complex sparse tensor.

Specified by:

makeTensor in class ComplexSparseTensorBase<CooCTensor,CTensor,CooTensor>

Parameters:

shape - Shape of the sparse tensor to make.

entries - Non-zero entries of the sparse tensor to make.

indices - Non-zero indices of the sparse tensor to make.

Returns:

A tensor created from the specified parameters.

makeRealTensor

protected CooTensor makeRealTensor(Shape shape,
 double[] entries,
 int[][] indices)

A factory for creating a real sparse tensor.

Specified by:

makeRealTensor in class ComplexSparseTensorBase<CooCTensor,CTensor,CooTensor>

Parameters:

shape - Shape of the sparse tensor to make.

entries - Non-zero entries of the sparse tensor to make.

indices - Non-zero indices of the sparse tensor to make.

Returns:

A tensor created from the specified parameters.

sortIndices

public void sortIndices()

Sorts the indices of this tensor in lexicographical order while maintaining the associated value for each index.

Specified by:

sortIndices in interface SparseTensorMixin

Overrides:

sortIndices in class ComplexSparseTensorBase<CooCTensor,CTensor,CooTensor>

fromDense

public static CooCTensor fromDense(CTensor src)

Converts a sparse CooCTensor from a dense Tensor. This is likely only worthwhile for very sparse tensors.

Parameters:

src - Dense tensor to convert to sparse COO tensor.

Returns:

A COO tensor which is equivalent to the src dense tensor.

toMatrix

public CooCMatrix toMatrix(Shape matShape)

Converts this tensor to a matrix with the specified shape.

Parameters:

matShape - Shape of the resulting matrix. Must be broadcastable with the shape of this tensor.

Returns:

A matrix of shape matShape with the values of this tensor.

toDense

public CTensor toDense()

Converts this sparse tensor to an equivalent dense tensor.

Specified by:

toDense in class SparseTensorBase<CooCTensor,CTensor,CooCTensor,CTensor,CooTensor,CNumber[],CNumber>

Returns:

A dense tensor which is equivalent to this sparse tensor.

H

public CooCTensor H(int axis1,
 int axis2)

Computes the transpose of a tensor. Same as ComplexTensorExclusiveMixin.hermTranspose(int, int). In the context of a tensor, this exchanges the specified axes and takes the complex conjugate of elements along those axes. Also see hermTranspose() and H() to conjugate transpose first and last axes.

Specified by:

H in interface ComplexTensorExclusiveMixin<CooCTensor>

Parameters:

axis1 - First axis to exchange and apply complex conjugate.

axis2 - Second axis to exchange and apply complex conjugate.

Returns:

The conjugate transpose of this tensor.

H

public CooCTensor H(int... axes)

Computes the conjugate transpose of this tensor. That is, interchanges the axes of this tensor so that it matches the specified axes permutation and takes the complex conjugate of the elements of these axes. Same as ComplexTensorExclusiveMixin.hermTranspose(int[]).

Specified by:

H in interface ComplexTensorExclusiveMixin<CooCTensor>

Parameters:

axes - Permutation of tensor axis. If the tensor has rank N, then this must be an array of length N which is a permutation of {0, 1, 2, ..., N-1}.

Returns:

The conjugate transpose of this tensor with its axes permuted by the axes array.

Throws:

IllegalArgumentException - If axes is not a permutation of {1, 2, 3, ... N-1}.

addEq

public void addEq(Tensor B)

Computes the element-wise addition of two tensors of the same rank and stores the result in this tensor.

Specified by:

addEq in interface ComplexTensorExclusiveMixin<CooCTensor>

Parameters:

B - Second tensor in the addition.

Throws:

IllegalArgumentException - If this tensor and B have different shapes.

addEq

public void addEq(CooCTensor B)

Computes the element-wise addition of two tensors of the same rank and stores the result in this tensor.

Specified by:

addEq in interface ComplexTensorExclusiveMixin<CooCTensor>

Parameters:

B - Second tensor in the addition.

Throws:

IllegalArgumentException - If this tensor and B have different shapes.

subEq

public void subEq(Tensor B)

Computes the element-wise subtraction of two tensors of the same rank and stores the result in this tensor.

Specified by:

subEq in interface ComplexTensorExclusiveMixin<CooCTensor>

Parameters:

B - Second tensor in the subtraction.

Throws:

IllegalArgumentException - If this tensor and B have different shapes.

subEq

public void subEq(CooCTensor B)

Computes the element-wise subtraction of two tensors of the same rank and stores the result in this tensor.

Specified by:

subEq in interface ComplexTensorExclusiveMixin<CooCTensor>

Parameters:

B - Second tensor in the subtraction.

Throws:

IllegalArgumentException - If this tensor and B have different shapes.