weka.classifiers.trees
Class Id3

java.lang.Object
  weka.classifiers.AbstractClassifier
      weka.classifiers.trees.Id3

All Implemented Interfaces:

Serializable, Cloneable, weka.classifiers.Classifier, weka.classifiers.Sourcable, weka.core.CapabilitiesHandler, weka.core.OptionHandler, weka.core.RevisionHandler, weka.core.TechnicalInformationHandler

public class Id3
extends weka.classifiers.AbstractClassifier
implements weka.core.TechnicalInformationHandler, weka.classifiers.Sourcable

Class for constructing an unpruned decision tree based on the ID3 algorithm. Can only deal with nominal attributes. No missing values allowed. Empty leaves may result in unclassified instances. For more information see:

R. Quinlan (1986). Induction of decision trees. Machine Learning. 1(1):81-106.

BibTeX:

 @article{Quinlan1986,
    author = {R. Quinlan},
    journal = {Machine Learning},
    number = {1},
    pages = {81-106},
    title = {Induction of decision trees},
    volume = {1},
    year = {1986}
 }
 

Valid options are:

 -D
  If set, classifier is run in debug mode and
  may output additional info to the console

Version:

$Revision: 8109 $

Author:

Eibe Frank (eibe@cs.waikato.ac.nz)

See Also:

Serialized Form

Constructor Summary

Id3()

Method Summary

void	buildClassifier(weka.core.Instances data) Builds Id3 decision tree classifier.
double	classifyInstance(weka.core.Instance instance) Classifies a given test instance using the decision tree.
double[]	distributionForInstance(weka.core.Instance instance) Computes class distribution for instance using decision tree.
weka.core.Capabilities	getCapabilities() Returns default capabilities of the classifier.
String	getRevision() Returns the revision string.
weka.core.TechnicalInformation	getTechnicalInformation() Returns an instance of a TechnicalInformation object, containing detailed information about the technical background of this class, e.g., paper reference or book this class is based on.
String	globalInfo() Returns a string describing the classifier.
static void	main(String[] args) Main method.
String	toSource(String className) Returns a string that describes the classifier as source.
String	toString() Prints the decision tree using the private toString method from below.

Methods inherited from class weka.classifiers.AbstractClassifier

debugTipText, forName, getDebug, getOptions, listOptions, makeCopies, makeCopy, runClassifier, setDebug, setOptions

Methods inherited from class java.lang.Object

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

Constructor Detail

Id3

public Id3()

Method Detail

globalInfo

public String globalInfo()

Returns a string describing the classifier.

Returns:

a description suitable for the GUI.

getTechnicalInformation

public weka.core.TechnicalInformation getTechnicalInformation()

Returns an instance of a TechnicalInformation object, containing detailed information about the technical background of this class, e.g., paper reference or book this class is based on.

Specified by:

getTechnicalInformation in interface weka.core.TechnicalInformationHandler

Returns:

the technical information about this class

getCapabilities

public weka.core.Capabilities getCapabilities()

Returns default capabilities of the classifier.

Specified by:

getCapabilities in interface weka.classifiers.Classifier

Specified by:

getCapabilities in interface weka.core.CapabilitiesHandler

Overrides:

getCapabilities in class weka.classifiers.AbstractClassifier

Returns:

the capabilities of this classifier

buildClassifier

public void buildClassifier(weka.core.Instances data)
                     throws Exception

Builds Id3 decision tree classifier.

Specified by:

buildClassifier in interface weka.classifiers.Classifier

Parameters:

data - the training data

Throws:

Exception - if classifier can't be built successfully

classifyInstance

public double classifyInstance(weka.core.Instance instance)
                        throws weka.core.NoSupportForMissingValuesException

Classifies a given test instance using the decision tree.

Specified by:

classifyInstance in interface weka.classifiers.Classifier

Overrides:

classifyInstance in class weka.classifiers.AbstractClassifier

Parameters:

instance - the instance to be classified

Returns:

the classification

Throws:

weka.core.NoSupportForMissingValuesException - if instance has missing values

distributionForInstance

public double[] distributionForInstance(weka.core.Instance instance)
                                 throws weka.core.NoSupportForMissingValuesException

Computes class distribution for instance using decision tree.

Specified by:

distributionForInstance in interface weka.classifiers.Classifier

Overrides:

distributionForInstance in class weka.classifiers.AbstractClassifier

Parameters:

instance - the instance for which distribution is to be computed

Returns:

the class distribution for the given instance

Throws:

weka.core.NoSupportForMissingValuesException - if instance has missing values

toString

public String toString()

Prints the decision tree using the private toString method from below.

Overrides:

toString in class Object

Returns:

a textual description of the classifier

toSource

public String toSource(String className)
                throws Exception

Returns a string that describes the classifier as source. The classifier will be contained in a class with the given name (there may be auxiliary classes), and will contain a method with the signature:

 public static double classify(Object[] i);
 

where the array i contains elements that are either Double, String, with missing values represented as null. The generated code is public domain and comes with no warranty.
Note: works only if class attribute is the last attribute in the dataset.

Specified by:

toSource in interface weka.classifiers.Sourcable

Parameters:

className - the name that should be given to the source class.

Returns:

the object source described by a string

Throws:

Exception - if the source can't be computed

getRevision

public String getRevision()

Returns the revision string.

Specified by:

getRevision in interface weka.core.RevisionHandler

Overrides:

getRevision in class weka.classifiers.AbstractClassifier

Returns:

the revision

main

public static void main(String[] args)

Main method.

Parameters:

args - the options for the classifier