Class DataSet

java.lang.Object

DataSet

All Implemented Interfaces:

OptionHandler

public class DataSet
extends java.lang.Object
implements OptionHandler

Implements a class for a data set for machine-learning methods.

Field Summary

Fields

Modifier and Type	Field and Description
protected Attributes	attributes the attributes of this data set
protected Examples	examples the examples of this data set
protected java.lang.String	name the name of this data set
protected java.util.Random	random a random number generator
protected long	seed default random seed

Constructor Summary

Constructors

Constructor and Description
DataSet() Default constructor.
DataSet(Attributes attributes) Explicit constructor.

Method Summary

Methods

Modifier and Type	Method and Description
void	add(DataSet dataset) Adds the examples of the specified data set to this data set.
void	add(Example example) Adds the specified example to this data set.
Attributes	getAttributes() Gets the attributes of this DataSet object.
Examples	getExamples() Gets the examples of this data set.
boolean	getHasNominalAttributes() Returns true if this data set has nominal attributes; returns false otherwise.
boolean	getHasNumericAttributes() Returns true if this data set has numeric attributes; returns false otherwise.
long	getSeed() Gets the seed for this data set.
void	load(java.lang.String filename) Loads a data set from the specified file.
static void	main(java.lang.String[] args) A main method for testing.
private void	parse(java.util.Scanner scanner) Parses a data set from the specified scanner, which consists of parsing the data set's header, attributes, and examples.
void	setOptions(java.lang.String[] options) Sets the options for this data set.
void	setSeed(long seed) Sets the random number seed for this data set.
java.lang.String	toString() Returns a string representation of the data set in a format identical to that of the file format.

Methods inherited from class java.lang.Object

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

Field Detail

name

protected java.lang.String name

the name of this data set

attributes

protected Attributes attributes

the attributes of this data set

examples

protected Examples examples

the examples of this data set

seed

protected long seed

default random seed

random

protected java.util.Random random

a random number generator

Constructor Detail

DataSet

public DataSet()

Default constructor.

DataSet

public DataSet(Attributes attributes)
        throws java.lang.Exception

Explicit constructor.

Parameters:

attributes - the attributes for this data set

Throws:

java.lang.Exception - if the examples can not be added because of type or memory problems

Method Detail

add

public void add(DataSet dataset)
         throws java.lang.Exception

Adds the examples of the specified data set to this data set.

Parameters:

dataset - the data set to be added

Throws:

java.lang.Exception - if the examples can not be added because of type or memory problems

add

public void add(Example example)
         throws java.lang.Exception

Adds the specified example to this data set.

Parameters:

example - the example to be added

Throws:

java.lang.Exception - if the example can not be added because of type or memory problems

getAttributes

public Attributes getAttributes()

Gets the attributes of this DataSet object.

Returns:

the attributes of this data set

getExamples

public Examples getExamples()

Gets the examples of this data set.

Returns:

the examples of this data set

getSeed

public long getSeed()

Gets the seed for this data set.

Returns:

the seed for this data set

getHasNominalAttributes

public boolean getHasNominalAttributes()

Returns true if this data set has nominal attributes; returns false otherwise.

Returns:

true if this data set has nominal attributes

getHasNumericAttributes

public boolean getHasNumericAttributes()

Returns true if this data set has numeric attributes; returns false otherwise.

Returns:

true if this data set has numeric attributes

load

public void load(java.lang.String filename)
          throws java.lang.Exception

Loads a data set from the specified file.

Parameters:

filename - the file from which to read

Throws:

java.lang.Exception - if the file is not found or if a parse error occurs

parse

private void parse(java.util.Scanner scanner)
            throws java.lang.Exception

Parses a data set from the specified scanner, which consists of parsing the data set's header, attributes, and examples.

Parameters:

scanner - a scanner containing the data set's tokens

Throws:

java.lang.Exception - if a parse error occurs

setOptions

public void setOptions(java.lang.String[] options)
                throws java.lang.Exception

Sets the options for this data set. -s sets the random seed for this data set.

Specified by:

setOptions in interface OptionHandler

Parameters:

options - the arguments

Throws:

java.lang.Exception - if an option is illegal

setSeed

public void setSeed(long seed)

Sets the random number seed for this data set. This also seeds the random number generator.

Parameters:

seed - the seed

toString

public java.lang.String toString()

Returns a string representation of the data set in a format identical to that of the file format.

Overrides:

toString in class java.lang.Object

Returns:

a string containing data set

main

public static void main(java.lang.String[] args)

A main method for testing.