mulan.classifier.meta.thresholding
Class SCut

java.lang.Object
  extended by mulan.classifier.MultiLabelLearnerBase
      extended by mulan.classifier.meta.MultiLabelMetaLearner
          extended by mulan.classifier.meta.thresholding.SCut
All Implemented Interfaces:
Serializable, MultiLabelLearner, TechnicalInformationHandler

public class SCut
extends MultiLabelMetaLearner

Class that implements the SCut method (Score-based local optimization). It computes a separate threshold for each label based on improving a user defined performance measure.For more information, see

Yiming Yang: A study of thresholding strategies for text categorization. In: Proceedings of the 24th annual international ACM SIGIR conference on Research and development in information retrieval, 137 - 145, 2001.

* BibTeX: *

 * @inproceedings{Yang2001,
 *    author = {Yiming Yang},
 *    booktitle = {Proceedings of the 24th annual international ACM SIGIR conference on Research and development in information retrieval},
 *    pages = {137 - 145},
 *    title = {A study of thresholding strategies for text categorization},
 *    year = {2001},
 *    location = {New Orleans, Louisiana, United States}
 * }
 * 
*

Version:
2010.12.14
Author:
Marios Ioannou, George Sakkas, Grigorios Tsoumakas
See Also:
Serialized Form

Field Summary
 
Fields inherited from class mulan.classifier.meta.MultiLabelMetaLearner
baseLearner
 
Fields inherited from class mulan.classifier.MultiLabelLearnerBase
featureIndices, labelIndices, numLabels
 
Constructor Summary
SCut()
          Default constructor
SCut(MultiLabelLearner baseLearner, BipartitionMeasureBase measure)
          Creates a new instance of SCut
SCut(MultiLabelLearner baseLearner, BipartitionMeasureBase measure, int folds)
          Constructor that initializes the learner with a base algorithm , Measure and num of folds
 
Method Summary
protected  void buildInternal(MultiLabelInstances trainingSet)
          Learner specific implementation of building the model from MultiLabelInstances training data set.
 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 multi-label learner.
 MultiLabelOutput makePredictionInternal(Instance instance)
          Learner specific implementation for predicting on specified data based on trained model.
 
Methods inherited from class mulan.classifier.meta.MultiLabelMetaLearner
getBaseLearner
 
Methods inherited from class mulan.classifier.MultiLabelLearnerBase
build, debug, getDebug, isModelInitialized, isUpdatable, makeCopy, makePrediction, setDebug
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Constructor Detail

SCut

public SCut()
Default constructor


SCut

public SCut(MultiLabelLearner baseLearner,
            BipartitionMeasureBase measure,
            int folds)
Constructor that initializes the learner with a base algorithm , Measure and num of folds

Parameters:
baseLearner - the underlying multi-label learner
measure -
folds - the number of folds to split the dataset

SCut

public SCut(MultiLabelLearner baseLearner,
            BipartitionMeasureBase measure)
Creates a new instance of SCut

Parameters:
baseLearner - the underlying multi-label learner
measure -
Method Detail

getTechnicalInformation

public TechnicalInformation getTechnicalInformation()
Description copied from class: MultiLabelLearnerBase
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
Specified by:
getTechnicalInformation in class MultiLabelLearnerBase
Returns:
the technical information about this class

buildInternal

protected void buildInternal(MultiLabelInstances trainingSet)
                      throws Exception
Description copied from class: MultiLabelLearnerBase
Learner specific implementation of building the model from MultiLabelInstances training data set. This method is called from MultiLabelLearnerBase.build(MultiLabelInstances) method, where behavior common across all learners is applied.

Specified by:
buildInternal in class MultiLabelLearnerBase
Parameters:
trainingSet - the training data set
Throws:
Exception - if learner model was not created successfully

makePredictionInternal

public MultiLabelOutput makePredictionInternal(Instance instance)
                                        throws Exception
Description copied from class: MultiLabelLearnerBase
Learner specific implementation for predicting on specified data based on trained model. This method is called from MultiLabelLearnerBase.makePrediction(weka.core.Instance) which guards for model initialization and apply common handling/behavior.

Specified by:
makePredictionInternal in class MultiLabelLearnerBase
Parameters:
instance - the data instance to predict on
Returns:
the output of the learner for the given instance
Throws:
Exception - if an error occurs while making the prediction.
InvalidDataException - if specified instance data is invalid and can not be processed by the learner

globalInfo

public String globalInfo()
Description copied from class: MultiLabelLearnerBase
Returns a string describing the multi-label learner.

Specified by:
globalInfo in class MultiLabelLearnerBase
Returns:
a description suitable for displaying in a future gui