smile.data.parser

Class SparseDatasetParser

java.lang.Object

smile.data.parser.SparseDatasetParser

public class SparseDatasetParser
extends Object

Parser for spare dataset in coordinate triple tuple list format. Coordinate file stores a list of (row, column, value) tuples:

 instanceID attributeID value
 instanceID attributeID value
 instanceID attributeID value
 instanceID attributeID value
 ...
 instanceID attributeID value
 instanceID attributeID value
 instanceID attributeID value
 

Ideally, the entries are sorted (by row index, then column index) to improve random access times. This format is good for incremental matrix construction.

Optionally, there may be 2 header lines

 D    // The number of instances
 W    // The number of attributes
 

or 3 header lines

 D    // The number of instances
 W    // The number of attributes
 N    // The total number of nonzero items in the dataset.
 

These header lines will be ignored.

Author:

Haifeng Li

Constructor Summary

Constructors

Constructor and Description
SparseDatasetParser() Constructor.
SparseDatasetParser(int arrayStartingIndex) Constructor.

Method Summary

Methods

Modifier and Type	Method and Description
SparseDataset	parse(File file) Parse a sparse dataset from given file.
SparseDataset	parse(InputStream stream) Parse a sparse dataset from an input stream.
SparseDataset	parse(String path) Parse a sparse dataset from given file.
SparseDataset	parse(String name, File file) Parse a sparse dataset from given file.
SparseDataset	parse(String name, InputStream stream) Parse a sparse dataset from an input stream.
SparseDataset	parse(String name, String path) Parse a sparse dataset from given file.
SparseDataset	parse(String name, URI uri) Parse a sparse dataset from given URI.
SparseDataset	parse(URI uri) Parse a sparse dataset from given URI.

Methods inherited from class java.lang.Object

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

Constructor Detail

SparseDatasetParser

public SparseDatasetParser()

Constructor.

SparseDatasetParser

public SparseDatasetParser(int arrayStartingIndex)

Constructor.

Parameters:

arrayStartingIndex - the starting index of array. By default, it is 0 as in C/C++ and Java. But it could be 1 to parse data produced by other programming language such as Fortran.

Method Detail

parse

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

Parse a sparse dataset from given URI.

Throws:

FileNotFoundException

IOException

ParseException

parse

public SparseDataset parse(String name,
                  URI uri)
                    throws FileNotFoundException,
                           IOException,
                           ParseException

Parse a sparse dataset from given URI.

Parameters:

uri - the URI of data source.

Throws:

FileNotFoundException

IOException

ParseException

parse

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

Parse a sparse dataset from given file.

Throws:

FileNotFoundException

IOException

ParseException

parse

public SparseDataset parse(String name,
                  String path)
                    throws FileNotFoundException,
                           IOException,
                           ParseException

Parse a sparse dataset from given file.

Parameters:

path - the file path of data source.

Throws:

FileNotFoundException

IOException

ParseException

parse

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

Parse a sparse dataset from given file.

Throws:

FileNotFoundException

IOException

ParseException

parse

public SparseDataset parse(String name,
                  File file)
                    throws FileNotFoundException,
                           IOException,
                           ParseException

Parse a sparse dataset from given file.

Parameters:

file - the file of data source.

Throws:

FileNotFoundException

IOException

ParseException

parse

public SparseDataset parse(InputStream stream)
                    throws IOException,
                           ParseException

Parse a sparse dataset from an input stream.

Parameters:

stream - the input stream of data.

Throws:

FileNotFoundException

IOException

ParseException

parse

public SparseDataset parse(String name,
                  InputStream stream)
                    throws IOException,
                           ParseException

Parse a sparse dataset from an input stream.

Parameters:

name - the name of dataset.

stream - the input stream of data.

Throws:

FileNotFoundException

IOException

ParseException