Class AbstractCsrFieldMatrix<T extends AbstractCsrFieldMatrix<T,U,V,W>,U extends AbstractDenseFieldMatrix<U,?,W>,V extends AbstractCooFieldVector<V,?,?,U,W>,W extends Field<W>>

java.lang.Object

org.flag4j.arrays.backend.AbstractTensor<T,W[],W>

org.flag4j.arrays.backend.semiring_arrays.AbstractCsrSemiringMatrix<T,U,V,W>

org.flag4j.arrays.backend.ring_arrays.AbstractCsrRingMatrix<T,U,V,W>

org.flag4j.arrays.backend.field_arrays.AbstractCsrFieldMatrix<T,U,V,W>

All Implemented Interfaces:

Serializable, FieldTensorMixin<T,U,W>, TensorOverField<T,U,W[],W>, MatrixMixin<T,U,V,W>, RingTensorMixin<T,U,W>, TensorOverRing<T,U,W[],W>, SemiringTensorMixin<T,U,W>, TensorOverSemiring<T,U,W[],W>

Direct Known Subclasses:

CsrCMatrix, CsrFieldMatrix

public abstract class AbstractCsrFieldMatrix<T extends AbstractCsrFieldMatrix<T,U,V,W>,U extends AbstractDenseFieldMatrix<U,?,W>,V extends AbstractCooFieldVector<V,?,?,U,W>,W extends Field<W>>
extends AbstractCsrRingMatrix<T,U,V,W>
implements FieldTensorMixin<T,U,W>, MatrixMixin<T,U,V,W>

See Also:

• Serialized Form

Field Summary

Fields inherited from class org.flag4j.arrays.backend.semiring_arrays.AbstractCsrSemiringMatrix

colIndices, nnz, numCols, numRows, rowPointers, sparsity, zeroElement

Fields inherited from class org.flag4j.arrays.backend.AbstractTensor

data, rank, shape

Constructor Summary

Constructors

Modifier	Constructor	Description
protected	AbstractCsrFieldMatrix(Shape shape, W[] data, int[] rowPointers, int[] colIndices)	Creates a sparse CSR matrix with the specified shape, non-zero data, row pointers, and non-zero column indices.
protected	AbstractCsrFieldMatrix(Shape shape, W[] data, int[] rowPointers, int[] colIndices, Object dummy)	Creates a sparse CSR matrix with the specified shape, non-zero data, row pointers, and non-zero column indices.

Method Summary

Modifier and Type	Method	Description
CsrMatrix	abs()	Computes the element-wise absolute value of this tensor.
T	div(T b)	Computes the element-wise quotient between two tensors.
T	H()	Computes the Hermitian transpose of this matrix.
T	H(int... axes)	Computes the conjugate transpose of this tensor.
T	H(int axis1, int axis2)	Computes the conjugate transpose of a tensor by conjugating and exchanging axis1 and axis2.
boolean	isFinite()	Checks if this tensor only contains finite values.
boolean	isHermitian()	Checks if a matrix is Hermitian.
boolean	isInfinite()	Checks if this tensor contains at least one infinite value.
boolean	isNaN()	Checks if this tensor contains at least one NaN value.
boolean	isUnitary()	Checks if this matrix is orthogonal.
T	mult2Csr(T b)	Computes the matrix multiplication between two sparse CSR matrices and stores the result in a sparse matrix.
T	sqrt()	Computes the element-wise square root of this tensor.

Methods inherited from class org.flag4j.arrays.backend.ring_arrays.AbstractCsrRingMatrix

allClose, allClose, sub

Methods inherited from class org.flag4j.arrays.backend.semiring_arrays.AbstractCsrSemiringMatrix

