de.jstacs.classifiers.performanceMeasures
Class ConfusionMatrix

java.lang.Object
  de.jstacs.parameters.ParameterSet
      de.jstacs.classifiers.performanceMeasures.AbstractPerformanceMeasure
          de.jstacs.classifiers.performanceMeasures.ConfusionMatrix

All Implemented Interfaces:

PerformanceMeasure, GalaxyConvertible, Storable, Cloneable

public class ConfusionMatrix
extends AbstractPerformanceMeasure

This class implements the performance measure confusion matrix.

Author:

Jan Grau, Jens Keilwagen

Nested Class Summary

Nested classes/interfaces inherited from class de.jstacs.parameters.ParameterSet

ParameterSet.ParameterList

Field Summary

Fields inherited from class de.jstacs.parameters.ParameterSet

errorMessage, parameters, parent

Constructor Summary

ConfusionMatrix()
Constructs a new instance of the performance measure ConfusionMatrix.

ConfusionMatrix(StringBuffer xml)
The standard constructor for the interface Storable.

Method Summary

ResultSet	compute(double[][][] classSpecificScores, double[][] weights) This method allows to compute the performance measure of given class specific scores.
ResultSet	compute(double[] sortedScoresClass0, double[] weightClass0, double[] sortedScoresClass1, double[] weightClass1) This method allows to compute the performance measure of given sorted score ratios.
int	getAllowedNumberOfClasses() This method returns the allowed number of classes.
String	getName() The method returns the name of the performance measure.

Methods inherited from class de.jstacs.classifiers.performanceMeasures.AbstractPerformanceMeasure

compute, compute, findSplitIndex, findThreshold, getCollectionOfAllMeasures, getWeight, simpleWeights

Methods inherited from class de.jstacs.parameters.ParameterSet

clone, fromGalaxy, fromXML, getAllParameterNames, getComment, getComment, getErrorMessage, getIndex, getName, getName, getNumberOfParameters, getParameterAt, getParameterForName, getParent, hasDefaultOrIsSet, initParameterList, initParameterList, isAtomic, isComparable, parametersLoaded, reset, setParent, toGalaxy, toXML

Methods inherited from class java.lang.Object

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

Constructor Detail

ConfusionMatrix

public ConfusionMatrix()

Constructs a new instance of the performance measure ConfusionMatrix.

ConfusionMatrix

public ConfusionMatrix(StringBuffer xml)
                throws NonParsableException

The standard constructor for the interface Storable. Constructs a ConfusionMatrix out of an XML representation.

Parameters:

xml - the XML representation as StringBuffer

Throws:

NonParsableException - if the ConfusionMatrix could not be reconstructed out of the StringBuffer xml

Method Detail

compute

public ResultSet compute(double[] sortedScoresClass0,
                         double[] weightClass0,
                         double[] sortedScoresClass1,
                         double[] weightClass1)

Description copied from interface: PerformanceMeasure

This method allows to compute the performance measure of given sorted score ratios. This method can only be used for binary classifiers.

Parameters:

sortedScoresClass0 - the sorted score ratios of class 0

weightClass0 - the weights of the sequences of class 0 sorted along with the scores sortedScoresClass0

sortedScoresClass1 - the sorted score ratios of class 1

weightClass1 - the weights of the sequences of class 1 sorted along with the scores sortedScoresClass1

Returns:

a result set containing the results of the performance measure

See Also:

de.jstacs.utils.ToolBox#sortAlongWith(double[], double[]...)

compute

public ResultSet compute(double[][][] classSpecificScores,
                         double[][] weights)

Description copied from interface: PerformanceMeasure

This method allows to compute the performance measure of given class specific scores.

Parameters:

classSpecificScores - the scores; first dimension = data sets, second dimension = sequences of the data set, third dimension classes of the classifier

weights - the weights for all sequence in all data sets

Returns:

a result set containing the results of the performance measure

getAllowedNumberOfClasses

public int getAllowedNumberOfClasses()

Description copied from interface: PerformanceMeasure

This method returns the allowed number of classes. For many performance measures this number is fixed, e.g. for AUC-ROC the number is 2. If the number is not fixed the method returns 0, e.g. for the classification rate.

Returns:

the allowed number of classes

See Also:

AbstractClassifier.getNumberOfClasses()

getName

public String getName()

Description copied from interface: PerformanceMeasure

The method returns the name of the performance measure.

Specified by:

getName in interface PerformanceMeasure

Specified by:

getName in class AbstractPerformanceMeasure

Returns:

the name of the performance measure