mulan.classifier.meta
Class ClusteringBased

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

public class ClusteringBased
extends MultiLabelMetaLearner

Class implementing clustering-based multi-label classification. For more information, see

Gulisong Nasierding, Grigorios Tsoumakas, Abbas Kouzani: Clustering Based Multi-Label Classification for Image Annotation and Retrieval. In: Proc. 2009 IEEE International Conference on Systems, Man, and Cybernetics (SMC 2009), 2009.

BibTeX:

 @inproceedings{GulisongNasierding2009,
    author = {Gulisong Nasierding, Grigorios Tsoumakas, Abbas Kouzani},
    booktitle = {Proc. 2009 IEEE International Conference on Systems, Man, and Cybernetics (SMC 2009)},
    title = {Clustering Based Multi-Label Classification for Image Annotation and Retrieval},
    year = {2009},
    location = {Texas, USA}
 }
 

Version:
2012.02.27
Author:
Gulisong Nasierding, 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
ClusteringBased()
          Default constructor.
ClusteringBased(Clusterer aClusterer, MultiLabelLearner aMultiLabelClassifier)
          Constructor
 
Method Summary
 void buildInternal(MultiLabelInstances trainData)
          Learner specific implementation of building the model from MultiLabelInstances training data set.
 Clusterer getClusterer()
          Returns the clustering approach
 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.
protected  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

ClusteringBased

public ClusteringBased()
Default constructor.


ClusteringBased

public ClusteringBased(Clusterer aClusterer,
                       MultiLabelLearner aMultiLabelClassifier)
Constructor

Parameters:
aClusterer - the clustering approach
aMultiLabelClassifier - the multi-label learner
Method Detail

getClusterer

public Clusterer getClusterer()
Returns the clustering approach

Returns:
the clustering approach

buildInternal

public void buildInternal(MultiLabelInstances trainData)
                   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:
trainData - the training data set
Throws:
Exception - if learner model was not created successfully

makePredictionInternal

protected MultiLabelOutput makePredictionInternal(Instance instance)
                                           throws Exception,
                                                  InvalidDataException
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

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

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