add, augment, augment, coalesce, coalesce, copy, dataLength, density, elemMult, flatten, flatten, get, get, getSlice, getTriL, getTriU, getZeroElement, isI, isOrthogonal, isSymmetric, isTriL, isTriU, makeLikeCooMatrix, makeLikeDenseTensor, makeLikeTensor, makeLikeTensor, mult, multToSparse, multTranspose, numCols, numRows, removeCol, removeCols, removeRow, removeRows, reshape, set, set, setCol, setRow, setSliceCopy, setZeroElement, sortIndices, sparsity, stack, swapCols, swapRows, T, T, T, tensorTr, toCoo, toDense, toTensor, toTensor, toVector, tr

Methods inherited from class org.flag4j.arrays.backend.AbstractTensor

getData, getRank, getShape, makeLikeTensor, reshape, sameShape, totalEntries

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.flag4j.arrays.backend.field_arrays.FieldTensorMixin

add, add, addEq, addEq, argmax, argmaxAbs, argmin, argminAbs, conj, div, div, divEq, divEq, isOnes, isZeros, makeEmptyDataArray, max, maxAbs, min, minAbs, mult, mult, multEq, multEq, norm, norm, prod, recip, sub, sub, subEq, subEq, sum

Methods inherited from interface org.flag4j.arrays.backend.MatrixMixin

accept, add, augment, augment, copy, dataLength, elemMult, fib, get, getCol, getCol, getDiag, getDiag, getRow, getRow, getShape, getSlice, getTriL, getTriL, getTriU, getTriU, isDiag, isI, isOrthogonal, isSquare, isSymmetric, isTri, isTriL, isTriU, isVector, mult, mult, multTranspose, numCols, numRows, removeCol, removeCols, removeRow, removeRows, set, setCol, setRow, setSliceCopy, stack, stack, sub, swapCols, swapRows, T, toVector, tr, trace, vectorType

Methods inherited from interface org.flag4j.arrays.backend.semiring_arrays.SemiringTensorMixin

argmax, argmin, max, min

Methods inherited from interface org.flag4j.arrays.backend.ring_arrays.TensorOverRing

sub

Methods inherited from interface org.flag4j.arrays.backend.semiring_arrays.TensorOverSemiring

add, elemMult, getData, getRank, getShape, makeLikeTensor, tensorDot, tensorDot, tensorDot, tensorDot, tensorTr, tensorTr

Constructor Details

AbstractCsrFieldMatrix

protected AbstractCsrFieldMatrix(Shape shape,
 W[] data,
 int[] rowPointers,
 int[] colIndices)

Creates a sparse CSR matrix with the specified shape, non-zero data, row pointers, and non-zero column indices.

Parameters:

shape - Shape of this tensor.

data - The non-zero data of this CSR matrix.

rowPointers - The row pointers for the non-zero values in the sparse CSR matrix.

rowPointers[i] indicates the starting index within data and colData of all values in row i.

colIndices - Column indices for each non-zero value in this sparse CSR matrix. Must satisfy data.length == colData.length.

AbstractCsrFieldMatrix

protected AbstractCsrFieldMatrix(Shape shape,
 W[] data,
 int[] rowPointers,
 int[] colIndices,
 Object dummy)

Creates a sparse CSR matrix with the specified shape, non-zero data, row pointers, and non-zero column indices.

Parameters:

shape - Shape of this tensor.

data - The non-zero data of this CSR matrix.

rowPointers - The row pointers for the non-zero values in the sparse CSR matrix.

rowPointers[i] indicates the starting index within data and colData of all values in row i.

colIndices - Column indices for each non-zero value in this sparse CSR matrix. Must satisfy data.length == colData.length.

dummy - Dummy object to distinguish this constructor from the safe variant. It is completely ignored in this constructor.

Method Details

mult2Csr

public T mult2Csr(T b)

Computes the matrix multiplication between two sparse CSR matrices and stores the result in a sparse matrix.

Warning: this method should be used with caution as sparse-sparse matrix multiplication may result in a dense matrix. In such a case, this method will likely be significantly slower than AbstractCsrSemiringMatrix.mult(AbstractCsrSemiringMatrix).

