org.djunits.value.vfloat.matrix

Class FloatMatrixDataSparse

java.lang.Object

org.djunits.value.vfloat.matrix.FloatMatrixData

org.djunits.value.vfloat.matrix.FloatMatrixDataSparse

public class FloatMatrixDataSparse
extends FloatMatrixData

Stores sparse data for a FloatMatrix and carries out basic operations.

Copyright (c) 2013-2018 Delft University of Technology, PO Box 5, 2600 AA, Delft, the Netherlands. All rights reserved.
BSD-style license. See OpenTrafficSim License.

$LastChangedDate: 2015-07-24 02:58:59 +0200 (Fri, 24 Jul 2015) $, @version $Revision: 1147 $, by $Author: averbraeck $, initial version Oct 3, 2015

Author:

Alexander Verbraeck, Peter Knoppers

Field Summary

Fields inherited from class org.djunits.value.vfloat.matrix.FloatMatrixData

cols, matrixSI, rows

Constructor Summary

Constructors

Constructor and Description
FloatMatrixDataSparse(float[][] dataSI) Create a vector with sparse data.
FloatMatrixDataSparse(float[] denseSI, int rows, int cols) Create a vector with sparse data from an internal vector with dense data.
FloatMatrixDataSparse(float[] matrixSI, long[] indices, int length, int rows, int cols) Create a vector with sparse data.

Method Summary

Modifier and Type	Method and Description
FloatMatrixDataSparse	copy()
void	decrementBy(FloatMatrixData right) Subtract a matrix from this matrix on a cell-by-cell basis.
void	divideBy(FloatMatrixData right) Divide the values of a matrix by the values of another matrix on a cell-by-cell basis.
boolean	equals(Object obj)
float[][]	getDenseMatrixSI()
double[][]	getDoubleDenseMatrixSI()
float	getSI(int row, int col)
int	hashCode()
void	incrementBy(FloatMatrixData right) Add a matrix to this matrix on a cell-by-cell basis.
static FloatMatrixDataSparse	instantiate(float[][] valuesSI) Instantiate a FloatMatrixDataSparse from an array.
void	multiplyBy(FloatMatrixData right) Multiply a matrix with the values of another matrix on a cell-by-cell basis.
void	setSI(int row, int col, float valueSI) Sets a value at the [row, col] point in the matrix.
FloatMatrixDataDense	toDense()

Methods inherited from class org.djunits.value.vfloat.matrix.FloatMatrixData

cardinality, cols, decrementBy, divide, divideBy, getStorageType, incrementBy, instantiate, instantiate, isDense, isSparse, minus, multiplyBy, plus, rows, times, toSparse, toString, zSum

Methods inherited from class java.lang.Object

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

Constructor Detail

FloatMatrixDataSparse

public FloatMatrixDataSparse(float[] matrixSI,
                             long[] indices,
                             int length,
                             int rows,
                             int cols)

Create a vector with sparse data.

Parameters:

matrixSI - the data to store

indices - the index values of the Matrix, with index = row * cols + col

length - the length of the vector (padded with 0 after highest index in indices)

rows - the number of rows

cols - the number of columns

FloatMatrixDataSparse

public FloatMatrixDataSparse(float[] denseSI,
                             int rows,
                             int cols)
                      throws ValueException

Create a vector with sparse data from an internal vector with dense data.

Parameters:

denseSI - the dense data to store

rows - the number of rows

cols - the number of columns

Throws:

ValueException - in case size is incorrect

FloatMatrixDataSparse

public FloatMatrixDataSparse(float[][] dataSI)
                      throws ValueException

Create a vector with sparse data.

Parameters:

dataSI - the data to store

Throws:

ValueException - in case matrix is ragged

Method Detail

toDense

public final FloatMatrixDataDense toDense()

Overrides:

toDense in class FloatMatrixData

Returns:

the dense transformation of this data

getSI

public final float getSI(int row,
                         int col)

Specified by:

getSI in class FloatMatrixData

Parameters:

row - the row number to get the value for

col - the column number to get the value for

Returns:

the value at the [row, col] point

setSI

public final void setSI(int row,
                        int col,
                        float valueSI)

Sets a value at the [row, col] point in the matrix.

Specified by:

setSI in class FloatMatrixData

Parameters:

row - the row number to set the value for

col - the column number to set the value for

valueSI - the value at the index

getDenseMatrixSI

public final float[][] getDenseMatrixSI()

Specified by:

getDenseMatrixSI in class FloatMatrixData

Returns:

a safe dense copy of matrixSI as a matrix

getDoubleDenseMatrixSI

public final double[][] getDoubleDenseMatrixSI()

Specified by:

getDoubleDenseMatrixSI in class FloatMatrixData

Returns:

a safe dense copy of matrixSI as a double matrix

copy

public final FloatMatrixDataSparse copy()

Specified by:

copy in class FloatMatrixData

Returns:

a deep copy of the data.

instantiate

public static FloatMatrixDataSparse instantiate(float[][] valuesSI)
                                         throws ValueException

Instantiate a FloatMatrixDataSparse from an array.

Parameters:

valuesSI - the (SI) values to store

Returns:

the FloatMatrixDataSparse

Throws:

ValueException - in case matrix is ragged

incrementBy

public final void incrementBy(FloatMatrixData right)
                       throws ValueException

Add a matrix to this matrix on a cell-by-cell basis. The type of matrix (sparse, dense) stays the same.

Specified by:

incrementBy in class FloatMatrixData

Parameters:

right - the other data object to add

Throws:

ValueException - if matrices have different lengths

decrementBy

public final void decrementBy(FloatMatrixData right)
                       throws ValueException

Subtract a matrix from this matrix on a cell-by-cell basis. The type of matrix (sparse, dense) stays the same.

Specified by:

decrementBy in class FloatMatrixData

Parameters:

right - the other data object to subtract

Throws:

ValueException - if matrices have different lengths

multiplyBy

public final void multiplyBy(FloatMatrixData right)
                      throws ValueException

Multiply a matrix with the values of another matrix on a cell-by-cell basis. The type of matrix (sparse, dense) stays the same.

Specified by:

multiplyBy in class FloatMatrixData

Parameters:

right - the other data object to multiply with

Throws:

ValueException - if matrices have different lengths

divideBy

public final void divideBy(FloatMatrixData right)
                    throws ValueException

Divide the values of a matrix by the values of another matrix on a cell-by-cell basis. The type of matrix (sparse, dense) stays the same.

Specified by:

divideBy in class FloatMatrixData

Parameters:

right - the other data object to divide by

Throws:

ValueException - if matrices have different lengths

hashCode

public int hashCode()

Overrides:

hashCode in class FloatMatrixData

equals

public boolean equals(Object obj)

Overrides:

equals in class FloatMatrixData