public class Resample extends Filter implements SupervisedFilter, OptionHandler
-S <num> Specify the random number seed (default 1)
-Z <num> The size of the output dataset, as a percentage of the input dataset (default 100)
-B <num> Bias factor towards uniform class distribution. 0 = distribution in input data -- 1 = uniform distribution. (default 0)
-no-replacement Disables replacement of instances (default: with replacement)
-V Inverts the selection - only available with '-no-replacement'.
Modifier and Type | Field and Description |
---|---|
protected double |
m_BiasToUniformClass
The degree of bias towards uniform (nominal) class distribution.
|
protected boolean |
m_InvertSelection
Whether to invert the selection (only if instances are drawn WITHOUT
replacement).
|
protected boolean |
m_NoReplacement
Whether to perform sampling with replacement or without.
|
protected int |
m_RandomSeed
The random number generator seed.
|
protected double |
m_SampleSizePercent
The subsample size, percent of original set, default 100%.
|
m_FirstBatchDone, m_InputRelAtts, m_InputStringAtts, m_NewBatch, m_OutputRelAtts, m_OutputStringAtts
Constructor and Description |
---|
Resample() |
Modifier and Type | Method and Description |
---|---|
boolean |
batchFinished()
Signify that this batch of input to the filter is finished.
|
String |
biasToUniformClassTipText()
Returns the tip text for this property.
|
protected void |
createSubsample()
Creates a subsample of the current set of input instances.
|
void |
createSubsampleWithoutReplacement(Random random,
int origSize,
int sampleSize,
int actualClasses,
int[] classIndices)
creates the subsample without replacement.
|
void |
createSubsampleWithReplacement(Random random,
int origSize,
int sampleSize,
int actualClasses,
int[] classIndices)
creates the subsample with replacement.
|
double |
getBiasToUniformClass()
Gets the bias towards a uniform class.
|
Capabilities |
getCapabilities()
Returns the Capabilities of this filter.
|
boolean |
getInvertSelection()
Gets whether selection is inverted (only if instances are drawn WIHTOUT
replacement).
|
boolean |
getNoReplacement()
Gets whether instances are drawn with or without replacement.
|
String[] |
getOptions()
Gets the current settings of the filter.
|
int |
getRandomSeed()
Gets the random number seed.
|
String |
getRevision()
Returns the revision string.
|
double |
getSampleSizePercent()
Gets the subsample size as a percentage of the original set.
|
String |
globalInfo()
Returns a string describing this filter.
|
boolean |
input(Instance instance)
Input an instance for filtering.
|
String |
invertSelectionTipText()
Returns the tip text for this property.
|
Enumeration |
listOptions()
Returns an enumeration describing the available options.
|
static void |
main(String[] argv)
Main method for testing this class.
|
String |
noReplacementTipText()
Returns the tip text for this property.
|
String |
randomSeedTipText()
Returns the tip text for this property.
|
String |
sampleSizePercentTipText()
Returns the tip text for this property.
|
void |
setBiasToUniformClass(double newBiasToUniformClass)
Sets the bias towards a uniform class.
|
boolean |
setInputFormat(Instances instanceInfo)
Sets the format of the input instances.
|
void |
setInvertSelection(boolean value)
Sets whether the selection is inverted (only if instances are drawn WIHTOUT
replacement).
|
void |
setNoReplacement(boolean value)
Sets whether instances are drawn with or with out replacement.
|
void |
setOptions(String[] options)
Parses a given list of options.
|
void |
setRandomSeed(int newSeed)
Sets the random number seed.
|
void |
setSampleSizePercent(double newSampleSizePercent)
Sets the size of the subsample, as a percentage of the original set.
|
batchFilterFile, bufferInput, copyValues, copyValues, filterFile, flushInput, getCapabilities, getInputFormat, getOutputFormat, initInputLocators, initOutputLocators, inputFormatPeek, isFirstBatchDone, isNewBatch, isOutputFormatDefined, makeCopies, makeCopy, numPendingOutput, output, outputFormatPeek, outputPeek, push, resetQueue, runFilter, setOutputFormat, testInputFormat, toString, useFilter, wekaStaticWrapper
protected double m_SampleSizePercent
protected int m_RandomSeed
protected double m_BiasToUniformClass
protected boolean m_NoReplacement
protected boolean m_InvertSelection
m_NoReplacement
public String globalInfo()
public Enumeration listOptions()
listOptions
in interface OptionHandler
public void setOptions(String[] options) throws Exception
-S <num> Specify the random number seed (default 1)
-Z <num> The size of the output dataset, as a percentage of the input dataset (default 100)
-B <num> Bias factor towards uniform class distribution. 0 = distribution in input data -- 1 = uniform distribution. (default 0)
-no-replacement Disables replacement of instances (default: with replacement)
-V Inverts the selection - only available with '-no-replacement'.
setOptions
in interface OptionHandler
options
- the list of options as an array of stringsException
- if an option is not supportedpublic String[] getOptions()
getOptions
in interface OptionHandler
public String biasToUniformClassTipText()
public double getBiasToUniformClass()
public void setBiasToUniformClass(double newBiasToUniformClass)
newBiasToUniformClass
- the new bias value, between 0 and 1.public String randomSeedTipText()
public int getRandomSeed()
public void setRandomSeed(int newSeed)
newSeed
- the new random number seed.public String sampleSizePercentTipText()
public double getSampleSizePercent()
public void setSampleSizePercent(double newSampleSizePercent)
newSampleSizePercent
- the subsample set size, between 0 and 100.public String noReplacementTipText()
public boolean getNoReplacement()
public void setNoReplacement(boolean value)
value
- if true then the replacement of instances is disabledpublic String invertSelectionTipText()
public boolean getInvertSelection()
m_NoReplacement
public void setInvertSelection(boolean value)
value
- if true then selection is invertedpublic Capabilities getCapabilities()
getCapabilities
in interface CapabilitiesHandler
getCapabilities
in class Filter
Capabilities
public boolean setInputFormat(Instances instanceInfo) throws Exception
setInputFormat
in class Filter
instanceInfo
- an Instances object containing the input
instance structure (any instances contained in the object are
ignored - only the structure is required).Exception
- if the input format can't be set
successfullypublic boolean input(Instance instance)
input
in class Filter
instance
- the input instanceIllegalStateException
- if no input structure has been definedpublic boolean batchFinished()
batchFinished
in class Filter
IllegalStateException
- if no input structure has been definedpublic void createSubsampleWithReplacement(Random random, int origSize, int sampleSize, int actualClasses, int[] classIndices)
random
- the random number generator to useorigSize
- the original size of the datasetsampleSize
- the size to generateactualClasses
- the number of classes found in the dataclassIndices
- the indices where classes startpublic void createSubsampleWithoutReplacement(Random random, int origSize, int sampleSize, int actualClasses, int[] classIndices)
random
- the random number generator to useorigSize
- the original size of the datasetsampleSize
- the size to generateactualClasses
- the number of classes found in the dataclassIndices
- the indices where classes startprotected void createSubsample()
public String getRevision()
getRevision
in interface RevisionHandler
getRevision
in class Filter
public static void main(String[] argv)
argv
- should contain arguments to the filter:
use -h for helpCopyright © 2015 University of Waikato, Hamilton, NZ. All rights reserved.