Parameters:

b - Second matrix in the matrix multiplication.

Returns:

The result of matrix multiplying this matrix with matrix b as a sparse CSR matrix.

See Also:

• AbstractCsrSemiringMatrix.mult(AbstractCsrSemiringMatrix)

isHermitian

public boolean isHermitian()

Checks if a matrix is Hermitian. That is, if the matrix is square and equal to its conjugate transpose.

Specified by:

isHermitian in interface MatrixMixin<T extends AbstractCsrFieldMatrix<T,U,V,W>,U extends AbstractDenseFieldMatrix<U,?,W>,V extends AbstractCooFieldVector<V,?,?,U,W>,W extends Field<W>>

Overrides:

isHermitian in class AbstractCsrSemiringMatrix<T extends AbstractCsrFieldMatrix<T,U,V,W>,U extends AbstractDenseFieldMatrix<U,?,W>,V extends AbstractCooFieldVector<V,?,?,U,W>,W extends Field<W>>

Returns:

true if this matrix is Hermitian; false otherwise.

isUnitary

public boolean isUnitary()

Checks if this matrix is orthogonal. That is, if the inverse of this matrix is equal to its transpose.

Returns:

true if this matrix it is orthogonal; false otherwise.

abs

public CsrMatrix abs()

Computes the element-wise absolute value of this tensor.

Specified by:

abs in interface TensorOverRing<T extends AbstractCsrFieldMatrix<T,U,V,W>,U extends AbstractDenseFieldMatrix<U,?,W>,V extends AbstractCooFieldVector<V,?,?,U,W>,W extends Field<W>>

Returns:

The element-wise absolute value of this tensor.

H

public T H()

Computes the Hermitian transpose of this matrix.

Specified by:

H in interface MatrixMixin<T extends AbstractCsrFieldMatrix<T,U,V,W>,U extends AbstractDenseFieldMatrix<U,?,W>,V extends AbstractCooFieldVector<V,?,?,U,W>,W extends Field<W>>

Specified by:

H in interface TensorOverRing<T extends AbstractCsrFieldMatrix<T,U,V,W>,U extends AbstractDenseFieldMatrix<U,?,W>,V extends AbstractCooFieldVector<V,?,?,U,W>,W extends Field<W>>

Overrides:

H in class AbstractCsrRingMatrix<T extends AbstractCsrFieldMatrix<T,U,V,W>,U extends AbstractDenseFieldMatrix<U,?,W>,V extends AbstractCooFieldVector<V,?,?,U,W>,W extends Field<W>>

Returns:

The Hermitian transpose of this matrix.

See Also:

• TensorOverRing.H(int, int)
• TensorOverRing.H(int...)

H

public T H(int axis1,
 int axis2)

Computes the conjugate transpose of a tensor by conjugating and exchanging axis1 and axis2.

Specified by:

H in interface TensorOverRing<T extends AbstractCsrFieldMatrix<T,U,V,W>,U extends AbstractDenseFieldMatrix<U,?,W>,V extends AbstractCooFieldVector<V,?,?,U,W>,W extends Field<W>>

Overrides:

H in class AbstractCsrRingMatrix<T extends AbstractCsrFieldMatrix<T,U,V,W>,U extends AbstractDenseFieldMatrix<U,?,W>,V extends AbstractCooFieldVector<V,?,?,U,W>,W extends Field<W>>

Parameters:

axis1 - First axis to exchange and conjugate.

axis2 - Second axis to exchange and conjugate.

Returns:

The conjugate transpose of this tensor according to the specified axes.

Throws:

IndexOutOfBoundsException - If either axis1 or axis2 are out of bounds for the rank of this tensor.

See Also:

• H()
• H(int...)

H

public T H(int... axes)

