Decorate (clrc1.0)

Overview

Package

Class

Tree

Index

Help

PREV CLASS NEXT CLASS

FRAMES NO FRAMES

SUMMARY: NESTED | FIELD | CONSTR | METHOD

DETAIL: FIELD | CONSTR | METHOD

weka.classifiers.meta
Class Decorate

java.lang.Object
  |
  +--weka.classifiers.Classifier
        |
        +--weka.classifiers.meta.Decorate

All Implemented Interfaces:: java.lang.Cloneable, OptionHandler, java.io.Serializable

public class Decorate
extends Classifier
implements OptionHandler

DECORATE is a meta-learner for building diverse ensembles of classifiers by using specially constructed artificial training examples. Comprehensive experiments have demonstrated that this technique is consistently more accurate than the base classifier, Bagging and Random Forests. Decorate also obtains higher accuracy than Boosting on small training sets, and achieves comparable performance on larger training sets. For more details see:

Prem Melville and Raymond J. Mooney. Constructing diverse classifier ensembles using artificial training examples. Proceedings of the Seventeeth International Joint Conference on Artificial Intelligence 2003.

Prem Melville and Raymond J. Mooney. Creating diversity in ensembles using artificial data. Submitted.

Valid options are:

-D
Turn on debugging output.

-W classname
Specify the full class name of a weak classifier as the basis for Decorate (default weka.classifiers.trees.J48()).

-I num
Specify the desired size of the committee (default 15).

-M iterations
Set the maximum number of Decorate iterations (default 50).

-S seed
Seed for random number generator. (default 0).

-R factor
Factor that determines number of artificial examples to generate.

Options after -- are passed to the designated classifier.

Version:: $Revision: 1.2 $
Author:: Prem Melville (melville@cs.utexas.edu)
See Also:: Serialized Form

Constructor Summary

Decorate()


Method Summary

java.lang.String artificialSizeTipText()
          Returns the tip text for this property

void buildClassifier(Instances data)
          Build Decorate classifier

java.lang.String classifierTipText()
          Returns the tip text for this property

java.lang.String desiredSizeTipText()
          Returns the tip text for this property

double[] distributionForInstance(Instance instance)
          Calculates the class membership probabilities for the given test instance.

double getArtificialSize()
          Factor that determines number of artificial examples to generate.

Classifier getClassifier()
          Get the classifier used as the base classifier

boolean getDebug()
          Get whether debugging is turned on

int getDesiredSize()
          Gets the desired size of the committee.

int getNumIterations()
          Gets the max number of Decorate iterations to run.

java.lang.String[] getOptions()
          Gets the current settings of the Classifier.

int getSeed()
          Gets the seed for the random number generator.

java.lang.String globalInfo()
          Returns a string describing classifier

java.util.Enumeration listOptions()
          Returns an enumeration describing the available options

static void main(java.lang.String[] argv)
          Main method for testing this class.

java.lang.String numIterationsTipText()
          Returns the tip text for this property

java.lang.String seedTipText()
          Returns the tip text for this property

void setArtificialSize(double newArtSize)
          Sets factor that determines number of artificial examples to generate.

void setClassifier(Classifier newClassifier)
          Set the base classifier for Decorate.

void setDebug(boolean debug)
          Set debugging mode

void setDesiredSize(int newDesiredSize)
          Sets the desired size of the committee.

void setNumIterations(int numIterations)
          Sets the max number of Decorate iterations to run.

void setOptions(java.lang.String[] options)
          Parses a given list of options.

void setSeed(int seed)
          Set the seed for random number generator.

java.lang.String toString()
          Returns description of the Decorate classifier.

Methods inherited from class weka.classifiers.Classifier

classifyInstance, debugTipText, forName, makeCopies

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Detail

Decorate

public Decorate()

Method Detail

listOptions

public java.util.Enumeration listOptions()

Returns an enumeration describing the available options

Specified by:: listOptions in interface OptionHandler
Overrides:: listOptions in class Classifier

Returns:: an enumeration of all the available options

setOptions

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

Parses a given list of options. Valid options are:

-D
Turn on debugging output.

-W classname
Specify the full class name of a weak classifier as the basis for Decorate (required).

-I num
Specify the desired size of the committee (default 15).

-M iterations
Set the maximum number of Decorate iterations (default 50).

-S seed
Seed for random number generator. (default 0).

-R factor
Factor that determines number of artificial examples to generate.

Options after -- are passed to the designated classifier.

Specified by:: setOptions in interface OptionHandler
Overrides:: setOptions in class Classifier

Parameters:: options - the list of options as an array of strings
Throws:: java.lang.Exception - if an option is not supported

getOptions

public java.lang.String[] getOptions()

Gets the current settings of the Classifier.

Specified by:: getOptions in interface OptionHandler
Overrides:: getOptions in class Classifier

Returns:: an array of strings suitable for passing to setOptions