Package org.flag4j.arrays.sparse

Class CsrMatrix

java.lang.Object

org.flag4j.core.TensorBase<CsrMatrix,Matrix,CsrCMatrix,CMatrix,CsrMatrix,double[],Double>

org.flag4j.core.sparse_base.SparseTensorBase<CsrMatrix,Matrix,CsrCMatrix,CMatrix,CsrMatrix,double[],Double>

org.flag4j.core.sparse_base.RealSparseTensorBase<CsrMatrix,Matrix,CsrCMatrix,CMatrix>

org.flag4j.arrays.sparse.CsrMatrix

All Implemented Interfaces:

Serializable, MatrixComparisonsMixin<CsrMatrix>, MatrixManipulationsMixin<CsrMatrix,Double>, MatrixMixin<CsrMatrix,Matrix,CsrMatrix,CsrCMatrix,CsrCMatrix,Double,CooVector,Vector>, MatrixOperationsMixin<CsrMatrix,Matrix,CsrMatrix,CsrCMatrix,CsrCMatrix,Double,CooVector,Vector>, MatrixPropertiesMixin, RealMatrixMixin<CsrMatrix,CsrCMatrix>, RealTensorMixin<CsrMatrix,CsrCMatrix>, SparseTensorMixin, TensorComparisonsMixin, TensorManipulationsMixin<CsrMatrix>, TensorOperationsMixin<CsrMatrix,Matrix,CsrCMatrix,CMatrix,CsrMatrix,Double>, TensorPropertiesMixin

public class CsrMatrix
extends RealSparseTensorBase<CsrMatrix,Matrix,CsrCMatrix,CMatrix>
implements MatrixMixin<CsrMatrix,Matrix,CsrMatrix,CsrCMatrix,CsrCMatrix,Double,CooVector,Vector>, RealMatrixMixin<CsrMatrix,CsrCMatrix>

Real sparse matrix stored in compressed sparse row (CSR) format.

CSR matrices are best suited for efficient access and matrix operations. Specifically, matrix-matrix and matrix-vector multiplication. CSR matrices are not well suited for modification (see CooMatrix).

The CSR format stores a sparse m-by-n matrix as three one-dimensional arrays: TensorBase.entries, rowPointers, and colIndices.

• entries: Stores the non-zero values of the sparse matrix. Note, zero values can be stored explicitly in this array. Hence, the term "non-zero values" is a misnomer.
• rowPointers: Encodes the total number of non-zero values above each row. Has length m+1. For example, rowPointers[j] contains the total number of non-zero values above row j. The first entry is always 0 and the last element is always entries.length
• colIndices: Contains the column indices for all non-zero entries. Has length entries.length

See Also:

• CooMatrix
• CsrCMatrix
• Serialized Form

Field Summary

Fields

Modifier and Type	Field	Description
final int[]	colIndices	Column indices of the non-zero entries of the sparse matrix.
final int	numCols	The number of columns in this matrix.
final int	numRows	The number of rows in this matrix.
final int[]	rowPointers	Row indices of the non-zero entries of the sparse matrix.

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
CsrMatrix(int numRows, int numCols)	Constructs an empty sparse CSR matrix with the specified shape.
CsrMatrix(int numRows, int numCols, double[] entries, int[] rowPointers, int[] colIndices)	Constructs a sparse matrix in CSR format with specified row-pointers, column indices and non-zero entries.
CsrMatrix(CooMatrix src)	Converts a sparse COO matrix to a sparse CSR matrix.
CsrMatrix(CsrMatrix src)	Constructs a sparse CSR matrix which is a deep copy of the src matrix.
CsrMatrix(Shape shape)	Constructs an empty sparse CSR matrix with the specified shape.
CsrMatrix(Shape shape, double[] entries, int[] rowPointers, int[] colIndices)	Constructs a sparse matrix in CSR format with specified row-pointers, column indices and non-zero entries.

Method Summary

