Package de.lmu.ifi.dbs.elki.datasource.parser

Parsers for different file formats and data types.

See: Description

Interface Summary

Interface	Description
Parser	A Parser shall provide a ParsingResult by parsing an InputStream.
StreamingParser	Interface for streaming parsers, that may be much more efficient in combination with filters.

Class Summary

Class	Description
AbstractParser	Abstract superclass for all parsers providing the option handler for handling options.
AbstractParser.Parameterizer	Parameterization class.
AbstractStreamingParser	Base class for streaming parsers.
ArffParser	Parser to load WEKA .arff files into ELKI.
ArffParser.Parameterizer	Parameterization class.
BitVectorLabelParser	Provides a parser for parsing one BitVector per line, bits separated by whitespace.
BitVectorLabelParser.Parameterizer	Parameterization class.
DoubleVectorLabelParser	Provides a parser for parsing one point per line, attributes separated by whitespace.
DoubleVectorLabelParser.Parameterizer	Parameterization class.
FloatVectorLabelParser	Provides a parser for parsing one point per line, attributes separated by whitespace.
FloatVectorLabelParser.Parameterizer	Parameterization class.
NumberVectorLabelParser<V extends NumberVector<V,?>>	Provides a parser for parsing one point per line, attributes separated by whitespace.
NumberVectorLabelParser.Parameterizer<V extends NumberVector<V,?>>	Parameterization class.
ParameterizationFunctionLabelParser	Provides a parser for parsing one point per line, attributes separated by whitespace.
ParameterizationFunctionLabelParser.Parameterizer	Parameterization class.
SimplePolygonParser	Parser to load polygon data (2D and 3D only) from a simple format.
SimplePolygonParser.Parameterizer	Parameterization class.
SparseBitVectorLabelParser	Provides a parser for parsing one sparse BitVector per line, where the indices of the one-bits are separated by whitespace.
SparseBitVectorLabelParser.Parameterizer	Parameterization class.
SparseFloatVectorLabelParser	Provides a parser for parsing one point per line, attributes separated by whitespace.
SparseFloatVectorLabelParser.Parameterizer	Parameterization class.
TermFrequencyParser	A parser to load term frequency data, which essentially are sparse vectors with text keys.
TermFrequencyParser.Parameterizer	Parameterization class.

Package de.lmu.ifi.dbs.elki.datasource.parser Description

Parsers for different file formats and data types.

The general use-case for any parser is to create objects out of an InputStream (e.g. by reading a data file). The objects are packed in a MultipleObjectsBundle which, in turn, is used by a DatabaseConnection-Object to fill a Database containing the corresponding objects.

By default (i.e., if the user does not specify any specific requests), any KDDTask will use the StaticArrayDatabase which, in turn, will use a FileBasedDatabaseConnection and a DoubleVectorLabelParser to parse a specified data file creating a StaticArrayDatabase containing DoubleVector-Objects.

Thus, the standard procedure to use a data set of a real-valued vector space is to prepare the data set in a file of the following format (as suitable to DoubleVectorLabelParser):

• One point per line, attributes separated by whitespace.
• Several labels may be given per point. A label must not be parseable as double.
• Lines starting with "#" will be ignored.
• An index can be specified to identify an entry to be treated as class label. This index counts all entries (numeric and labels as well) starting with 0.
• Files can be gzip compressed.

This file format is e.g. also suitable to gnuplot.

As an example file following these requirements consider e.g.: exampledata.txt