org.ejml.data

Class FMatrixSparseTriplet

java.lang.Object

org.ejml.data.FMatrixSparseTriplet

All Implemented Interfaces:

java.io.Serializable, FMatrix, FMatrixSparse, Matrix

public class FMatrixSparseTriplet
extends java.lang.Object
implements FMatrixSparse

TODO describe

See Also:

Serialized Form

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	FMatrixSparseTriplet.Element

Field Summary

Fields

Modifier and Type	Field and Description
int	numCols
int	numRows
FMatrixSparseTriplet.Element[]	nz_data
int	nz_length

Constructor Summary

Constructors

Constructor and Description
FMatrixSparseTriplet()
FMatrixSparseTriplet(FMatrixSparseTriplet orig)
FMatrixSparseTriplet(int numRows, int numCols, int initLength)

Method Summary

Modifier and Type	Method and Description
void	addItem(int row, int col, float value)
<T extends Matrix> T	copy() Creates an exact copy of the matrix
<T extends Matrix> T	createLike() Creates a new matrix with the same shape as this matrix
float	get(int row, int col) Returns the value of value of the specified matrix element.
int	getLength()
int	getNumCols() Returns the number of columns in this matrix.
int	getNumElements() Returns the number of elements in this matrix, which is the number of rows times the number of columns.
int	getNumRows() Returns the number of rows in this matrix.
MatrixType	getType() Returns the type of matrix
void	growData(int max_nz_length) Will resize the array and keep all the old data
boolean	isAssigned(int row, int col) Is the specified element explicitly assigned a value
int	nz_index(int row, int col)
void	print() Prints the matrix to standard out.
void	printNonZero() Prints to standard out the non-zero elements only.
void	remove(int row, int col) If the specified element is non-zero it is removed from the structure
void	reset()
void	reshape(int numRows, int numCols)
void	reshape(int numRows, int numCols, int arrayLength) Reshapes the matrix so that it can store a matrix with the specified dimensions and the number of non-zero elements.
void	set(int row, int col, float value) Sets the value of the specified matrix element.
void	set(Matrix original) Sets this matrix to be identical to the 'original' matrix passed in.
void	shrinkArrays() Reduces the size of internal data structures to their minimal size.
float	unsafe_get(int row, int col) Same as FMatrix.get(int, int) but does not perform bounds check on input parameters.
void	unsafe_set(int row, int col, float value) Same as FMatrix.set(int, int, float) but does not perform bounds check on input parameters.
void	zero() Sets all elements to zero by removing the sparse graph

Methods inherited from class java.lang.Object

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

Field Detail

nz_data

public FMatrixSparseTriplet.Element[] nz_data

nz_length

public int nz_length

numRows

public int numRows

numCols

public int numCols

Constructor Detail

FMatrixSparseTriplet

public FMatrixSparseTriplet()

FMatrixSparseTriplet

public FMatrixSparseTriplet(int numRows,
                            int numCols,
                            int initLength)

Parameters:

numRows - Number of rows in the matrix

numCols - Number of columns in the matrix

initLength - Initial maximum length of data array.

FMatrixSparseTriplet

public FMatrixSparseTriplet(FMatrixSparseTriplet orig)

Method Detail

reset

public void reset()

reshape

public void reshape(int numRows,
                    int numCols)

reshape

public void reshape(int numRows,
                    int numCols,
                    int arrayLength)

Description copied from interface: FMatrixSparse

Reshapes the matrix so that it can store a matrix with the specified dimensions and the number of non-zero elements. The reshaped matrix will be empty.

Specified by:

reshape in interface FMatrixSparse

Parameters:

numRows - number of rows

numCols - number of columns

arrayLength - Array length for storing non-zero elements.

addItem

public void addItem(int row,
                    int col,
                    float value)

set

public void set(int row,
                int col,
                float value)

Description copied from interface: FMatrix

Sets the value of the specified matrix element.

Specified by:

set in interface FMatrix

Parameters:

row - Matrix element's row index..

col - Matrix element's column index.