Modifier and Type	Method	Description
Matrix	add(double a)	Adds specified value to all entries of this tensor.
CMatrix	add(CMatrix B)	Computes the element-wise addition between two tensors of the same rank.
Matrix	add(Matrix B)	Computes the element-wise addition between two matrices.
CsrCMatrix	add(CooCMatrix B)	Computes the element-wise addition between two tensors of the same rank.
CsrMatrix	add(CooMatrix B)	Computes the element-wise addition between two sparse matrices.
CsrCMatrix	add(CsrCMatrix B)	Computes the element-wise addition between two tensors of the same rank.
CsrMatrix	add(CsrMatrix B)	Computes the element-wise addition between two tensors of the same rank.
CMatrix	add(CNumber a)	Adds specified value to all entries of this tensor.
CMatrix	addToEachCol(CVector b)	Adds a vector to each column of a matrix.
Matrix	addToEachCol(Vector b)	Adds a vector to each column of a matrix.
CMatrix	addToEachCol(CooCVector b)	Adds a vector to each column of a matrix.
Matrix	addToEachCol(CooVector b)	Adds a vector to each column of a matrix.
CMatrix	addToEachRow(CVector b)	Adds a vector to each row of a matrix.
Matrix	addToEachRow(Vector b)	Adds a vector to each row of a matrix.
CMatrix	addToEachRow(CooCVector b)	Adds a vector to each row of a matrix.
Matrix	addToEachRow(CooVector b)	Adds a vector to each row of a matrix.
boolean	allClose(CsrMatrix src, double relTol, double absTol)	Checks if all entries of this tensor are close to the entries of the argument tensor.
CMatrix	augment(CMatrix B)	Stacks matrices along rows.
CsrCMatrix	augment(CVector b)	Augments a matrix with a vector.
Matrix	augment(Matrix B)	Stacks matrices along rows.
CsrMatrix	augment(Vector b)	Augments a matrix with a vector.
CsrCMatrix	augment(CooCMatrix B)	Stacks matrices along rows.
CsrCMatrix	augment(CooCVector b)	Augments a matrix with a vector.
CsrMatrix	augment(CooMatrix B)	Stacks matrices along rows.
CsrMatrix	augment(CooVector b)	Augments a matrix with a vector.
CsrCMatrix	augment(CsrCMatrix B)	Stacks matrices along rows.
CsrMatrix	augment(CsrMatrix B)	Stacks matrices along rows.
CsrMatrix	copy()	Creates a copy of this tensor.
Double	det()	Computes the determinant of a square matrix.
CsrCMatrix	elemDiv(CMatrix B)	Computes the element-wise division between two matrices.
CsrMatrix	elemDiv(Matrix B)	Computes the element-wise division between two tensors.
CsrCMatrix	elemMult(CMatrix B)	Computes the element-wise multiplication (Hadamard product) between two matrices.
CsrMatrix	elemMult(Matrix B)	Computes the element-wise multiplication (Hadamard product) between two matrices.
CsrCMatrix	elemMult(CooCMatrix B)	Computes the element-wise multiplication (Hadamard product) between two matrices.
CsrMatrix	elemMult(CooMatrix B)	Computes the element-wise multiplication (Hadamard product) between two matrices.
CsrCMatrix	elemMult(CsrCMatrix B)	Computes the element-wise multiplication (Hadamard product) between two matrices.
CsrMatrix	elemMult(CsrMatrix B)	Computes the element-wise multiplication between two tensors.
boolean	equals(Object src2)	Checks if this CSR matrix is equal to another CSR matrix.
CNumber	fib(CMatrix B)	Computes the Frobenius inner product of two matrices.
Double	fib(Matrix B)	Computes the Frobenius inner product of two matrices.
CNumber	fib(CooCMatrix B)	Computes the Frobenius inner product of two matrices.
Double	fib(CooMatrix B)	Computes the Frobenius inner product of two matrices.
CNumber	fib(CsrCMatrix B)	Computes the Frobenius inner product of two matrices.
Double	fib(CsrMatrix B)	Computes the Frobenius inner product of two matrices.
CsrMatrix	flatten()	Flattens tensor to single dimension.
CsrMatrix	flatten(int axis)	Flattens a tensor along the specified axis.
Double	get(int... indices)	Gets the element in this tensor at the specified indices.
CooVector	getCol(int j)	Get the column of this matrix at the specified index.
CooVector	getCol(int colIdx, int rowStart, int rowEnd)	Gets a specified column of this matrix between rowStart (inclusive) and rowEnd (exclusive).
CooVector	getColBelow(int rowStart, int j)	Get a specified column of this matrix at and below a specified row.
CooVector	getDiag()	Extracts the diagonal elements of this matrix and returns them as a vector.
CooVector	getRow(int i)	Get the row of this matrix at the specified index.
CooVector	getRowAfter(int colStart, int rowIdx)	Get a specified row of this matrix at and after a specified column.
protected CsrMatrix	getSelf()	Simply returns a reference of this tensor.
CsrMatrix	getSlice(int rowStart, int rowEnd, int colStart, int colEnd)	Gets a specified slice of this matrix.
CsrMatrix	H()	Compute the hermitian transpose of this matrix.
int	hashCode()
static CsrMatrix	I(int size)	Constructs an identity matrix stored in CSR format with the specified shape.
static CsrMatrix	I(int numRows, int numCols)	Constructs an identity-like matrix stored in CSR format with the specified shape.
static CsrMatrix	I(Shape shape)	Constructs an identity-like matrix stored in CSR format with the specified shape.
boolean	isAntiSymmetric()	Checks if a matrix is anti-symmetric.
boolean	isDiag()	Checks if this matrix is diagonal.
boolean	isFullRank()	Checks if a matrix has full rank.
boolean	isI()	Checks if this matrix is the identity matrix.
boolean	isOrthogonal()	Checks if this matrix is orthogonal.
boolean	isSingular()	Checks if a matrix is singular.
boolean	isSquare()	Checks if this matrix is square.
boolean	isSymmetric()	Checks if a matrix is symmetric.
boolean	isTri()	Checks if this matrix is triangular (i.e.
boolean	isTriL()	Checks if this matrix is lower triangular.
boolean	isTriU()	Checks if this matrix is upper triangular.
boolean	isVector()	Checks if a matrix can be represented as a vector.
protected CsrCMatrix	makeComplexTensor(Shape shape, CNumber[] entries, int[][] indices)	A factory for creating a complex sparse tensor.
protected Matrix	makeDenseTensor(Shape shape, double[] entries)	A factory for creating a real dense tensor.
protected CsrMatrix	makeTensor(Shape shape, double[] entries, int[][] indices)	A factory for creating a real sparse tensor.
int	matrixRank()	Computes the rank of this matrix (i.e.
CMatrix	mult(CMatrix B)	Computes the matrix multiplication between two matrices.
CVector	mult(CVector b)	Computes matrix-vector multiplication.
Matrix	mult(Matrix B)	Computes the matrix multiplication between two matrices.
Vector	mult(Vector b)	Computes matrix-vector multiplication.
CMatrix	mult(CooCMatrix B)	Computes the matrix multiplication between two matrices.
CVector	mult(CooCVector b)	Computes matrix-vector multiplication.
Matrix	mult(CooMatrix B)	Computes the matrix multiplication between two matrices.
Vector	mult(CooVector b)	Computes the matrix-vector multiplication.
CMatrix	mult(CsrCMatrix B)	Computes the matrix multiplication between two sparse CSR matrices.
Matrix	mult(CsrMatrix B)	Computes the matrix multiplication between two sparse CSR matrices.
CsrCMatrix	mult2CSR(CooCMatrix B)	Computes the matrix multiplication between two sparse matrices and stores the result in a CSR matrix.
CsrMatrix	mult2CSR(CooMatrix B)	Computes the matrix multiplication between two sparse matrices and stores the result in a CSR matrix.
CsrCMatrix	mult2CSR(CsrCMatrix B)	Computes the matrix multiplication between two sparse CSR matrices and stores the result in a CSR matrix.
CsrMatrix	mult2CSR(CsrMatrix B)	Computes the matrix multiplication between two sparse CSR matrices and stores the result in a CSR matrix.
int	numCols()	Gets the number of columns in this matrix.
int	numRows()	Gets the number of rows in this matrix.
Matrix	pow(int exponent)	Computes the matrix power with a given exponent.
CsrMatrix	removeCol(int colIndex)	Removes a specified column from this matrix.
CsrMatrix	removeCols(int... colIndices)	Removes a specified set of columns from this matrix.
CsrMatrix	removeRow(int rowIndex)	Removes a specified row from this matrix.
CsrMatrix	removeRows(int... rowIndices)	Removes a specified set of rows from this matrix.
CsrMatrix	reshape(Shape newShape)	Copies and reshapes matrix if possible.
CsrMatrix	set(double value, int... indices)	Sets an index of this tensor to a specified value.
CsrMatrix	set(double value, int row, int col)	Sets an index of this matrix to the specified value.
CsrMatrix	set(Double value, int row, int col)	Sets an index of this matrix to the specified value.
CsrMatrix	setCol(double[] values, int colIndex)	Sets a column of this matrix at the given index to the specified values.
CsrMatrix	setCol(int[] values, int colIndex)	Sets a column of this matrix at the given index to the specified values.
CsrMatrix	setCol(Double[] values, int colIndex)	Sets a column of this matrix at the given index to the specified values.
CsrMatrix	setCol(Integer[] values, int colIndex)	Sets a column of this matrix at the given index to the specified values.
CsrMatrix	setCol(CooVector values, int j)	Sets a column of this matrix.
CsrMatrix	setRow(double[] values, int rowIndex)	Sets a row of this matrix at the given index to the specified values.
CsrMatrix	setRow(int[] values, int rowIndex)	Sets a row of this matrix at the given index to the specified values.
CsrMatrix	setRow(Double[] values, int rowIndex)	Sets a row of this matrix at the given index to the specified values.
CsrMatrix	setRow(Integer[] values, int rowIndex)	Sets a row of this matrix at the given index to the specified values.
CsrMatrix	setSlice(double[][] values, int rowStart, int colStart)	Sets a slice of this matrix to the specified values.
CsrMatrix	setSlice(int[][] values, int rowStart, int colStart)	Sets a slice of this matrix to the specified values.
CsrMatrix	setSlice(Double[][] values, int rowStart, int colStart)	Sets a slice of this matrix to the specified values.
CsrMatrix	setSlice(Integer[][] values, int rowStart, int colStart)	Sets a slice of this matrix to the specified values.
CsrMatrix	setSlice(Matrix values, int rowStart, int colStart)	Sets a slice of this matrix to the specified values.
CsrMatrix	setSlice(CooMatrix values, int rowStart, int colStart)	Sets a slice of this matrix to the specified values.
CsrMatrix	setSlice(CsrMatrix values, int rowStart, int colStart)	Sets a slice of this matrix to the specified values.
Shape	shape()	Gets the shape of this matrix.
CsrCMatrix	sqrtComplex()	Computes the complex element-wise square root of a tensor.
CMatrix	stack(CMatrix B)	Stacks matrices along columns.
CsrCMatrix	stack(CVector b)	Stacks vector to this matrix along columns.
Matrix	stack(Matrix B)	Stacks matrices along columns.
CsrMatrix	stack(Vector b)	Stacks vector to this matrix along columns.
CsrCMatrix	stack(CooCMatrix B)	Stacks matrices along columns.
CsrCMatrix	stack(CooCVector b)	Stacks vector to this matrix along columns.
CsrMatrix	stack(CooMatrix B)	Stacks matrices along columns.
CsrMatrix	stack(CooVector b)	Stacks vector to this matrix along columns.
CsrCMatrix	stack(CsrCMatrix B)	Stacks matrices along columns.
CsrMatrix	stack(CsrMatrix B)	Stacks matrices along columns.
Matrix	sub(double a)	Adds specified value to all entries of this tensor.
CMatrix	sub(CMatrix B)	Computes the element-wise subtraction of two tensors of the same rank.
Matrix	sub(Matrix B)	Computes the element-wise subtraction of two tensors of the same rank.
CsrCMatrix	sub(CooCMatrix B)	Computes the element-wise subtraction of two tensors of the same rank.
CsrMatrix	sub(CooMatrix B)	Computes the element-wise subtraction of two sparse matrices.
CsrCMatrix	sub(CsrCMatrix B)	Computes the element-wise subtraction of two tensors of the same rank.
CsrMatrix	sub(CsrMatrix B)	Computes the element-wise subtraction between two tensors of the same rank.
CMatrix	sub(CNumber a)	Subtracts a specified value from all entries of this tensor.
Vector	sumCols()	Sums together the columns of a matrix as if each column was a column vector.
Vector	sumRows()	Sums together the rows of a matrix as if each row was a row vector.
CsrMatrix	swapCols(int colIndex1, int colIndex2)	Swaps columns in the matrix.
CsrMatrix	swapRows(int rowIndex1, int rowIndex2)	Swaps two rows in this matrix.
CsrMatrix	T()	Computes the transpose of a tensor.
CsrCMatrix	toComplex()	Converts this tensor to an equivalent complex tensor.
CooMatrix	toCoo()	Converts this CSR matrix to an equivalent COO matrix.
Matrix	toDense()	Converts this sparse tensor to an equivalent dense tensor.
String	toString()	Formats this sparse CSR matrix as a human-readable string.
CooTensor	toTensor()	Converts this matrix to an equivalent sparse tensor.
CooVector	toVector()	Converts this matrix to an equivalent vector.
Double	tr()	Computes the trace of this matrix.
Double	trace()	Computes the trace of this matrix.
int	vectorType()	Checks what type of vector this matrix is.

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

abs, argMax, argMin, div, div, isNeg, isOnes, isPos, isZeros, max, maxAbs, min, minAbs, mult, mult, nonZeroEntries, recip, reshape, round, round, roundToZero, roundToZero, sortIndices, sqrt, sum

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, notify, notifyAll, wait, wait, wait

Methods inherited from interface org.flag4j.core.MatrixOperationsMixin

mult, multTranspose, multTranspose, multTranspose, multTranspose, multTranspose, multTranspose, stack, stack, stack, stack, stack, stack, stack, stack, stack, stack

Methods inherited from interface org.flag4j.core.MatrixPropertiesMixin

isInvertible

Methods inherited from interface org.flag4j.core.TensorOperationsMixin

transpose

Field Details

rowPointers

public final int[] rowPointers

Row indices of the non-zero entries of the sparse matrix.

colIndices

public final int[] colIndices

Column indices of the non-zero entries of the sparse matrix.

numRows

public final int numRows

The number of rows in this matrix.

numCols

public final int numCols

The number of columns in this matrix.

Constructor Details

CsrMatrix

public CsrMatrix(Shape shape)

Constructs an empty sparse CSR matrix with the specified shape.

Parameters:

shape - Shape of the CSR matrix.

CsrMatrix

public CsrMatrix(int numRows,
 int numCols)

Constructs an empty sparse CSR matrix with the specified shape.

Parameters:

numRows - Number of rows in the CSR matrix.

numCols - Number of columns in the CSR matrix.

CsrMatrix

public CsrMatrix(Shape shape,
 double[] entries,
 int[] rowPointers,
 int[] colIndices)

Constructs a sparse matrix in CSR format with specified row-pointers, column indices and non-zero entries.

Parameters:

shape - Shape of the matrix.

entries - Non-zero entries for CSR matrix.

rowPointers - Row pointers for CSR matrix.

colIndices - Column indices for CSR matrix.

CsrMatrix

public CsrMatrix(int numRows,
 int numCols,
 double[] entries,
 int[] rowPointers,
 int[] colIndices)

Constructs a sparse matrix in CSR format with specified row-pointers, column indices and non-zero entries.

Parameters:

numRows - Number of rows in the CSR matrix.

numCols - Number of columns in the CSR matrix.

entries - Non-zero entries for CSR matrix.

rowPointers - Row pointers for CSR matrix.

colIndices - Column indices for CSR matrix.

CsrMatrix

public CsrMatrix(CsrMatrix src)

Constructs a sparse CSR matrix which is a deep copy of the src matrix.

Parameters:

src - Matrix to create copy of.

CsrMatrix

public CsrMatrix(CooMatrix src)

Converts a sparse COO matrix to a sparse CSR matrix.

Parameters:

src - COO matrix to convert. Indices must be sorted lexicographically.

Method Details

equals

public boolean equals(Object src2)

Checks if this CSR matrix is equal to another CSR matrix.

Specified by:

equals in interface TensorComparisonsMixin

Overrides:

equals in class Object

Parameters:

src2 - Object to compare this matrix to.

Returns:

True if src2 is an instance of CsrMatrix this CSR matrix is equal to src2. False otherwise. If src2 is null, false is returned.

mult2CSR

public CsrMatrix mult2CSR(CsrMatrix B)

Computes the matrix multiplication between two sparse CSR matrices and stores the result in a CSR matrix. Warning: This method will likely be slower than mult(CsrMatrix) if the result of multiplying this matrix with B is not very sparse. Further, multiplying two sparse matrices may result in a dense matrix so this method should be used with caution.

Parameters:

B - Matrix to multiply to this matrix.

Returns:

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

mult2CSR

public CsrCMatrix mult2CSR(CsrCMatrix B)

Computes the matrix multiplication between two sparse CSR matrices and stores the result in a CSR matrix. Warning: This method will likely be slower than mult(CsrCMatrix) if the result of multiplying this matrix with B is not very sparse. Further, multiplying two sparse matrices may result in a dense matrix so this method should be used with caution.

Parameters:

B - Matrix to multiply to this matrix.

Returns:

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

mult2CSR

public CsrMatrix mult2CSR(CooMatrix B)

Computes the matrix multiplication between two sparse matrices and stores the result in a CSR matrix. Warning: This method will likely be slower than mult(CooMatrix) if the result of multiplying this matrix with B is not very sparse. Further, multiplying two sparse matrices may result in a dense matrix so this method should be used with caution.

Parameters:

B - Matrix to multiply to this matrix.

Returns:

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

mult2CSR

public CsrCMatrix mult2CSR(CooCMatrix B)

Computes the matrix multiplication between two sparse matrices and stores the result in a CSR matrix. Warning: This method will likely be slower than mult(CooCMatrix) if the result of multiplying this matrix with B is not very sparse. Further, multiplying two sparse matrices may result in a dense matrix so this method should be used with caution.

Parameters:

B - Matrix to multiply to this matrix.

Returns:

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

add

public Matrix add(Matrix B)

Computes the element-wise addition between two matrices.

Specified by:

add in interface MatrixOperationsMixin<CsrMatrix,Matrix,CsrMatrix,CsrCMatrix,CsrCMatrix,Double,CooVector,Vector>

Parameters:

B - Second matrix in the addition.

Returns:

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

Throws:

IllegalArgumentException - If A and B have different shapes.

add

public CsrMatrix add(CooMatrix B)

Computes the element-wise addition between two sparse matrices. Note that the CooMatrix is simply converted to a csr matrix first.

Specified by:

add in interface MatrixOperationsMixin<CsrMatrix,Matrix,CsrMatrix,CsrCMatrix,CsrCMatrix,Double,CooVector,Vector>

Parameters:

B - Second sparse matrix in the sum.

Returns:

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

Throws:

IllegalArgumentException - If A and B have different shapes.

add

public CMatrix add(CMatrix B)

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

Specified by:

add in interface MatrixOperationsMixin<CsrMatrix,Matrix,CsrMatrix,CsrCMatrix,CsrCMatrix,Double,CooVector,Vector>

Parameters:

B - Second tensor in the addition.

Returns:

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

Throws:

IllegalArgumentException - If A and B have different shapes.

add

public CsrCMatrix add(CooCMatrix B)

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

Specified by:

add in interface MatrixOperationsMixin<CsrMatrix,Matrix,CsrMatrix,CsrCMatrix,CsrCMatrix,Double,CooVector,Vector>

Parameters:

B - Second tensor in the addition.

Returns:

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

Throws:

IllegalArgumentException - If A and B have different shapes.

add

public CsrCMatrix add(CsrCMatrix B)

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

Specified by:

add in interface MatrixOperationsMixin<CsrMatrix,Matrix,CsrMatrix,CsrCMatrix,CsrCMatrix,Double,CooVector,Vector>

Parameters:

B - Second tensor in the addition.

Returns:

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

Throws:

IllegalArgumentException - If A and B have different shapes.

sub

public Matrix sub(Matrix B)

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

Specified by:

sub in interface MatrixOperationsMixin<CsrMatrix,Matrix,CsrMatrix,CsrCMatrix,CsrCMatrix,Double,CooVector,Vector>

Parameters:

B - Second tensor in the subtraction.

Returns:

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

Throws:

IllegalArgumentException - If A and B have different shapes.

sub

public CsrMatrix sub(CooMatrix B)

Computes the element-wise subtraction of two sparse matrices. Note, the CooMatrix is simply converted to a CsrMatrix first.

Specified by:

sub in interface MatrixOperationsMixin<CsrMatrix,Matrix,CsrMatrix,CsrCMatrix,CsrCMatrix,Double,CooVector,Vector>

Parameters:

B - Second tensor in the subtraction.

Returns:

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

Throws:

IllegalArgumentException - If A and B have different shapes.

sub

public CMatrix sub(CMatrix B)

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

Specified by:

sub in interface MatrixOperationsMixin<CsrMatrix,Matrix,CsrMatrix,CsrCMatrix,CsrCMatrix,Double,CooVector,Vector>

Parameters:

B - Second tensor in the subtraction.

Returns:

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

Throws:

IllegalArgumentException - If A and B have different shapes.

sub

public CsrCMatrix sub(CooCMatrix B)

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

Specified by:

sub in interface MatrixOperationsMixin<CsrMatrix,Matrix,CsrMatrix,CsrCMatrix,CsrCMatrix,Double,CooVector,Vector>

Parameters:

B - Second tensor in the subtraction.

Returns:

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

Throws:

IllegalArgumentException - If A and B have different shapes.

sub

public CsrCMatrix sub(CsrCMatrix B)

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

Specified by:

sub in interface MatrixOperationsMixin<CsrMatrix,Matrix,CsrMatrix,CsrCMatrix,CsrCMatrix,Double,CooVector,Vector>

Parameters:

B - Second tensor in the subtraction.

Returns:

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

Throws:

IllegalArgumentException - If A and B have different shapes.

mult

public Matrix mult(Matrix B)

Computes the matrix multiplication between two matrices.

Specified by:

mult in interface MatrixOperationsMixin<CsrMatrix,Matrix,CsrMatrix,CsrCMatrix,CsrCMatrix,Double,CooVector,Vector>

Parameters:

B - Second matrix in the matrix multiplication.

Returns:

The result of matrix multiplying this matrix with matrix B.

Throws:

IllegalArgumentException - If the number of columns in this matrix do not equal the number of rows in matrix B.

mult

public Vector mult(CooVector b)

Computes the matrix-vector multiplication.

Specified by:

mult in interface MatrixOperationsMixin<CsrMatrix,Matrix,CsrMatrix,CsrCMatrix,CsrCMatrix,Double,CooVector,Vector>

Parameters:

b - Vector to multiply this matrix to.

Returns:

The vector result from multiplying this matrix by the vector b.

Throws:

IllegalArgumentException - If the number of columns in this matrix do not equal the number of entries b.

mult

public CVector mult(CVector b)

Computes matrix-vector multiplication.

Specified by:

mult in interface MatrixOperationsMixin<CsrMatrix,Matrix,CsrMatrix,CsrCMatrix,CsrCMatrix,Double,CooVector,Vector>

Parameters:

b - Vector in the matrix-vector multiplication.

Returns:

The result of matrix multiplying this matrix with vector b.

Throws:

IllegalArgumentException - If the number of columns in this matrix do not equal the number of entries in the vector b.

mult

public CVector mult(CooCVector b)

Computes matrix-vector multiplication.

Specified by:

mult in interface MatrixOperationsMixin<CsrMatrix,Matrix,CsrMatrix,CsrCMatrix,CsrCMatrix,Double,CooVector,Vector>

Parameters:

b - Vector in the matrix-vector multiplication.

Returns:

The result of matrix multiplying this matrix with vector b.

Throws:

IllegalArgumentException - If the number of columns in this matrix do not equal the number of entries in the vector b.

pow

public Matrix pow(int exponent)

Computes the matrix power with a given exponent. This is equivalent to multiplying a matrix to itself 'exponent' times.

Specified by:

pow in interface MatrixOperationsMixin<CsrMatrix,Matrix,CsrMatrix,CsrCMatrix,CsrCMatrix,Double,CooVector,Vector>

Parameters:

exponent - The exponent in the matrix power.

Returns:

The result of multiplying this matrix with itself 'exponent' times.

elemMult

public CsrMatrix elemMult(Matrix B)

Computes the element-wise multiplication (Hadamard product) between two matrices.

Specified by:

elemMult in interface MatrixOperationsMixin<CsrMatrix,Matrix,CsrMatrix,CsrCMatrix,CsrCMatrix,Double,CooVector,Vector>

Parameters:

B - Second matrix in the element-wise multiplication.

Returns:

The result of element-wise multiplication of this matrix with the matrix B.

Throws:

IllegalArgumentException - If this matrix and B have different shapes.

elemMult

public CsrMatrix elemMult(CooMatrix B)

Computes the element-wise multiplication (Hadamard product) between two matrices.

Specified by:

elemMult in interface MatrixOperationsMixin<CsrMatrix,Matrix,CsrMatrix,CsrCMatrix,CsrCMatrix,Double,CooVector,Vector>

Parameters:

B - Second matrix in the element-wise multiplication.

Returns:

The result of element-wise multiplication of this matrix with the matrix B.

Throws:

IllegalArgumentException - If this matrix and B have different shapes.

elemMult

public CsrCMatrix elemMult(CMatrix B)

Computes the element-wise multiplication (Hadamard product) between two matrices.

Specified by:

elemMult in interface MatrixOperationsMixin<CsrMatrix,Matrix,CsrMatrix,CsrCMatrix,CsrCMatrix,Double,CooVector,Vector>

Parameters:

B - Second matrix in the element-wise multiplication.

Returns:

The result of element-wise multiplication of this matrix with the matrix B.

Throws:

IllegalArgumentException - If this matrix and B have different shapes.

elemMult

public CsrCMatrix elemMult(CooCMatrix B)

Computes the element-wise multiplication (Hadamard product) between two matrices.

Specified by:

elemMult in interface MatrixOperationsMixin<CsrMatrix,Matrix,CsrMatrix,CsrCMatrix,CsrCMatrix,Double,CooVector,Vector>

Parameters:

B - Second matrix in the element-wise multiplication.

Returns:

The result of element-wise multiplication of this matrix with the matrix B.

Throws:

IllegalArgumentException - If this matrix and B have different shapes.

elemMult

public CsrCMatrix elemMult(CsrCMatrix B)

Computes the element-wise multiplication (Hadamard product) between two matrices.

Parameters:

B - Second matrix in the element-wise multiplication.

Returns:

The result of element-wise multiplication of this matrix with the matrix B.

Throws:

IllegalArgumentException - If this matrix and B have different shapes.

elemDiv

public CsrCMatrix elemDiv(CMatrix B)

Computes the element-wise division between two matrices.

Specified by:

elemDiv in interface MatrixOperationsMixin<CsrMatrix,Matrix,CsrMatrix,CsrCMatrix,CsrCMatrix,Double,CooVector,Vector>

Parameters:

B - Second matrix in the element-wise division.

Returns:

The result of element-wise division of this matrix with the matrix B.

Throws:

IllegalArgumentException - If this matrix and B have different shapes.

ArithmeticException - If B contains any zero entries.

det

public Double det()

Computes the determinant of a square matrix.

WARNING: Currently, this method will convert this matrix to a dense matrix.

Specified by:

det in interface MatrixOperationsMixin<CsrMatrix,Matrix,CsrMatrix,CsrCMatrix,CsrCMatrix,Double,CooVector,Vector>

Returns:

The determinant of this matrix.

Throws:

IllegalArgumentException - If this matrix is not square.

I

public static CsrMatrix I(Shape shape)

Constructs an identity-like matrix stored in CSR format with the specified shape.

Parameters:

shape - Shape of the identity-like matrix.

Returns:

An identity-like matrix stored in CSR format.

I

public static CsrMatrix I(int size)

Constructs an identity matrix stored in CSR format with the specified shape.

Parameters:

size - Number of rows (and columns) in the matrix.

Returns:

An identity matrix stored in CSR format.

I

public static CsrMatrix I(int numRows,
 int numCols)

Constructs an identity-like matrix stored in CSR format with the specified shape.

Parameters:

numRows - Number of rows in the matrix.

numCols - Number of columns in the matrix.

Returns:

An identity-like matrix stored in CSR format.

fib

public Double fib(Matrix B)

Computes the Frobenius inner product of two matrices.

Specified by:

fib in interface MatrixOperationsMixin<CsrMatrix,Matrix,CsrMatrix,CsrCMatrix,CsrCMatrix,Double,CooVector,Vector>

Parameters:

B - Second matrix in the Frobenius inner product

Returns:

The Frobenius inner product of this matrix and matrix B.

Throws:

IllegalArgumentException - If this matrix and B have different shapes.

fib

public Double fib(CooMatrix B)

Computes the Frobenius inner product of two matrices.

Specified by:

fib in interface MatrixOperationsMixin<CsrMatrix,Matrix,CsrMatrix,CsrCMatrix,CsrCMatrix,Double,CooVector,Vector>

Parameters:

B - Second matrix in the Frobenius inner product

Returns:

The Frobenius inner product of this matrix and matrix B.

Throws:

IllegalArgumentException - If this matrix and B have different shapes.

fib

public Double fib(CsrMatrix B)

Computes the Frobenius inner product of two matrices.

Parameters:

B - Second matrix in the Frobenius inner product

Returns:

The Frobenius inner product of this matrix and matrix B.

Throws:

IllegalArgumentException - If this matrix and B have different shapes.

fib

public CNumber fib(CsrCMatrix B)

Computes the Frobenius inner product of two matrices.

Parameters:

B - Second matrix in the Frobenius inner product

Returns:

The Frobenius inner product of this matrix and matrix B.

Throws:

IllegalArgumentException - If this matrix and B have different shapes.

fib

public CNumber fib(CMatrix B)

Computes the Frobenius inner product of two matrices.

Specified by:

fib in interface MatrixOperationsMixin<CsrMatrix,Matrix,CsrMatrix,CsrCMatrix,CsrCMatrix,Double,CooVector,Vector>

Parameters:

B - Second matrix in the Frobenius inner product

Returns:

The Frobenius inner product of this matrix and matrix B.

Throws:

IllegalArgumentException - If this matrix and B have different shapes.

fib

public CNumber fib(CooCMatrix B)

Computes the Frobenius inner product of two matrices.

Specified by:

fib in interface MatrixOperationsMixin<CsrMatrix,Matrix,CsrMatrix,CsrCMatrix,CsrCMatrix,Double,CooVector,Vector>

Parameters:

B - Second matrix in the Frobenius inner product

Returns:

The Frobenius inner product of this matrix and matrix B.

Throws:

IllegalArgumentException - If this matrix and B have different shapes.

sumCols

public Vector sumCols()

Sums together the columns of a matrix as if each column was a column vector.

Specified by:

sumCols in interface MatrixOperationsMixin<CsrMatrix,Matrix,CsrMatrix,CsrCMatrix,CsrCMatrix,Double,CooVector,Vector>

Returns:

The result of summing together all columns of the matrix as column vectors. If this matrix is an m-by-n matrix, then the result will be a vectors of length m.

sumRows

public Vector sumRows()

Sums together the rows of a matrix as if each row was a row vector.

Specified by:

sumRows in interface MatrixOperationsMixin<CsrMatrix,Matrix,CsrMatrix,CsrCMatrix,CsrCMatrix,Double,CooVector,Vector>

Returns:

The result of summing together all rows of the matrix as row vectors. If this matrix is an m-by-n matrix, then the result will be a vector of length n.

addToEachCol

public Matrix addToEachCol(Vector b)

Adds a vector to each column of a matrix. The vector need not be a column vector. If it is a row vector it will be treated as if it were a column vector.

Specified by:

addToEachCol in interface MatrixOperationsMixin<CsrMatrix,Matrix,CsrMatrix,CsrCMatrix,CsrCMatrix,Double,CooVector,Vector>

Parameters:

b - Vector to add to each column of this matrix.

Returns:

The result of adding the vector b to each column of this matrix.

addToEachCol

public Matrix addToEachCol(CooVector b)

Adds a vector to each column of a matrix. The vector need not be a column vector. If it is a row vector it will be treated as if it were a column vector.

Specified by:

addToEachCol in interface MatrixOperationsMixin<CsrMatrix,Matrix,CsrMatrix,CsrCMatrix,CsrCMatrix,Double,CooVector,Vector>

Parameters:

b - Vector to add to each column of this matrix.

Returns:

The result of adding the vector b to each column of this matrix.

addToEachCol

public CMatrix addToEachCol(CVector b)

Adds a vector to each column of a matrix. The vector need not be a column vector. If it is a row vector it will be treated as if it were a column vector.

Specified by:

addToEachCol in interface MatrixOperationsMixin<CsrMatrix,Matrix,CsrMatrix,CsrCMatrix,CsrCMatrix,Double,CooVector,Vector>

Parameters:

b - Vector to add to each column of this matrix.

Returns:

The result of adding the vector b to each column of this matrix.

addToEachCol

public CMatrix addToEachCol(CooCVector b)

Adds a vector to each column of a matrix. The vector need not be a column vector. If it is a row vector it will be treated as if it were a column vector.

Specified by:

addToEachCol in interface MatrixOperationsMixin<CsrMatrix,Matrix,CsrMatrix,CsrCMatrix,CsrCMatrix,Double,CooVector,Vector>

Parameters:

b - Vector to add to each column of this matrix.

Returns:

The result of adding the vector b to each column of this matrix.

addToEachRow

public Matrix addToEachRow(Vector b)

Adds a vector to each row of a matrix. The vector need not be a row vector. If it is a column vector it will be treated as if it were a row vector for this operation.

Specified by:

addToEachRow in interface MatrixOperationsMixin<CsrMatrix,Matrix,CsrMatrix,CsrCMatrix,CsrCMatrix,Double,CooVector,Vector>

Parameters:

b - Vector to add to each row of this matrix.

Returns:

The result of adding the vector b to each row of this matrix.

addToEachRow

public Matrix addToEachRow(CooVector b)

Adds a vector to each row of a matrix. The vector need not be a row vector. If it is a column vector it will be treated as if it were a row vector for this operation.

Specified by:

addToEachRow in interface MatrixOperationsMixin<CsrMatrix,Matrix,CsrMatrix,CsrCMatrix,CsrCMatrix,Double,CooVector,Vector>

Parameters:

b - Vector to add to each row of this matrix.

Returns:

The result of adding the vector b to each row of this matrix.

addToEachRow

public CMatrix addToEachRow(CVector b)

Adds a vector to each row of a matrix. The vector need not be a row vector. If it is a column vector it will be treated as if it were a row vector for this operation.

Specified by:

addToEachRow in interface MatrixOperationsMixin<CsrMatrix,Matrix,CsrMatrix,CsrCMatrix,CsrCMatrix,Double,CooVector,Vector>

Parameters:

b - Vector to add to each row of this matrix.

Returns:

The result of adding the vector b to each row of this matrix.

addToEachRow

public CMatrix addToEachRow(CooCVector b)

Adds a vector to each row of a matrix. The vector need not be a row vector. If it is a column vector it will be treated as if it were a row vector for this operation.

Specified by:

addToEachRow in interface MatrixOperationsMixin<CsrMatrix,Matrix,CsrMatrix,CsrCMatrix,CsrCMatrix,Double,CooVector,Vector>

Parameters:

b - Vector to add to each row of this matrix.

Returns:

The result of adding the vector b to each row of this matrix.

stack

public Matrix stack(Matrix B)

Stacks matrices along columns.
Also see MatrixOperationsMixin.stack(Matrix, int) and augment(Matrix).

Specified by:

stack in interface MatrixOperationsMixin<CsrMatrix,Matrix,CsrMatrix,CsrCMatrix,CsrCMatrix,Double,CooVector,Vector>

Parameters:

B - Matrix to stack to this matrix.

Returns:

The result of stacking this matrix on top of the matrix B.

Throws:

IllegalArgumentException - If this matrix and matrix B have a different number of columns.

stack

public CsrMatrix stack(CooMatrix B)

Stacks matrices along columns.
Also see MatrixOperationsMixin.stack(Matrix, int) and augment(Matrix).

Specified by:

stack in interface MatrixOperationsMixin<CsrMatrix,Matrix,CsrMatrix,CsrCMatrix,CsrCMatrix,Double,CooVector,Vector>

Parameters:

B - Matrix to stack to this matrix.

Returns:

The result of stacking this matrix on top of the matrix B.

Throws:

IllegalArgumentException - If this matrix and matrix B have a different number of columns.

stack

public CsrMatrix stack(CsrMatrix B)

Stacks matrices along columns.
Also see MatrixOperationsMixin.stack(Matrix, int) and augment(Matrix).

Specified by:

stack in interface MatrixOperationsMixin<CsrMatrix,Matrix,CsrMatrix,CsrCMatrix,CsrCMatrix,Double,CooVector,Vector>

Parameters:

B - Matrix to stack to this matrix.

Returns:

The result of stacking this matrix on top of the matrix B.

Throws:

IllegalArgumentException - If this matrix and matrix B have a different number of columns.

stack

public CMatrix stack(CMatrix B)

Stacks matrices along columns.
Also see MatrixOperationsMixin.stack(Matrix, int) and augment(Matrix).

Specified by:

stack in interface MatrixOperationsMixin<CsrMatrix,Matrix,CsrMatrix,CsrCMatrix,CsrCMatrix,Double,CooVector,Vector>

Parameters:

B - Matrix to stack to this matrix.

Returns:

The result of stacking this matrix on top of the matrix B.

Throws:

IllegalArgumentException - If this matrix and matrix B have a different number of columns.

stack

public CsrCMatrix stack(CooCMatrix B)

Stacks matrices along columns.
Also see MatrixOperationsMixin.stack(Matrix, int) and augment(Matrix).

Specified by:

stack in interface MatrixOperationsMixin<CsrMatrix,Matrix,CsrMatrix,CsrCMatrix,CsrCMatrix,Double,CooVector,Vector>

Parameters:

B - Matrix to stack to this matrix.

Returns:

The result of stacking this matrix on top of the matrix B.

Throws:

IllegalArgumentException - If this matrix and matrix B have a different number of columns.

stack

public CsrCMatrix stack(CsrCMatrix B)

Stacks matrices along columns.
Also see MatrixOperationsMixin.stack(Matrix, int) and augment(Matrix).

Specified by:

stack in interface MatrixOperationsMixin<CsrMatrix,Matrix,CsrMatrix,CsrCMatrix,CsrCMatrix,Double,CooVector,Vector>

Parameters:

B - Matrix to stack to this matrix.

Returns:

The result of stacking this matrix on top of the matrix B.

Throws:

IllegalArgumentException - If this matrix and matrix B have a different number of columns.

augment

public Matrix augment(Matrix B)

Stacks matrices along rows.
Also see stack(Matrix) and MatrixOperationsMixin.stack(Matrix, int).

Specified by:

augment in interface MatrixOperationsMixin<CsrMatrix,Matrix,CsrMatrix,CsrCMatrix,CsrCMatrix,Double,CooVector,Vector>

Parameters:

B - Matrix to stack to this matrix.

Returns:

The result of stacking B to the right of this matrix.

Throws:

IllegalArgumentException - If this matrix and matrix B have a different number of rows.

augment

public CsrMatrix augment(CooMatrix B)

Stacks matrices along rows.
Also see stack(Matrix) and MatrixOperationsMixin.stack(Matrix, int).

Specified by:

augment in interface MatrixOperationsMixin<CsrMatrix,Matrix,CsrMatrix,CsrCMatrix,CsrCMatrix,Double,CooVector,Vector>

Parameters:

B - Matrix to stack to this matrix.

Returns:

The result of stacking B to the right of this matrix.

Throws:

IllegalArgumentException - If this matrix and matrix B have a different number of rows.

augment

public CsrMatrix augment(CsrMatrix B)

Stacks matrices along rows.
Also see stack(Matrix) and MatrixOperationsMixin.stack(Matrix, int).

Specified by:

augment in interface MatrixOperationsMixin<CsrMatrix,Matrix,CsrMatrix,CsrCMatrix,CsrCMatrix,Double,CooVector,Vector>

Parameters:

B - Matrix to stack to this matrix.

Returns:

The result of stacking B to the right of this matrix.

Throws:

IllegalArgumentException - If this matrix and matrix B have a different number of rows.

augment

public CMatrix augment(CMatrix B)

Stacks matrices along rows.
Also see stack(Matrix) and MatrixOperationsMixin.stack(Matrix, int).

Specified by:

augment in interface MatrixOperationsMixin<CsrMatrix,Matrix,CsrMatrix,CsrCMatrix,CsrCMatrix,Double,CooVector,Vector>

Parameters:

B - Matrix to stack to this matrix.

Returns:

The result of stacking B to the right of this matrix.

Throws:

IllegalArgumentException - If this matrix and matrix B have a different number of rows.

augment

public CsrCMatrix augment(CooCMatrix B)

Stacks matrices along rows.
Also see stack(Matrix) and MatrixOperationsMixin.stack(Matrix, int).

Specified by:

augment in interface MatrixOperationsMixin<CsrMatrix,Matrix,CsrMatrix,CsrCMatrix,CsrCMatrix,Double,CooVector,Vector>

Parameters:

B - Matrix to stack to this matrix.

Returns:

The result of stacking B to the right of this matrix.

Throws:

IllegalArgumentException - If this matrix and matrix B have a different number of rows.

augment

public CsrCMatrix augment(CsrCMatrix B)

Stacks matrices along rows.
Also see stack(Matrix) and MatrixOperationsMixin.stack(Matrix, int).

Specified by:

augment in interface MatrixOperationsMixin<CsrMatrix,Matrix,CsrMatrix,CsrCMatrix,CsrCMatrix,Double,CooVector,Vector>

Parameters:

B - Matrix to stack to this matrix.

Returns:

The result of stacking B to the right of this matrix.

Throws:

IllegalArgumentException - If this matrix and matrix B have a different number of rows.

stack

public CsrMatrix stack(Vector b)

Stacks vector to this matrix along columns. Note that the orientation of the vector (i.e. row/column vector) does not affect the output of this function. All vectors will be treated as row vectors.
Also see MatrixOperationsMixin.stack(Vector, int) and augment(Vector).

Specified by:

stack in interface MatrixOperationsMixin<CsrMatrix,Matrix,CsrMatrix,CsrCMatrix,CsrCMatrix,Double,CooVector,Vector>

Parameters:

b - Vector to stack to this matrix.

Returns:

The result of stacking this matrix on top of the vector b.

Throws:

IllegalArgumentException - If the number of columns in this matrix is different from the number of entries in the vector b.

stack

public CsrMatrix stack(CooVector b)

Stacks vector to this matrix along columns. Note that the orientation of the vector (i.e. row/column vector) does not affect the output of this function. All vectors will be treated as row vectors.
Also see MatrixOperationsMixin.stack(CooVector, int) and augment(CooVector).

Specified by:

stack in interface MatrixOperationsMixin<CsrMatrix,Matrix,CsrMatrix,CsrCMatrix,CsrCMatrix,Double,CooVector,Vector>

Parameters:

b - Vector to stack to this matrix.

Returns:

The result of stacking this matrix on top of the vector b.

Throws:

IllegalArgumentException - If the number of columns in this matrix is different from the number of entries in the vector b.

stack

public CsrCMatrix stack(CVector b)

Stacks vector to this matrix along columns. Note that the orientation of the vector (i.e. row/column vector) does not affect the output of this function. All vectors will be treated as row vectors.
Also see MatrixOperationsMixin.stack(CVector, int) and augment(CVector).

Specified by:

stack in interface MatrixOperationsMixin<CsrMatrix,Matrix,CsrMatrix,CsrCMatrix,CsrCMatrix,Double,CooVector,Vector>

Parameters:

b - Vector to stack to this matrix.

Returns:

The result of stacking this matrix on top of the vector b.

Throws:

IllegalArgumentException - If the number of columns in this matrix is different from the number of entries in the vector b.

stack

public CsrCMatrix stack(CooCVector b)

Stacks vector to this matrix along columns. Note that the orientation of the vector (i.e. row/column vector) does not affect the output of this function. All vectors will be treated as row vectors.
Also see MatrixOperationsMixin.stack(CooCVector, int) and augment(CooCVector).

Specified by:

stack in interface MatrixOperationsMixin<CsrMatrix,Matrix,CsrMatrix,CsrCMatrix,CsrCMatrix,Double,CooVector,Vector>

Parameters:

b - Vector to stack to this matrix.

Returns:

The result of stacking this matrix on top of the vector b.

Throws:

IllegalArgumentException - If the number of columns in this matrix is different from the number of entries in the vector b.

augment

public CsrMatrix augment(Vector b)

Augments a matrix with a vector. That is, stacks a vector along the rows to the right side of a matrix. Note that the orientation of the vector (i.e. row/column vector) does not affect the output of this function. The vector will be treated as a column vector regardless of the true orientation.
Also see stack(Vector) and MatrixOperationsMixin.stack(Vector, int).

Specified by:

augment in interface MatrixOperationsMixin<CsrMatrix,Matrix,CsrMatrix,CsrCMatrix,CsrCMatrix,Double,CooVector,Vector>

Parameters:

b - vector to augment to this matrix.

Returns:

The result of augmenting b to the right of this matrix.

Throws:

IllegalArgumentException - If this matrix has a different number of rows as entries in b.

augment

public CsrMatrix augment(CooVector b)

Augments a matrix with a vector. That is, stacks a vector along the rows to the right side of a matrix. Note that the orientation of the vector (i.e. row/column vector) does not affect the output of this function. The vector will be treated as a column vector regardless of the true orientation.
Also see stack(CooVector) and MatrixOperationsMixin.stack(CooVector, int).

Specified by:

augment in interface MatrixOperationsMixin<CsrMatrix,Matrix,CsrMatrix,CsrCMatrix,CsrCMatrix,Double,CooVector,Vector>

Parameters:

b - vector to augment to this matrix.

Returns:

The result of augmenting b to the right of this matrix.

Throws:

IllegalArgumentException - If this matrix has a different number of rows as entries in b.

augment

public CsrCMatrix augment(CVector b)

Augments a matrix with a vector. That is, stacks a vector along the rows to the right side of a matrix. Note that the orientation of the vector (i.e. row/column vector) does not affect the output of this function. The vector will be treated as a column vector regardless of the true orientation.
Also see stack(CVector) and MatrixOperationsMixin.stack(CVector, int).

Specified by:

augment in interface MatrixOperationsMixin<CsrMatrix,Matrix,CsrMatrix,CsrCMatrix,CsrCMatrix,Double,CooVector,Vector>

Parameters:

b - vector to augment to this matrix.

Returns:

The result of augmenting b to the right of this matrix.

Throws:

IllegalArgumentException - If this matrix has a different number of rows as entries in b.

augment

public CsrCMatrix augment(CooCVector b)

Augments a matrix with a vector. That is, stacks a vector along the rows to the right side of a matrix. Note that the orientation of the vector (i.e. row/column vector) does not affect the output of this function. The vector will be treated as a column vector regardless of the true orientation.
Also see stack(CooCVector) and MatrixOperationsMixin.stack(CooCVector, int).

Specified by:

augment in interface MatrixOperationsMixin<CsrMatrix,Matrix,CsrMatrix,CsrCMatrix,CsrCMatrix,Double,CooVector,Vector>

Parameters:

b - vector to augment to this matrix.

Returns:

The result of augmenting b to the right of this matrix.

Throws:

IllegalArgumentException - If this matrix has a different number of rows as entries in b.

getRow

public CooVector getRow(int i)

Get the row of this matrix at the specified index.

Specified by:

getRow in interface MatrixOperationsMixin<CsrMatrix,Matrix,CsrMatrix,CsrCMatrix,CsrCMatrix,Double,CooVector,Vector>

Parameters:

i - Index of row to get.

Returns:

The specified row of this matrix.

getCol

public CooVector getCol(int j)

Get the column of this matrix at the specified index.

Specified by:

getCol in interface MatrixOperationsMixin<CsrMatrix,Matrix,CsrMatrix,CsrCMatrix,CsrCMatrix,Double,CooVector,Vector>

Parameters:

j - Index of column to get.

Returns:

The specified column of this matrix.

getCol

public CooVector getCol(int colIdx,
 int rowStart,
 int rowEnd)

Gets a specified column of this matrix between rowStart (inclusive) and rowEnd (exclusive).

Specified by:

getCol in interface MatrixOperationsMixin<CsrMatrix,Matrix,CsrMatrix,CsrCMatrix,CsrCMatrix,Double,CooVector,Vector>

Parameters:

colIdx - Index of the column of this matrix to get.

rowStart - Starting row of the column (inclusive).

rowEnd - Ending row of the column (exclusive).

Returns:

The column at index colIdx of this matrix between the rowStart and rowEnd indices.

Throws:

IllegalArgumentException - If rowStart is less than 0.

IllegalArgumentException - If rowEnd is less than rowStart.

toVector

public CooVector toVector()

Converts this matrix to an equivalent vector. If this matrix is not shaped as a row/column vector, it will be flattened then converted to a vector.

Specified by:

toVector in interface MatrixOperationsMixin<CsrMatrix,Matrix,CsrMatrix,CsrCMatrix,CsrCMatrix,Double,CooVector,Vector>

Returns:

A vector equivalent to this matrix.

toTensor

public CooTensor toTensor()

Converts this matrix to an equivalent sparse tensor.

Returns:

A sparse tensor which is equivalent to this matrix.

getSlice

public CsrMatrix getSlice(int rowStart,
 int rowEnd,
 int colStart,
 int colEnd)

Gets a specified slice of this matrix.

Specified by:

getSlice in interface MatrixOperationsMixin<CsrMatrix,Matrix,CsrMatrix,CsrCMatrix,CsrCMatrix,Double,CooVector,Vector>

Parameters:

rowStart - Starting row index of slice (inclusive).

rowEnd - Ending row index of slice (exclusive).

colStart - Starting column index of slice (inclusive).

colEnd - Ending row index of slice (exclusive).

Returns:

The specified slice of this matrix. This is a completely new matrix and NOT a view into the matrix.

Throws:

ArrayIndexOutOfBoundsException - If any of the indices are out of bounds of this matrix.

IllegalArgumentException - If rowEnd is not greater than rowStart or if colEnd is not greater than colStart.

getColBelow

public CooVector getColBelow(int rowStart,
 int j)

Get a specified column of this matrix at and below a specified row.

Specified by:

getColBelow in interface MatrixOperationsMixin<CsrMatrix,Matrix,CsrMatrix,CsrCMatrix,CsrCMatrix,Double,CooVector,Vector>

Parameters:

rowStart - Index of the row to begin at.

j - Index of column to get.

Returns:

The specified column of this matrix beginning at the specified row.

Throws:

NegativeArraySizeException - If rowStart is larger than the number of rows in this matrix.

ArrayIndexOutOfBoundsException - If rowStart or j is outside the bounds of this matrix.

getRowAfter

public CooVector getRowAfter(int colStart,
 int rowIdx)

Get a specified row of this matrix at and after a specified column.

Specified by:

getRowAfter in interface MatrixOperationsMixin<CsrMatrix,Matrix,CsrMatrix,CsrCMatrix,CsrCMatrix,Double,CooVector,Vector>

Parameters:

colStart - Index of the row to begin at.

rowIdx - Index of the row to get.

Returns:

The specified row of this matrix beginning at the specified column.

Throws:

NegativeArraySizeException - If colStart is larger than the number of columns in this matrix.

ArrayIndexOutOfBoundsException - If rowIdx or colStart is outside the bounds of this matrix.

setCol

public CsrMatrix setCol(CooVector values,
 int j)

Sets a column of this matrix.

Specified by:

setCol in interface MatrixOperationsMixin<CsrMatrix,Matrix,CsrMatrix,CsrCMatrix,CsrCMatrix,Double,CooVector,Vector>

Parameters:

values - Vector containing the new values for the matrix.

j - Index of the column of this matrix to set.

Returns:

A reference to this matrix.

Throws:

IllegalArgumentException - If the number of entries in the values vector is not the same as the number of rows in this matrix.

IndexOutOfBoundsException - If j is not within the bounds of this matrix.

trace

public Double trace()

Computes the trace of this matrix. That is, the sum of elements along the principle diagonal of this matrix. Same as tr().

Specified by:

trace in interface MatrixOperationsMixin<CsrMatrix,Matrix,CsrMatrix,CsrCMatrix,CsrCMatrix,Double,CooVector,Vector>

Returns:

The trace of this matrix.

Throws:

IllegalArgumentException - If this matrix is not square.

tr

public Double tr()

Computes the trace of this matrix. That is, the sum of elements along the principle diagonal of this matrix. Same as trace().

Specified by:

tr in interface MatrixOperationsMixin<CsrMatrix,Matrix,CsrMatrix,CsrCMatrix,CsrCMatrix,Double,CooVector,Vector>

Returns:

The trace of this matrix.

Throws:

IllegalArgumentException - If this matrix is not square.

getDiag

public CooVector getDiag()

Extracts the diagonal elements of this matrix and returns them as a vector.

Specified by:

getDiag in interface MatrixOperationsMixin<CsrMatrix,Matrix,CsrMatrix,CsrCMatrix,CsrCMatrix,Double,CooVector,Vector>

Returns:

A vector containing the diagonal entries of this matrix.

H

public CsrMatrix H()

Compute the hermitian transpose of this matrix. That is, the complex conjugate transpose of this matrix.

Specified by:

H in interface MatrixOperationsMixin<CsrMatrix,Matrix,CsrMatrix,CsrCMatrix,CsrCMatrix,Double,CooVector,Vector>

Returns:

The complex conjugate transpose of this matrix.

mult

public Matrix mult(CsrMatrix B)

Computes the matrix multiplication between two sparse CSR matrices. The result is stored as a dense matrix.

If memory is a concern, and you are confident the multiplication result will be sparse, consider using mult2CSR(CsrMatrix) which will store the result as a CsrMatrix. However, the method should be used with caution as it will almost never be faster than this method and sparse matrix multiplication may result in fully dense matrices (even for two very sparse matrices).

Specified by:

mult in interface MatrixOperationsMixin<CsrMatrix,Matrix,CsrMatrix,CsrCMatrix,CsrCMatrix,Double,CooVector,Vector>

Parameters:

B - Second matrix in the matrix multiplication.

Returns:

The result of matrix multiplying this matrix with matrix B.

Throws:

IllegalArgumentException - If the number of columns in this matrix do not equal the number of rows in matrix B.

mult

public CMatrix mult(CsrCMatrix B)

Computes the matrix multiplication between two sparse CSR matrices. The result is stored as a dense matrix.

If memory is a concern, and you are confident the multiplication result will be sparse, consider using mult2CSR(CsrCMatrix) which will store the result as a CsrCMatrix. However, the method should be used with caution as it will almost never be faster than this method and sparse matrix multiplication may result in fully dense matrices (even for two very sparse matrices).

Specified by:

mult in interface MatrixOperationsMixin<CsrMatrix,Matrix,CsrMatrix,CsrCMatrix,CsrCMatrix,Double,CooVector,Vector>

Parameters:

B - Second matrix in the matrix multiplication.

Returns:

The result of matrix multiplying this matrix with matrix B.

Throws:

IllegalArgumentException - If the number of columns in this matrix do not equal the number of rows in matrix B.

mult

public Matrix mult(CooMatrix B)

Computes the matrix multiplication between two matrices.

Specified by:

mult in interface MatrixOperationsMixin<CsrMatrix,Matrix,CsrMatrix,CsrCMatrix,CsrCMatrix,Double,CooVector,Vector>

Parameters:

B - Second matrix in the matrix multiplication.

Returns:

The result of matrix multiplying this matrix with matrix B.

Throws:

IllegalArgumentException - If the number of columns in this matrix do not equal the number of rows in matrix B.

mult

public CMatrix mult(CMatrix B)

Computes the matrix multiplication between two matrices.

Specified by:

mult in interface MatrixOperationsMixin<CsrMatrix,Matrix,CsrMatrix,CsrCMatrix,CsrCMatrix,Double,CooVector,Vector>

Parameters:

B - Second matrix in the matrix multiplication.

Returns:

The result of matrix multiplying this matrix with matrix B.

Throws:

IllegalArgumentException - If the number of columns in this matrix do not equal the number of rows in matrix B.

mult

public CMatrix mult(CooCMatrix B)

Computes the matrix multiplication between two matrices.

Specified by:

mult in interface MatrixOperationsMixin<CsrMatrix,Matrix,CsrMatrix,CsrCMatrix,CsrCMatrix,Double,CooVector,Vector>

Parameters:

B - Second matrix in the matrix multiplication.

Returns:

The result of matrix multiplying this matrix with matrix B.

Throws:

IllegalArgumentException - If the number of columns in this matrix do not equal the number of rows in matrix B.

mult

public Vector mult(Vector b)

Computes matrix-vector multiplication.

Specified by:

mult in interface MatrixOperationsMixin<CsrMatrix,Matrix,CsrMatrix,CsrCMatrix,CsrCMatrix,Double,CooVector,Vector>

Parameters:

b - Vector in the matrix-vector multiplication.

Returns:

The result of matrix multiplying this matrix with vector b.

Throws:

IllegalArgumentException - If the number of columns in this matrix do not equal the number of entries in the vector b.

isI

public boolean isI()

Checks if this matrix is the identity matrix.

Specified by:

isI in interface MatrixComparisonsMixin<CsrMatrix>

Returns:

True if this matrix is the identity matrix. Otherwise, returns false.

set

public CsrMatrix set(double value,
 int row,
 int col)

Sets an index of this matrix to the specified value. Note: new entries cannot be inserted into a CSR matrix. This method returns a new matrix. In general, calling this method repeatedly is not considered to be efficient.

Specified by:

set in interface MatrixManipulationsMixin<CsrMatrix,Double>

Parameters:

value - Value to set.

row - Row index to set.

col - Column index to set.

Returns:

A new CSR matrix with the specified value set.

set

public CsrMatrix set(Double value,
 int row,
 int col)

Sets an index of this matrix to the specified value.

Specified by:

set in interface MatrixManipulationsMixin<CsrMatrix,Double>

Parameters:

value - Value to set.

row - Row index to set.

col - Column index to set.

Returns:

A reference to this matrix.

setCol

public CsrMatrix setCol(Double[] values,
 int colIndex)

Sets a column of this matrix at the given index to the specified values.

Specified by:

setCol in interface MatrixManipulationsMixin<CsrMatrix,Double>

Parameters:

values - New values for the column.

colIndex - The index of the column which is to be set.

Returns:

A reference to this matrix.

Throws:

IllegalArgumentException - If the values array has a different length than the number of rows of this matrix.

setCol

public CsrMatrix setCol(Integer[] values,
 int colIndex)

Sets a column of this matrix at the given index to the specified values.

Specified by:

setCol in interface MatrixManipulationsMixin<CsrMatrix,Double>

Parameters:

values - New values for the column.

colIndex - The index of the column which is to be set.

Returns:

A reference to this matrix.

Throws:

IllegalArgumentException - If the values array has a different length than the number of rows of this matrix.

setCol

public CsrMatrix setCol(double[] values,
 int colIndex)

Sets a column of this matrix at the given index to the specified values.

Specified by:

setCol in interface MatrixManipulationsMixin<CsrMatrix,Double>

Parameters:

values - New values for the column.

colIndex - The index of the column which is to be set.

Returns:

A reference to this matrix.

Throws:

IllegalArgumentException - If the values array has a different length than the number of rows of this matrix.

setCol

public CsrMatrix setCol(int[] values,
 int colIndex)

Sets a column of this matrix at the given index to the specified values.

Specified by:

setCol in interface MatrixManipulationsMixin<CsrMatrix,Double>

Parameters:

values - New values for the column.

colIndex - The index of the column which is to be set.

Returns:

A reference to this matrix.

Throws:

IllegalArgumentException - If the values array has a different length than the number of rows of this matrix.

setRow

public CsrMatrix setRow(Double[] values,
 int rowIndex)

Sets a row of this matrix at the given index to the specified values.

Specified by:

setRow in interface MatrixManipulationsMixin<CsrMatrix,Double>

Parameters:

values - New values for the row.

rowIndex - The index of the column which is to be set.

Returns:

A reference to this matrix.

Throws:

IllegalArgumentException - If the values array has a different length than the number of columns of this matrix.

setRow

public CsrMatrix setRow(Integer[] values,
 int rowIndex)

Sets a row of this matrix at the given index to the specified values.

Specified by:

setRow in interface MatrixManipulationsMixin<CsrMatrix,Double>

Parameters:

values - New values for the row.

rowIndex - The index of the column which is to be set.

Returns:

A reference to this matrix.

Throws:

IllegalArgumentException - If the values array has a different length than the number of columns of this matrix.

setRow

public CsrMatrix setRow(double[] values,
 int rowIndex)

Sets a row of this matrix at the given index to the specified values.

Specified by:

setRow in interface MatrixManipulationsMixin<CsrMatrix,Double>

Parameters:

values - New values for the row.

rowIndex - The index of the column which is to be set.

Returns:

A reference to this matrix.

Throws:

IllegalArgumentException - If the values array has a different length than the number of columns of this matrix.

setRow

public CsrMatrix setRow(int[] values,
 int rowIndex)

Sets a row of this matrix at the given index to the specified values.

Specified by:

setRow in interface MatrixManipulationsMixin<CsrMatrix,Double>

Parameters:

values - New values for the row.

rowIndex - The index of the column which is to be set.

Returns:

A reference to this matrix.

Throws:

IllegalArgumentException - If the values array has a different length than the number of columns of this matrix.

setSlice

public CsrMatrix setSlice(CsrMatrix values,
 int rowStart,
 int colStart)

Sets a slice of this matrix to the specified values. The rowStart and colStart parameters specify the upper left index location of the slice to set.

Specified by:

setSlice in interface MatrixManipulationsMixin<CsrMatrix,Double>

Parameters:

values - New values for the specified slice.

rowStart - Starting row index for the slice (inclusive).

colStart - Starting column index for the slice (inclusive).

Returns:

A reference to this matrix.

Throws:

IndexOutOfBoundsException - If rowStart or colStart are not within the matrix.

IllegalArgumentException - If the values slice, with upper left corner at the specified location, does not fit completely within this matrix.

setSlice

public CsrMatrix setSlice(Matrix values,
 int rowStart,
 int colStart)

Sets a slice of this matrix to the specified values. The rowStart and colStart parameters specify the upper left index location of the slice to set.

Specified by:

setSlice in interface MatrixManipulationsMixin<CsrMatrix,Double>

Parameters:

values - New values for the specified slice.

rowStart - Starting row index for the slice (inclusive).

colStart - Starting column index for the slice (inclusive).

Returns:

A reference to this matrix.

Throws:

IndexOutOfBoundsException - If rowStart or colStart are not within the matrix.

IllegalArgumentException - If the values slice, with upper left corner at the specified location, does not fit completely within this matrix.

setSlice

public CsrMatrix setSlice(CooMatrix values,
 int rowStart,
 int colStart)

Sets a slice of this matrix to the specified values. The rowStart and colStart parameters specify the upper left index location of the slice to set.

Specified by:

setSlice in interface MatrixManipulationsMixin<CsrMatrix,Double>

Parameters:

values - New values for the specified slice.

rowStart - Starting row index for the slice (inclusive).

colStart - Starting column index for the slice (inclusive).

Returns:

A reference to this matrix.

Throws:

IndexOutOfBoundsException - If rowStart or colStart are not within the matrix.

IllegalArgumentException - If the values slice, with upper left corner at the specified location, does not fit completely within this matrix.

setSlice

public CsrMatrix setSlice(Double[][] values,
 int rowStart,
 int colStart)

Sets a slice of this matrix to the specified values. The rowStart and colStart parameters specify the upper left index location of the slice to set.

Specified by:

setSlice in interface MatrixManipulationsMixin<CsrMatrix,Double>

Parameters:

values - New values for the specified slice.

rowStart - Starting row index for the slice (inclusive).

colStart - Starting column index for the slice (inclusive).

Returns:

A reference to this matrix.

Throws:

IndexOutOfBoundsException - If rowStart or colStart are not within the matrix.

IllegalArgumentException - If the values slice, with upper left corner at the specified location, does not fit completely within this matrix.

setSlice

public CsrMatrix setSlice(Integer[][] values,
 int rowStart,
 int colStart)

Sets a slice of this matrix to the specified values. The rowStart and colStart parameters specify the upper left index location of the slice to set.

Specified by:

setSlice in interface MatrixManipulationsMixin<CsrMatrix,Double>

Parameters:

values - New values for the specified slice.

rowStart - Starting row index for the slice (inclusive).

colStart - Starting column index for the slice (inclusive).

Returns:

A reference to this matrix.

Throws:

IndexOutOfBoundsException - If rowStart or colStart are not within the matrix.

IllegalArgumentException - If the values slice, with upper left corner at the specified location, does not fit completely within this matrix.

setSlice

public CsrMatrix setSlice(double[][] values,
 int rowStart,
 int colStart)

Sets a slice of this matrix to the specified values. The rowStart and colStart parameters specify the upper left index location of the slice to set.

Specified by:

setSlice in interface MatrixManipulationsMixin<CsrMatrix,Double>

Parameters:

values - New values for the specified slice.

rowStart - Starting row index for the slice (inclusive).

colStart - Starting column index for the slice (inclusive).

Returns:

A reference to this matrix.

Throws:

IndexOutOfBoundsException - If rowStart or colStart are not within the matrix.

IllegalArgumentException - If the values slice, with upper left corner at the specified location, does not fit completely within this matrix.

setSlice

public CsrMatrix setSlice(int[][] values,
 int rowStart,
 int colStart)

Sets a slice of this matrix to the specified values. The rowStart and colStart parameters specify the upper left index location of the slice to set.

Specified by:

setSlice in interface MatrixManipulationsMixin<CsrMatrix,Double>

Parameters:

values - New values for the specified slice.

rowStart - Starting row index for the slice (inclusive).

colStart - Starting column index for the slice (inclusive).

Returns:

A reference to this matrix.

Throws:

IndexOutOfBoundsException - If rowStart or colStart are not within the matrix.

IllegalArgumentException - If the values slice, with upper left corner at the specified location, does not fit completely within this matrix.

hashCode

public int hashCode()

Overrides:

hashCode in class Object

removeRow

public CsrMatrix removeRow(int rowIndex)

Removes a specified row from this matrix.

Specified by:

removeRow in interface MatrixManipulationsMixin<CsrMatrix,Double>

Parameters:

rowIndex - Index of the row to remove from this matrix.

Returns:

a copy of this matrix with the specified row removed.

Throws:

IndexOutOfBoundsException - If rowIndex >= this.numRows().

removeRows

public CsrMatrix removeRows(int... rowIndices)

Removes a specified set of rows from this matrix. Note: this will construct an intermediate CooMatrix.

Specified by:

removeRows in interface MatrixManipulationsMixin<CsrMatrix,Double>

Parameters:

rowIndices - The indices of the rows to remove from this matrix.

Returns:

a copy of this matrix with the specified rows removed.

removeCol

public CsrMatrix removeCol(int colIndex)

Removes a specified column from this matrix. Note: this will construct an intermediate CooMatrix.

Specified by:

removeCol in interface MatrixManipulationsMixin<CsrMatrix,Double>

Parameters:

colIndex - Index of the column to remove from this matrix.

Returns:

a copy of this matrix with the specified column removed.

removeCols

public CsrMatrix removeCols(int... colIndices)

Removes a specified set of columns from this matrix.

Specified by:

removeCols in interface MatrixManipulationsMixin<CsrMatrix,Double>

Parameters:

colIndices - Indices of the columns to remove from this matrix.

Returns:

a copy of this matrix with the specified columns removed.

swapRows

public CsrMatrix swapRows(int rowIndex1,
 int rowIndex2)

Swaps two rows in this matrix.

Specified by:

swapRows in interface MatrixManipulationsMixin<CsrMatrix,Double>

Parameters:

rowIndex1 - Index of first row to swap.

rowIndex2 - index of second row to swap.

Returns:

A reference to this matrix.

swapCols

public CsrMatrix swapCols(int colIndex1,
 int colIndex2)

Swaps columns in the matrix.

Specified by:

swapCols in interface MatrixManipulationsMixin<CsrMatrix,Double>

Parameters:

colIndex1 - Index of first column to swap.

colIndex2 - index of second column to swap.

Returns:

A reference to this matrix.

numRows

public int numRows()

Gets the number of rows in this matrix.

Specified by:

numRows in interface MatrixMixin<CsrMatrix,Matrix,CsrMatrix,CsrCMatrix,CsrCMatrix,Double,CooVector,Vector>

Returns:

The number of rows in this matrix.

numCols

public int numCols()

Gets the number of columns in this matrix.

Specified by:

numCols in interface MatrixMixin<CsrMatrix,Matrix,CsrMatrix,CsrCMatrix,CsrCMatrix,Double,CooVector,Vector>

Returns:

The number of columns in this matrix.

shape

public Shape shape()

Gets the shape of this matrix.

Specified by:

shape in interface MatrixMixin<CsrMatrix,Matrix,CsrMatrix,CsrCMatrix,CsrCMatrix,Double,CooVector,Vector>

Returns:

The shape of this matrix.

isSquare

public boolean isSquare()

Checks if this matrix is square.

Specified by:

isSquare in interface MatrixPropertiesMixin

Returns:

True if the matrix is square (i.e. the number of rows equals the number of columns). Otherwise, returns false.

isVector

public boolean isVector()

Checks if a matrix can be represented as a vector. That is, if a matrix has only one row or one column.

Specified by:

isVector in interface MatrixPropertiesMixin

Returns:

True if this matrix can be represented as either a row or column vector.

vectorType

public int vectorType()

Checks what type of vector this matrix is. i.e. not a vector, a 1x1 matrix, a row vector, or a column vector.

Specified by:

vectorType in interface MatrixPropertiesMixin

Returns:

- If this matrix can not be represented as a vector, then returns -1.
- If this matrix is a 1x1 matrix, then returns 0.
- If this matrix is a row vector, then returns 1.
- If this matrix is a column vector, then returns 2.

isTri

public boolean isTri()

Checks if this matrix is triangular (i.e. upper triangular, diagonal, lower triangular).

Specified by:

isTri in interface MatrixPropertiesMixin

Returns:

True is this matrix is triangular. Otherwise, returns false.

See Also:

• isTriL()
• isTriU()
• isDiag()

isTriL

public boolean isTriL()

Checks if this matrix is lower triangular.

Specified by:

isTriL in interface MatrixPropertiesMixin

Returns:

True is this matrix is lower triangular. Otherwise, returns false.

See Also:

• isTri()
• isTriU()
• isDiag()

isTriU

public boolean isTriU()

Checks if this matrix is upper triangular.

Specified by:

isTriU in interface MatrixPropertiesMixin

Returns:

True is this matrix is upper triangular. Otherwise, returns false.

See Also:

• isTriL()
• isTri()
• isDiag()

isDiag

public boolean isDiag()

Checks if this matrix is diagonal.

Specified by:

isDiag in interface MatrixPropertiesMixin

Returns:

True is this matrix is diagonal. Otherwise, returns false.

See Also:

• isTriL()
• isTriU()
• isTri()

isFullRank

public boolean isFullRank()

Checks if a matrix has full rank. That is, if a matrices rank is equal to the number of rows in the matrix.

Specified by:

isFullRank in interface MatrixPropertiesMixin

Returns:

True if this matrix has full rank. Otherwise, returns false.

isSingular

public boolean isSingular()

Checks if a matrix is singular. That is, if the matrix is NOT invertible.

Specified by:

isSingular in interface MatrixPropertiesMixin

Returns:

True if this matrix is singular. Otherwise, returns false.

See Also:

• MatrixPropertiesMixin.isInvertible()

matrixRank

public int matrixRank()

Computes the rank of this matrix (i.e. the dimension of the column space of this matrix). Note that here, rank is NOT the same as a tensor rank.

WARNING: This method will convert this matrix to a dense matrix to compute the rank.

Specified by:

matrixRank in interface MatrixPropertiesMixin

Returns:

The matrix rank of this matrix.

isSymmetric

public boolean isSymmetric()

Checks if a matrix is symmetric. That is, if the matrix is equal to its transpose.

Specified by:

isSymmetric in interface RealMatrixMixin<CsrMatrix,CsrCMatrix>

Returns:

True if this matrix is symmetric. Otherwise, returns false.

isAntiSymmetric

public boolean isAntiSymmetric()

Checks if a matrix is anti-symmetric. That is, if the matrix is equal to the negative of its transpose.

Specified by:

isAntiSymmetric in interface RealMatrixMixin<CsrMatrix,CsrCMatrix>

Returns:

True if this matrix is anti-symmetric. Otherwise, returns false.

isOrthogonal

public boolean isOrthogonal()

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

Specified by:

isOrthogonal in interface RealMatrixMixin<CsrMatrix,CsrCMatrix>

Returns:

True if this matrix it is orthogonal. Otherwise, returns false.

sqrtComplex

public CsrCMatrix sqrtComplex()

Computes the complex element-wise square root of a tensor.

Specified by:

sqrtComplex in interface RealMatrixMixin<CsrMatrix,CsrCMatrix>

Returns:

The result of applying an element-wise square root to this tensor. Note, this method will compute the principle square root i.e. the square root with positive real part.

toComplex

public CsrCMatrix toComplex()

Converts this tensor to an equivalent complex tensor. That is, the entries of the resultant matrix will be exactly the same value but will have type CNumber rather than Double.

Specified by:

toComplex in interface RealTensorMixin<CsrMatrix,CsrCMatrix>

Returns:

A complex matrix which is equivalent to this matrix.

getSelf

protected CsrMatrix getSelf()

Simply returns a reference of this tensor.

Specified by:

getSelf in class TensorBase<CsrMatrix,Matrix,CsrCMatrix,CMatrix,CsrMatrix,double[],Double>

Returns:

A reference to this tensor.

toCoo

public CooMatrix toCoo()

Converts this CSR matrix to an equivalent COO matrix.

Returns:

A COO matrix equivalent to this CSR matrix.

allClose

public boolean allClose(CsrMatrix src,
 double relTol,
 double absTol)

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

Specified by:

allClose in class TensorBase<CsrMatrix,Matrix,CsrCMatrix,CMatrix,CsrMatrix,double[],Double>

Parameters:

src - 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, double, double)

set

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

Sets an index of this tensor to a specified value.

Specified by:

set in interface TensorManipulationsMixin<CsrMatrix>

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 CsrMatrix reshape(Shape newShape)

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

Specified by:

reshape in interface TensorManipulationsMixin<CsrMatrix>

Parameters:

newShape - Shape of the new matrix.

Returns:

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

Throws:

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

flatten

public CsrMatrix flatten()

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

Specified by:

flatten in interface TensorManipulationsMixin<CsrMatrix>

Returns:

The flattened tensor.

flatten

public CsrMatrix flatten(int axis)

Flattens a tensor along the specified axis.

Specified by:

flatten in interface TensorManipulationsMixin<CsrMatrix>

Parameters:

axis - Axis along which to flatten tensor.

Throws:

IllegalArgumentException - If the axis is not positive or larger than the rank of this tensor.

add

public CsrMatrix add(CsrMatrix B)

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

Specified by:

add in interface MatrixOperationsMixin<CsrMatrix,Matrix,CsrMatrix,CsrCMatrix,CsrCMatrix,Double,CooVector,Vector>

Specified by:

add in interface TensorOperationsMixin<CsrMatrix,Matrix,CsrCMatrix,CMatrix,CsrMatrix,Double>

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 Matrix add(double a)

Adds specified value to all entries of this tensor.

Specified by:

add in interface TensorOperationsMixin<CsrMatrix,Matrix,CsrCMatrix,CMatrix,CsrMatrix,Double>

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 CMatrix add(CNumber a)

Adds specified value to all entries of this tensor.

Specified by:

add in interface TensorOperationsMixin<CsrMatrix,Matrix,CsrCMatrix,CMatrix,CsrMatrix,Double>

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 CsrMatrix sub(CsrMatrix B)

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

Specified by:

sub in interface MatrixOperationsMixin<CsrMatrix,Matrix,CsrMatrix,CsrCMatrix,CsrCMatrix,Double,CooVector,Vector>

Specified by:

sub in interface TensorOperationsMixin<CsrMatrix,Matrix,CsrCMatrix,CMatrix,CsrMatrix,Double>

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 Matrix sub(double a)

Adds specified value to all entries of this tensor.

Specified by:

sub in interface TensorOperationsMixin<CsrMatrix,Matrix,CsrCMatrix,CMatrix,CsrMatrix,Double>

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 CMatrix sub(CNumber a)

Subtracts a specified value from all entries of this tensor.

Specified by:

sub in interface TensorOperationsMixin<CsrMatrix,Matrix,CsrCMatrix,CMatrix,CsrMatrix,Double>

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.

T

public CsrMatrix T()

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

Specified by:

T in interface TensorOperationsMixin<CsrMatrix,Matrix,CsrCMatrix,CMatrix,CsrMatrix,Double>

Returns:

The transpose of this tensor.

get

public Double get(int... indices)

Gets the element in this tensor at the specified indices.

Specified by:

get in interface MatrixMixin<CsrMatrix,Matrix,CsrMatrix,CsrCMatrix,CsrCMatrix,Double,CooVector,Vector>

Specified by:

get in interface TensorOperationsMixin<CsrMatrix,Matrix,CsrCMatrix,CMatrix,CsrMatrix,Double>

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 CsrMatrix copy()

Creates a copy of this tensor.

Specified by:

copy in interface MatrixOperationsMixin<CsrMatrix,Matrix,CsrMatrix,CsrCMatrix,CsrCMatrix,Double,CooVector,Vector>

Specified by:

copy in interface TensorOperationsMixin<CsrMatrix,Matrix,CsrCMatrix,CMatrix,CsrMatrix,Double>

Returns:

A copy of this tensor.

elemMult

public CsrMatrix elemMult(CsrMatrix B)

Computes the element-wise multiplication between two tensors.

Specified by:

elemMult in interface TensorOperationsMixin<CsrMatrix,Matrix,CsrCMatrix,CMatrix,CsrMatrix,Double>

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 CsrMatrix elemDiv(Matrix B)

Computes the element-wise division between two tensors.

Specified by:

elemDiv in interface MatrixOperationsMixin<CsrMatrix,Matrix,CsrMatrix,CsrCMatrix,CsrCMatrix,Double,CooVector,Vector>

Specified by:

elemDiv in interface TensorOperationsMixin<CsrMatrix,Matrix,CsrCMatrix,CMatrix,CsrMatrix,Double>

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.

makeTensor

protected CsrMatrix makeTensor(Shape shape,
 double[] entries,
 int[][] indices)

A factory for creating a real sparse tensor.

Specified by:

makeTensor in class RealSparseTensorBase<CsrMatrix,Matrix,CsrCMatrix,CMatrix>

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.

makeDenseTensor

protected Matrix makeDenseTensor(Shape shape,
 double[] entries)

A factory for creating a real dense tensor.

Specified by:

makeDenseTensor in class RealSparseTensorBase<CsrMatrix,Matrix,CsrCMatrix,CMatrix>

Parameters:

shape - Shape of the tensor to make.

entries - Entries of the dense tensor to make.

Returns:

A tensor created from the specified parameters.

makeComplexTensor

protected CsrCMatrix makeComplexTensor(Shape shape,
 CNumber[] entries,
 int[][] indices)

A factory for creating a complex sparse tensor.

Specified by:

makeComplexTensor in class RealSparseTensorBase<CsrMatrix,Matrix,CsrCMatrix,CMatrix>

Parameters:

shape - Shape of the 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.

toDense

public Matrix toDense()

Converts this sparse tensor to an equivalent dense tensor.

Specified by:

toDense in class SparseTensorBase<CsrMatrix,Matrix,CsrCMatrix,CMatrix,CsrMatrix,double[],Double>

Returns:

A dense tensor which is equivalent to this sparse tensor.

toString

public String toString()

Formats this sparse CSR matrix as a human-readable string.

Overrides:

toString in class Object

Returns:

A human-readable string representing this sparse matrix.