Computes the conjugate transpose of this tensor. That is, conjugates and permutes the axes of this tensor so that it matches the permutation specified by axes.

Specified by:

H in interface TensorOverRing<T extends AbstractCsrFieldMatrix<T,U,V,W>,U extends AbstractDenseFieldMatrix<U,?,W>,V extends AbstractCooFieldVector<V,?,?,U,W>,W extends Field<W>>

Overrides:

H in class AbstractCsrRingMatrix<T extends AbstractCsrFieldMatrix<T,U,V,W>,U extends AbstractDenseFieldMatrix<U,?,W>,V extends AbstractCooFieldVector<V,?,?,U,W>,W extends Field<W>>

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:

IndexOutOfBoundsException - If any element of axes is out of bounds for the rank of this tensor.

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

See Also:

• H(int, int)
• H()

div

public T div(T b)

Computes the element-wise quotient between two tensors.

WARNING: This method is not supported for sparse tensors. If called on a sparse tensor, an UnsupportedOperationException will be thrown. Element-wise division is undefined for sparse matrices as it would almost certainly result in a division by zero.

Specified by:

div in interface MatrixMixin<T extends AbstractCsrFieldMatrix<T,U,V,W>,U extends AbstractDenseFieldMatrix<U,?,W>,V extends AbstractCooFieldVector<V,?,?,U,W>,W extends Field<W>>

Specified by:

div in interface TensorOverField<T extends AbstractCsrFieldMatrix<T,U,V,W>,U extends AbstractDenseFieldMatrix<U,?,W>,V extends AbstractCooFieldVector<V,?,?,U,W>,W extends Field<W>>

Overrides:

div in class AbstractCsrRingMatrix<T extends AbstractCsrFieldMatrix<T,U,V,W>,U extends AbstractDenseFieldMatrix<U,?,W>,V extends AbstractCooFieldVector<V,?,?,U,W>,W extends Field<W>>

Parameters:

b - Second tensor in the element-wise quotient.

Returns:

The element-wise quotient of this tensor with b.

Throws:

UnsupportedOperationException - if this method is ever invoked on a sparse tensor.

sqrt

public T sqrt()

Computes the element-wise square root of this tensor.

Specified by:

sqrt in interface TensorOverField<T extends AbstractCsrFieldMatrix<T,U,V,W>,U extends AbstractDenseFieldMatrix<U,?,W>,V extends AbstractCooFieldVector<V,?,?,U,W>,W extends Field<W>>

Returns:

The element-wise square root of this tensor.

isFinite

public boolean isFinite()

Checks if this tensor only contains finite values.

Specified by:

isFinite in interface TensorOverField<T extends AbstractCsrFieldMatrix<T,U,V,W>,U extends AbstractDenseFieldMatrix<U,?,W>,V extends AbstractCooFieldVector<V,?,?,U,W>,W extends Field<W>>

Returns:

true if this tensor only contains finite values; false otherwise.

See Also:

• isInfinite()
• isNaN()

isInfinite

public boolean isInfinite()

Checks if this tensor contains at least one infinite value.

Specified by:

isInfinite in interface TensorOverField<T extends AbstractCsrFieldMatrix<T,U,V,W>,U extends AbstractDenseFieldMatrix<U,?,W>,V extends AbstractCooFieldVector<V,?,?,U,W>,W extends Field<W>>

Returns:

true if this tensor contains at least one infinite value; false otherwise.

See Also:

• isFinite()
• isNaN()

isNaN

public boolean isNaN()

Checks if this tensor contains at least one NaN value.

Specified by:

isNaN in interface TensorOverField<T extends AbstractCsrFieldMatrix<T,U,V,W>,U extends AbstractDenseFieldMatrix<U,?,W>,V extends AbstractCooFieldVector<V,?,?,U,W>,W extends Field<W>>

Returns:

true if this tensor contains at least one NaN value; false otherwise.

See Also:

• isFinite()
• isInfinite()