weka.filters
Class TimeSeriesTranslateFilter

java.lang.Object
  |
  +--weka.filters.Filter
        |
        +--weka.filters.AbstractTimeSeriesFilter
              |
              +--weka.filters.TimeSeriesTranslateFilter

All Implemented Interfaces:

OptionHandler, java.io.Serializable

Direct Known Subclasses:

TimeSeriesDeltaFilter

public class TimeSeriesTranslateFilter

extends AbstractTimeSeriesFilter

An instance filter that assumes instances form time-series data and replaces attribute values in the current instance with the equivalent attribute attribute values of some previous (or future) instance. For instances where the desired value is unknown either the instance may be dropped, or missing values used.

Valid filter-specific options are:

-R index1,index2-index4,...
Specify list of columns to calculate new values for. First and last are valid indexes. (default none)

-V
Invert matching sense (i.e. calculate for all non-specified columns)

-I num
The number of instances forward to translate values between. A negative number indicates taking values from a past instance. (default -1)

-M
For instances at the beginning or end of the dataset where the translated values are not known, use missing values (default is to remove those instances).

Author:

Len Trigg (trigg@cs.waikato.ac.nz)

See Also:

Serialized Form

Fields inherited from class weka.filters.AbstractTimeSeriesFilter

m_FillWithMissing, m_History, m_InstanceRange, m_SelectedCols

Fields inherited from class weka.filters.Filter

m_NewBatch

Constructor Summary

TimeSeriesTranslateFilter()

Method Summary

static void	main(java.lang.String[] argv) Main method for testing this class.
protected Instance	mergeInstances(Instance source, Instance dest) Creates a new instance the same as one instance (the "destination") but with some attribute values copied from another instance (the "source")
boolean	setInputFormat(Instances instanceInfo) Sets the format of the input instances.

Methods inherited from class weka.filters.AbstractTimeSeriesFilter

attributeIndicesTipText, batchFinished, getAttributeIndices, getFillWithMissing, getInstanceRange, getInvertSelection, getOptions, historyInput, input, listOptions, resetHistory, setAttributeIndices, setAttributeIndicesArray, setFillWithMissing, setInstanceRange, setInvertSelection, setOptions

Methods inherited from class weka.filters.Filter

batchFilterFile, bufferInput, copyStringValues, copyStringValues, filterFile, flushInput, getInputFormat, getInputStringIndex, getOutputFormat, getOutputStringIndex, getStringIndices, inputFormat, isOutputFormatDefined, numPendingOutput, output, outputFormat, outputFormatPeek, outputPeek, push, resetQueue, setOutputFormat, useFilter

Methods inherited from class java.lang.Object

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

Constructor Detail

TimeSeriesTranslateFilter

public TimeSeriesTranslateFilter()

Method Detail

setInputFormat

public boolean setInputFormat(Instances instanceInfo)
                       throws java.lang.Exception

Sets the format of the input instances.

Overrides:

setInputFormat in class AbstractTimeSeriesFilter

Parameters:

instanceInfo - an Instances object containing the input instance structure (any instances contained in the object are ignored - only the structure is required).

Returns:

true if the outputFormat may be collected immediately

Throws:

UnsupportedAttributeTypeException - if selected attributes are not numeric or nominal.

mergeInstances

protected Instance mergeInstances(Instance source,
                                  Instance dest)

Creates a new instance the same as one instance (the "destination") but with some attribute values copied from another instance (the "source")

Overrides:

mergeInstances in class AbstractTimeSeriesFilter

Parameters:

source - the source instance

dest - the destination instance

Returns:

the new merged instance

main

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

Main method for testing this class.

Parameters:

argv - should contain arguments to the filter: use -h for help