smile.data.parser

Class SparseMatrixParser

java.lang.Object

smile.data.parser.SparseMatrixParser

public class SparseMatrixParser
extends Object

Harwell-Boeing column-compressed sparse matrix file parser. In Harwell-Boeing column-compressed sparse matrix format, nonzero values are stored in an array (top-to-bottom, then left-to-right-bottom). The row indices corresponding to the values are also stored. Besides, a list of pointers are indexes where each column starts. This class supports two formats for Harwell-Boeing files. The simple one is organized as follows:

The first line contains three integers, which are the number of rows, the number of columns, and the number of nonzero entries in the matrix.

Following the first line, there are m + 1 integers that are the indices of columns, where m is the number of columns. Then there are n integers that are the row indices of nonzero entries, where n is the number of nonzero entries. Finally, there are n float numbers that are the values of nonzero entries.

The second format is more complicated and powerful, called Harwell-Boeing Exchange Format. For details, see http://people.sc.fsu.edu/~jburkardt/data/hb/hb.html. Note that our implementation supports only real-valued matrix and we ignore the optional right hand side vectors.

Author:

Haifeng Li

Constructor Summary

Constructors

Constructor and Description
SparseMatrixParser() Constructor.

Method Summary

Methods

Modifier and Type	Method and Description
SparseMatrix	parse(File file) Parse a Harwell-Boeing column-compressed sparse matrix dataset from given file.
SparseMatrix	parse(InputStream stream) Parse a Harwell-Boeing column-compressed sparse matrix dataset from an input stream.
SparseMatrix	parse(String path) Parse a Harwell-Boeing column-compressed sparse matrix dataset from given file.
SparseMatrix	parse(URI uri) Parse a Harwell-Boeing column-compressed sparse matrix dataset from given URI.

Methods inherited from class java.lang.Object

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

Constructor Detail

SparseMatrixParser

public SparseMatrixParser()

Constructor.

Method Detail

parse

public SparseMatrix parse(URI uri)
                   throws FileNotFoundException,
                          IOException,
                          ParseException

Parse a Harwell-Boeing column-compressed sparse matrix dataset from given URI.

Throws:

FileNotFoundException

IOException

ParseException

parse

public SparseMatrix parse(String path)
                   throws FileNotFoundException,
                          IOException,
                          ParseException

Parse a Harwell-Boeing column-compressed sparse matrix dataset from given file.

Throws:

FileNotFoundException

IOException

ParseException

parse

public SparseMatrix parse(File file)
                   throws FileNotFoundException,
                          IOException,
                          ParseException

Parse a Harwell-Boeing column-compressed sparse matrix dataset from given file.

Throws:

FileNotFoundException

IOException

ParseException

parse

public SparseMatrix parse(InputStream stream)
                   throws IOException,
                          ParseException

Parse a Harwell-Boeing column-compressed sparse matrix dataset from an input stream.

Parameters:

stream - the input stream of data.

Throws:

FileNotFoundException

IOException

ParseException