it.uniroma2.sag.kelp.learningalgorithm.classification.multiclassification

Class OneVsAllLearning

java.lang.Object

it.uniroma2.sag.kelp.learningalgorithm.classification.multiclassification.OneVsAllLearning

All Implemented Interfaces:

ClassificationLearningAlgorithm, LearningAlgorithm, MetaLearningAlgorithm

public class OneVsAllLearning
extends Object
implements ClassificationLearningAlgorithm, MetaLearningAlgorithm

It is a meta algorithm that operates applying a One-Vs-All strategy over the base learning algorithm which is intended to be a binary learner. The One-Vs-All strategy will learn N different classifiers, where N is the number of classes involved in the dataset. In this strategy each classifier is learned by considering in turn the examples of a single class as positives, while all the other examples are considered as negative.

NOTE: the base learning algorithm must provide a duplicate method which properly works

Author:

Giuseppe Castellucci, Simone Filice

Constructor Summary

Constructors

Constructor and Description
OneVsAllLearning()

Method Summary

Methods

Modifier and Type	Method and Description
OneVsAllLearning	duplicate() This method will duplicate the current Learning algorithm
LearningAlgorithm	getBaseAlgorithm() This method will return the base algorithm.
List<Label>	getLabels() Returns the labels to be learned applying a one-vs-all strategy
OneVsAllClassifier	getPredictionFunction() This method returns the learned PredictionFunction.
void	initialize()
void	initializeWithPredictionFunction(OneVsAllClassifier oneVsAllClassifier) Deprecated.
void	learn(Dataset dataset) This method will cause the meta-learning algorithm to learn N classifiers, where N is the number of classes in the dataset.
void	reset() This method will cause the reset of all the base algorithms
void	setBaseAlgorithm(LearningAlgorithm baseAlgorithm) This method will set the type of the base algorithms to be learned.
void	setLabels(List<Label> labels) Set the labels associated to this multi-classifier.
void	setPredictionFunction(PredictionFunction predictionFunction) Sets the predictionFunction learned during the training process.

Methods inherited from class java.lang.Object

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

Constructor Detail

OneVsAllLearning

public OneVsAllLearning()

Method Detail

setLabels

public void setLabels(List<Label> labels)

Set the labels associated to this multi-classifier.

Specified by:

setLabels in interface LearningAlgorithm

Parameters:

labels - the labels representing the concept to be learned

getLabels

public List<Label> getLabels()

Returns the labels to be learned applying a one-vs-all strategy

Specified by:

getLabels in interface LearningAlgorithm

Returns:

the labels to be learned

initialize

public void initialize()

initializeWithPredictionFunction

@Deprecated
public void initializeWithPredictionFunction(OneVsAllClassifier oneVsAllClassifier)

Deprecated.

learn

public void learn(Dataset dataset)

This method will cause the meta-learning algorithm to learn N classifiers, where N is the number of classes in the dataset.

Specified by:

learn in interface LearningAlgorithm

Parameters:

dataset - the training data

reset

public void reset()

This method will cause the reset of all the base algorithms

Specified by:

reset in interface LearningAlgorithm

getPredictionFunction

public OneVsAllClassifier getPredictionFunction()

This method returns the learned PredictionFunction. It is of type OneVsOneClassifier.

Specified by:

getPredictionFunction in interface ClassificationLearningAlgorithm

Specified by:

getPredictionFunction in interface LearningAlgorithm

Returns:

the predictionFunction learned during the training process

setBaseAlgorithm

public void setBaseAlgorithm(LearningAlgorithm baseAlgorithm)

This method will set the type of the base algorithms to be learned.

Specified by:

setBaseAlgorithm in interface MetaLearningAlgorithm

Parameters:

baseAlgorithm - the baseAlgorithm to set

getBaseAlgorithm

public LearningAlgorithm getBaseAlgorithm()

This method will return the base algorithm.

Specified by:

getBaseAlgorithm in interface MetaLearningAlgorithm

Returns:

the base algorithm

duplicate

public OneVsAllLearning duplicate()

This method will duplicate the current Learning algorithm

Specified by:

duplicate in interface LearningAlgorithm

setPredictionFunction

public void setPredictionFunction(PredictionFunction predictionFunction)

Description copied from interface: LearningAlgorithm

Sets the predictionFunction learned during the training process. It can be used to change the default prediction function, or to set an already trained one.

Specified by:

setPredictionFunction in interface LearningAlgorithm