emolib.classifier.machinelearning
Class SupportVectorMachine

java.lang.Object
  emolib.util.proc.TextDataProcessor
      emolib.classifier.Classifier
          emolib.classifier.machinelearning.SupportVectorMachine

All Implemented Interfaces:

Configurable, DataProcessor

public class SupportVectorMachine
extends Classifier

The SupportVectorMachine class is a SVM classifier.

It is a large-margin discriminative approach that searches the hyperplane (decision surface in feature space) that is maximally distant from the class-wise data points. Since the SVM is a dichotomous classifier, a multicategorisation strategy has to be considered to deal with the three sentiment classes. SVM is tentatively believed to be superior with respect to other methods in situations with (enough) few training data.

The core implementation of this SVM is based on Weka's Sequential Minimal Optimisation (SMO) algorithm. Multi-class problems are solved using pairwise classification. The same term weighting schemes as the ones used in the ARN-R are considered.

Author:

Alexandre Trilla (atrilla@salle.url.edu)

See Also:

ARNReduced

Constructor Summary

SupportVectorMachine()
Main constructor of this SVM classifier.

Method Summary

java.lang.String	getCategory(FeatureBox inputFeatures) The function that decides the most appropriate emotional category.
void	load(java.lang.String path) Generic function to load a previously saved classifier.
void	resetExamples() Method to reset the classifier and flush the training examples.
void	save(java.lang.String path) Generic method to save the fully fledged classifier into a given file path.
void	setChi2(boolean chi, int numF) Set the Chi square feature selection.
void	setCOF(boolean cof) Method to consider bigram frequencies.
void	setEmotionDims(boolean emodims) Method to consider emotion dimensions.
void	setExponent(double expo) Method to set the exponent of the polynomial kernel.
void	setIntercept(boolean intercept) Method to consider the intercept feature.
void	setLowerOrderTerms(boolean lot) Method to set the use of lower terms in the kernel.
void	setMI(boolean mi, int numF) Set the Mutual Information feature selection.
void	setNegation(boolean neg) Method to consider negations.
void	setNormalisedPolyK(boolean npk) Method to use the Normalized Polynomial kernel.
void	setPOS(boolean pos) Method to consider POS tags.
void	setRBF(boolean flag) Method to use the Radial Basis Function kernel.
void	setStemming(boolean stems) Method to consider stems.
void	setSynonyms(boolean syns) Method to consider synonyms.
void	setTermWeighingMeasure(java.lang.String twm) Method to set the TW method.
void	setTF(boolean tf, int numF) Set the Term Frequency feature selection.
void	simpleClassification() Functionality test.
void	trainingProcedure() Training method based on the Stochastic Gradient Descent.

Methods inherited from class emolib.classifier.Classifier

applyClassification, getData, getListOfExampleCategories, getListOfExampleFeatures, initialize, inputTrainingExample, newProperties, register, train

Methods inherited from class emolib.util.proc.TextDataProcessor

flush, getName, getPredecessor, setPredecessor, toString

Methods inherited from class java.lang.Object

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

Constructor Detail

SupportVectorMachine

public SupportVectorMachine()

Main constructor of this SVM classifier.

Method Detail

getCategory

public java.lang.String getCategory(FeatureBox inputFeatures)

Description copied from class: Classifier

The function that decides the most appropriate emotional category. This is required for any classifier. The classifier in question has to previously run any training algorithm in order to provide the required prediction.

Specified by:

getCategory in class Classifier

Parameters:

inputFeatures - The input emotional features.

Returns:

The most appropriate emotional category.

trainingProcedure

public void trainingProcedure()

Training method based on the Stochastic Gradient Descent.

Specified by:

trainingProcedure in class Classifier

setExponent

public void setExponent(double expo)

Method to set the exponent of the polynomial kernel.

Parameters:

expo - The exponent.

setLowerOrderTerms

public void setLowerOrderTerms(boolean lot)

Method to set the use of lower terms in the kernel.

Parameters:

lot - The lower order terms.

setMI

public void setMI(boolean mi,
                  int numF)

Set the Mutual Information feature selection.

Parameters:

mi - The Mutual Information flag.

numF - The number of relevant features desired.

setChi2

public void setChi2(boolean chi,
                    int numF)

Set the Chi square feature selection.

Parameters:

chi - The Chi2 flag.

numF - The number of relevant features desired.

setTF

public void setTF(boolean tf,
                  int numF)

Set the Term Frequency feature selection.

Parameters:

tf - The Term Frequency flag.

numF - The number of relevant features desired.

setNormalisedPolyK

public void setNormalisedPolyK(boolean npk)

Method to use the Normalized Polynomial kernel.

Parameters:

npk - Set the NPK.

setRBF

public void setRBF(boolean flag)

Method to use the Radial Basis Function kernel.

Parameters:

flag - Set the RBF.

setTermWeighingMeasure

public void setTermWeighingMeasure(java.lang.String twm)

Method to set the TW method.

Parameters:

twm - The TW method.

setCOF

public void setCOF(boolean cof)

Method to consider bigram frequencies.

Parameters:

cof - The COF flag.

setPOS

public void setPOS(boolean pos)

Method to consider POS tags.

Parameters:

pos - The POS flag.

setStemming

public void setStemming(boolean stems)

Method to consider stems.

Parameters:

stems - The stemming flag.

setIntercept

public void setIntercept(boolean intercept)

Method to consider the intercept feature.

Parameters:

intercept - The intercept flag.

setSynonyms

public void setSynonyms(boolean syns)

Method to consider synonyms.

Parameters:

syns - The synonyms flag.

setEmotionDims

public void setEmotionDims(boolean emodims)

Method to consider emotion dimensions.

Parameters:

emodims - The emotion dimensions flag.

setNegation

public void setNegation(boolean neg)

Method to consider negations.

Parameters:

neg - The negation flag.

save

public void save(java.lang.String path)

Description copied from class: Classifier

Generic method to save the fully fledged classifier into a given file path. It is recommended to use a plain text file (such as XML) to save the classifier's configuration since it's readable directly.

Specified by:

save in class Classifier

Parameters:

path - The file path to save the classifier.

load

public void load(java.lang.String path)

Description copied from class: Classifier

Generic function to load a previously saved classifier. This function should be consistent with the design followed in the saving procedure.

Specified by:

load in class Classifier

Parameters:

path - The path of the file which contains the previously saved classifier.

resetExamples

public void resetExamples()

Description copied from class: Classifier

Method to reset the classifier and flush the training examples. This method only makes sense if the classifier in question is trainable and already has some training examples.

Overrides:

resetExamples in class Classifier

simpleClassification

public void simpleClassification()

Functionality test.