edu.ucla.sspace.matrix

Class ClutoDenseMatrixBuilder

java.lang.Object

edu.ucla.sspace.matrix.ClutoDenseMatrixBuilder

All Implemented Interfaces:

MatrixBuilder

public class ClutoDenseMatrixBuilder
extends Object
implements MatrixBuilder

A MatrixBuilder for building dense cluto matrix input files.

Author:

Keith Stevens

Constructor Summary

Constructors

Constructor and Description
ClutoDenseMatrixBuilder() Creates a new ClutoSparseMatrixBuilder using a constructed temp file.
ClutoDenseMatrixBuilder(File backingFile) Creates a new ClutoSparseMatrixBuilder using a the given file.

Method Summary

Methods

Modifier and Type	Method and Description
int	addColumn(double[] row) Adds the column values to the underlying matrix, updating the dimensions as necessary and returning the index at which the column was added.
int	addColumn(SparseArray<? extends Number> row) Adds the double values in the array to the underlying matrix, updating the dimensions as necessary and returning the index at which the column was added.
int	addColumn(Vector row) Adds the vector values to the underlying matrix, updating the dimensions as necessary and returning the index at which the column was added.
void	finish() Indicates that no further data will be added to the matrix and any remaining matrix meta-data should be written and flushed to disk.
File	getFile() Returns the file containing the matrix data after all data has finished being written.
MatrixFile	getMatrixFile()
MatrixIO.Format	getMatrixFormat() Returns the data format for the matrix file.
boolean	isFinished() Returns true if no further data should be added to the matrix and the file containing the data is available for us.

Methods inherited from class java.lang.Object

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

Constructor Detail

ClutoDenseMatrixBuilder

public ClutoDenseMatrixBuilder()

Creates a new ClutoSparseMatrixBuilder using a constructed temp file.

ClutoDenseMatrixBuilder

public ClutoDenseMatrixBuilder(File backingFile)

Creates a new ClutoSparseMatrixBuilder using a the given file.

Method Detail

addColumn

public int addColumn(double[] row)

Adds the column values to the underlying matrix, updating the dimensions as necessary and returning the index at which the column was added.

Specified by:

addColumn in interface MatrixBuilder

Parameters:

row - the values of the column in the matrix.

Returns:

the index at which the column is present.

addColumn

public int addColumn(SparseArray<? extends Number> row)

Adds the double values in the array to the underlying matrix, updating the dimensions as necessary and returning the index at which the column was added.

Specified by:

addColumn in interface MatrixBuilder

Parameters:

row - the values of the column in the matrix.

Returns:

the index at which the column is present.

addColumn

public int addColumn(Vector row)

Adds the vector values to the underlying matrix, updating the dimensions as necessary and returning the index at which the column was added.

Specified by:

addColumn in interface MatrixBuilder

Parameters:

row - the values of the column in the matrix.

Returns:

the index at which the column is present.

finish

public void finish()

Indicates that no further data will be added to the matrix and any remaining matrix meta-data should be written and flushed to disk. Once this method has been called addColumn will thcolumn a IllegalStateException if called. Once this method has been called, any subsequent calls will have no effect and will not throw an exception.

Specified by:

finish in interface MatrixBuilder

getFile

public File getFile()

Returns the file containing the matrix data after all data has finished being written. The finish method must be called prior to accessing the underlying file to ensure that all necessary matrix meta-data has been written to disk.

Specified by:

getFile in interface MatrixBuilder

Returns:

the file containing the matrix data

getMatrixFormat

public MatrixIO.Format getMatrixFormat()

Returns the data format for the matrix file.

Specified by:

getMatrixFormat in interface MatrixBuilder

Returns:

the format of the matrix's data

getMatrixFile

public MatrixFile getMatrixFile()

Specified by:

getMatrixFile in interface MatrixBuilder

isFinished

public boolean isFinished()

Returns true if no further data should be added to the matrix and the file containing the data is available for us. This will only return true if finish has been called first.

Specified by:

isFinished in interface MatrixBuilder

Returns:

true if no further data should be added to the matrix