edu.udo.cs.yale.example
Class MemoryExampleTable

java.lang.Object
  edu.udo.cs.yale.example.AbstractExampleTable
      edu.udo.cs.yale.example.MemoryExampleTable

All Implemented Interfaces:

ExampleTable

public class MemoryExampleTable
extends AbstractExampleTable

This class is the core data supplier for example sets. Several example sets can use the same data and access the attribute values by reference. In this case the data is hold in the main memory during the experiment.

Version:

$Id: MemoryExampleTable.java,v 2.23 2006/03/23 17:48:24 ingomierswa Exp $

Author:

Simon Fischer, Ingo Mierswa

Field Summary

private int	columns Number of columns.
private java.util.List<DataRow>	dataList List of DataRows.
private static int	INCREMENT Number of columns to add when new columns are allocated.

Constructor Summary

MemoryExampleTable(java.util.List<Attribute> attributes)
Creates a new instance of MemoryExampleTable.

MemoryExampleTable(java.util.List<Attribute> attributes, DataRowReader i)
Creates an empty memory example table and fills it with the data rows read from i.

MemoryExampleTable(java.util.List<Attribute> attributes, DataRowReader i, boolean permutate)
Creates an empty memory example table and fills it with the data rows read from i.

MemoryExampleTable(java.util.List<Attribute> attributes, int size)
Creates a new instance of MemoryExampleTable.

Method Summary

int	addAttribute(Attribute attribute) Adds a new attribute to this example table by invoking the super method.
void	addDataRow(DataRow dataRow) Convenience method allowing the adding of data rows without a data row reader.
DataRowReader	getDataReader() Returns a new data row reader.
DataRow	getDataRow(int index) Returns the data row with the given index.
int	getSize() Returns the size of this example table, i.e. the number of data rows.
void	readExamples(DataRowReader i) Reads the examples into memory in the order they are delivered by the given reader.
void	readExamples(DataRowReader i, boolean permutate) Reads the examples into memory and permutates the order.
void	readExamples(DataRowReader i, boolean permutate, java.util.Random random) Reads the examples into memory and permutates the order.

Methods inherited from class edu.udo.cs.yale.example.AbstractExampleTable

addAttributes, createCompleteExampleSet, createCompleteExampleSet, createCompleteExampleSet, createExampleSet, findAttribute, getAttribute, getAttribute, getAttributeCount, getAttributes, getBlockEndIndex, getHighestBlockNr, getNextFreeBlockNr, getNumberOfAttributes, removeAttribute, removeAttribute, toDataString, toString

Methods inherited from class java.lang.Object

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

Field Detail

dataList

private java.util.List<DataRow> dataList

List of DataRows.

columns

private int columns

Number of columns.

INCREMENT

private static final int INCREMENT

Number of columns to add when new columns are allocated.

See Also:

Constant Field Values

Constructor Detail

MemoryExampleTable

public MemoryExampleTable(java.util.List<Attribute> attributes)

Creates a new instance of MemoryExampleTable.

Parameters:

attributes - List of Attribute containing the attributes of the columns. None of these must be null.

MemoryExampleTable

public MemoryExampleTable(java.util.List<Attribute> attributes,
                          int size)

Creates a new instance of MemoryExampleTable.

Parameters:

attributes - List of Attribute containing the attributes of the columns. None of these must be null.

size - initial size of this example table. All values will be Double.NaN.

MemoryExampleTable

public MemoryExampleTable(java.util.List<Attribute> attributes,
                          DataRowReader i)

Creates an empty memory example table and fills it with the data rows read from i.

MemoryExampleTable

public MemoryExampleTable(java.util.List<Attribute> attributes,
                          DataRowReader i,
                          boolean permutate)

Creates an empty memory example table and fills it with the data rows read from i.

Method Detail

readExamples

public void readExamples(DataRowReader i)

Reads the examples into memory in the order they are delivered by the given reader. Removes all old data rows first.

readExamples

public void readExamples(DataRowReader i,
                         boolean permutate)

Reads the examples into memory and permutates the order. Removes all old data rows first.

readExamples

public void readExamples(DataRowReader i,
                         boolean permutate,
                         java.util.Random random)

Reads the examples into memory and permutates the order. Removes all old data rows first.

getDataReader

public DataRowReader getDataReader()

Returns a new data row reader.

Specified by:

getDataReader in interface ExampleTable

Specified by:

getDataReader in class AbstractExampleTable

getDataRow

public DataRow getDataRow(int index)

Returns the data row with the given index.

Specified by:

getDataRow in interface ExampleTable

Specified by:

getDataRow in class AbstractExampleTable

getSize

public int getSize()

Returns the size of this example table, i.e. the number of data rows.

Specified by:

getSize in interface ExampleTable

Specified by:

getSize in class AbstractExampleTable

addDataRow

public void addDataRow(DataRow dataRow)

Convenience method allowing the adding of data rows without a data row reader.

addAttribute

public int addAttribute(Attribute attribute)

Adds a new attribute to this example table by invoking the super method. If the number of attribues reaches a threshold, the number of attributes is increased by INCREMENT attributes. This avoids a large number of array copies in cases like automatic feature construction etc.

Specified by:

addAttribute in interface ExampleTable

Overrides:

addAttribute in class AbstractExampleTable