value - The element's new value.

unsafe_set

public void unsafe_set(int row,
                       int col,
                       float value)

Description copied from interface: FMatrix

Same as FMatrix.set(int, int, float) but does not perform bounds check on input parameters. This results in about a 25% speed increase but potentially sacrifices stability and makes it more difficult to track down simple errors. It is not recommended that this function be used, except in highly optimized code where the bounds are implicitly being checked.

Specified by:

unsafe_set in interface FMatrix

Parameters:

row - Matrix element's row index..

col - Matrix element's column index.

value - The element's new value.

getNumElements

public int getNumElements()

Description copied from interface: FMatrix

Returns the number of elements in this matrix, which is the number of rows times the number of columns.

Specified by:

getNumElements in interface FMatrix

Returns:

Number of elements in this matrix.

get

public float get(int row,
                 int col)

Description copied from interface: FMatrix

Returns the value of value of the specified matrix element.

Specified by:

get in interface FMatrix

Parameters:

row - Matrix element's row index..

col - Matrix element's column index.

Returns:

The specified element's value.

unsafe_get

public float unsafe_get(int row,
                        int col)

Description copied from interface: FMatrix

Same as FMatrix.get(int, int) but does not perform bounds check on input parameters. This results in about a 25% speed increase but potentially sacrifices stability and makes it more difficult to track down simple errors. It is not recommended that this function be used, except in highly optimized code where the bounds are implicitly being checked.

Specified by:

unsafe_get in interface FMatrix

Parameters:

row - Matrix element's row index..

col - Matrix element's column index.

Returns:

The specified element's value.

nz_index

public int nz_index(int row,
                    int col)

growData

public void growData(int max_nz_length)

Will resize the array and keep all the old data

Parameters:

max_nz_length - New maximum length of data

getLength

public int getLength()

getNumRows

public int getNumRows()

Description copied from interface: Matrix

Returns the number of rows in this matrix.

Specified by:

getNumRows in interface Matrix

Returns:

Number of rows.

getNumCols

public int getNumCols()

Description copied from interface: Matrix

Returns the number of columns in this matrix.

Specified by:

getNumCols in interface Matrix

Returns:

Number of columns.

copy

public <T extends Matrix> T copy()

Description copied from interface: Matrix

Creates an exact copy of the matrix

Specified by:

copy in interface Matrix

createLike

public <T extends Matrix> T createLike()

Description copied from interface: Matrix

Creates a new matrix with the same shape as this matrix

Specified by:

createLike in interface Matrix

set

public void set(Matrix original)

Description copied from interface: Matrix

Sets this matrix to be identical to the 'original' matrix passed in.

Specified by:

set in interface Matrix

shrinkArrays

public void shrinkArrays()

Description copied from interface: FMatrixSparse

Reduces the size of internal data structures to their minimal size. No information is lost bu

Specified by:

shrinkArrays in interface FMatrixSparse

remove

public void remove(int row,
                   int col)

Description copied from interface: FMatrixSparse

If the specified element is non-zero it is removed from the structure

Specified by:

remove in interface FMatrixSparse

Parameters:

row - the row

col - the column

isAssigned

public boolean isAssigned(int row,
                          int col)

Description copied from interface: FMatrixSparse

Is the specified element explicitly assigned a value

Specified by:

isAssigned in interface FMatrixSparse

Parameters:

row - the row

col - the column

Returns:

true if it has been assigned a value or false if not

zero

public void zero()

Description copied from interface: FMatrixSparse

Sets all elements to zero by removing the sparse graph

Specified by:

zero in interface FMatrixSparse

print

public void print()

Description copied from interface: Matrix

Prints the matrix to standard out.

Specified by:

print in interface Matrix

printNonZero

public void printNonZero()

Description copied from interface: FMatrixSparse

Prints to standard out the non-zero elements only.

Specified by:

printNonZero in interface FMatrixSparse

getType

public MatrixType getType()

Description copied from interface: Matrix

Returns the type of matrix

Specified by:

getType in interface Matrix