weka.classifiers.meta

Class Grading

java.lang.Object

weka.classifiers.Classifier

weka.classifiers.MultipleClassifiersCombiner

weka.classifiers.RandomizableMultipleClassifiersCombiner

weka.classifiers.meta.Stacking

weka.classifiers.meta.Grading

All Implemented Interfaces:

Serializable, Cloneable, CapabilitiesHandler, OptionHandler, Randomizable, RevisionHandler, TechnicalInformationHandler

public class Grading
extends Stacking
implements TechnicalInformationHandler

Implements Grading. The base classifiers are "graded".

For more information, see

A.K. Seewald, J. Fuernkranz: An Evaluation of Grading Classifiers. In: Advances in Intelligent Data Analysis: 4th International Conference, Berlin/Heidelberg/New York/Tokyo, 115-124, 2001.

BibTeX:

 @inproceedings{Seewald2001,
    address = {Berlin/Heidelberg/New York/Tokyo},
    author = {A.K. Seewald and J. Fuernkranz},
    booktitle = {Advances in Intelligent Data Analysis: 4th International Conference},
    editor = {F. Hoffmann et al.},
    pages = {115-124},
    publisher = {Springer},
    title = {An Evaluation of Grading Classifiers},
    year = {2001}
 }
 

Valid options are:

 -M <scheme specification>
  Full name of meta classifier, followed by options.
  (default: "weka.classifiers.rules.Zero")

 -X <number of folds>
  Sets the number of cross-validation folds.

 -S <num>
  Random number seed.
  (default 1)

 -B <classifier specification>
  Full class name of classifier to include, followed
  by scheme options. May be specified multiple times.
  (default: "weka.classifiers.rules.ZeroR")

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

Version:

$Revision: 1.13 $

Author:

Alexander K. Seewald (alex@seewald.at), Eibe Frank (eibe@cs.waikato.ac.nz)

See Also:

Serialized Form

Field Summary

Fields

Modifier and Type	Field and Description
protected double[]	m_InstPerClass InstPerClass
protected Classifier[]	m_MetaClassifiers The meta classifiers, one for each base classifier.

Fields inherited from class weka.classifiers.meta.Stacking

m_BaseFormat, m_MetaClassifier, m_MetaFormat, m_NumFolds

Fields inherited from class weka.classifiers.RandomizableMultipleClassifiersCombiner

m_Seed

Fields inherited from class weka.classifiers.MultipleClassifiersCombiner

m_Classifiers

Fields inherited from class weka.classifiers.Classifier

m_Debug

Constructor Summary

Constructors

Constructor and Description
Grading()

Method Summary

Modifier and Type	Method and Description
double[]	distributionForInstance(Instance instance) Returns class probabilities for a given instance using the stacked classifier.
protected void	generateMetaLevel(Instances newData, Random random) Generates the meta data
String	getRevision() Returns the revision string.
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 classifier
static void	main(String[] argv) Main method for testing this class.
protected Instances	metaFormat(Instances instances) Makes the format for the level-1 data.
protected Instance	metaInstance(Instance instance, int k) Makes a level-1 instance from the given instance.
String	toString() Output a representation of this classifier

Methods inherited from class weka.classifiers.meta.Stacking

buildClassifier, getCapabilities, getMetaClassifier, getNumFolds, getOptions, listOptions, metaClassifierTipText, metaInstance, metaOption, numFoldsTipText, processMetaOptions, setMetaClassifier, setNumFolds, setOptions

Methods inherited from class weka.classifiers.RandomizableMultipleClassifiersCombiner

getSeed, seedTipText, setSeed

Methods inherited from class weka.classifiers.MultipleClassifiersCombiner

classifiersTipText, getClassifier, getClassifiers, getClassifierSpec, setClassifiers

Methods inherited from class weka.classifiers.Classifier

classifyInstance, debugTipText, forName, getDebug, makeCopies, makeCopy, runClassifier, setDebug

Methods inherited from class java.lang.Object

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

Field Detail

m_MetaClassifiers

protected Classifier[] m_MetaClassifiers

The meta classifiers, one for each base classifier.

m_InstPerClass

protected double[] m_InstPerClass

InstPerClass

Constructor Detail

Grading

public Grading()

Method Detail

globalInfo

public String globalInfo()

Returns a string describing classifier

Overrides:

globalInfo in class Stacking

Returns:

a description suitable for displaying in the explorer/experimenter gui

getTechnicalInformation

public 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 TechnicalInformationHandler

Overrides:

getTechnicalInformation in class Stacking

Returns:

the technical information about this class

generateMetaLevel

protected void generateMetaLevel(Instances newData,
                                 Random random)
                          throws Exception

Generates the meta data

Overrides:

generateMetaLevel in class Stacking

Parameters:

newData - the data to work on

random - the random number generator used in the generation

Throws:

Exception - if generation fails

distributionForInstance

public double[] distributionForInstance(Instance instance)
                                 throws Exception

Returns class probabilities for a given instance using the stacked classifier. One class will always get all the probability mass (i.e. probability one).

Overrides:

distributionForInstance in class Stacking

Parameters:

instance - the instance to be classified

Returns:

the class distribution for the given instance

Throws:

Exception - if instance could not be classified successfully

toString

public String toString()

Output a representation of this classifier

Overrides:

toString in class Stacking

Returns:

a string representation of the classifier

metaFormat

protected Instances metaFormat(Instances instances)
                        throws Exception

Makes the format for the level-1 data.

Overrides:

metaFormat in class Stacking

Parameters:

instances - the level-0 format

Returns:

the format for the meta data

Throws:

Exception - if an error occurs

metaInstance

protected Instance metaInstance(Instance instance,
                                int k)
                         throws Exception

Makes a level-1 instance from the given instance.

Parameters:

instance - the instance to be transformed

k - index of the classifier

Returns:

the level-1 instance

Throws:

Exception - if an error occurs

getRevision

public String getRevision()

Returns the revision string.

Specified by:

getRevision in interface RevisionHandler

Overrides:

getRevision in class Stacking

Returns:

the revision

main

public static void main(String[] argv)

Main method for testing this class.

Parameters:

argv - should contain the following arguments: -t training file [-T test file] [-c class index]