de.jstacs.classifiers.performanceMeasures
Class ConfusionMatrix

java.lang.Object
  extended by de.jstacs.parameters.ParameterSet
      extended by de.jstacs.classifiers.performanceMeasures.AbstractPerformanceMeasure
          extended by de.jstacs.classifiers.performanceMeasures.ConfusionMatrix
All Implemented Interfaces:
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)
          This method allows to compute the performance measure of given class specific scores.
 ResultSet compute(double[] sortedScoresClass0, double[] sortedScoresClass1)
          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
getCollectionOfAllMeasures
 
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[] sortedScoresClass1)
Description copied from class: AbstractPerformanceMeasure
This method allows to compute the performance measure of given sorted score ratios. This method can only be used for binary classifiers.

Specified by:
compute in class AbstractPerformanceMeasure
Parameters:
sortedScoresClass0 - the sorted score ratios of class 0
sortedScoresClass1 - the sorted score ratios of class 1
Returns:
a result set containing the results of the performance measure
See Also:
Arrays.sort(double[])

compute

public ResultSet compute(double[][][] classSpecificScores)
Description copied from class: AbstractPerformanceMeasure
This method allows to compute the performance measure of given class specific scores.

Specified by:
compute in class AbstractPerformanceMeasure
Parameters:
classSpecificScores - the scores; first dimension = data sets, second dimension = sequences of the data set, third dimension classes of the classifier
Returns:
a result set containing the results of the performance measure

getAllowedNumberOfClasses

public int getAllowedNumberOfClasses()
Description copied from class: AbstractPerformanceMeasure
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.

Specified by:
getAllowedNumberOfClasses in class AbstractPerformanceMeasure
Returns:
the allowed number of classes
See Also:
AbstractClassifier.getNumberOfClasses()

getName

public String getName()
Description copied from class: AbstractPerformanceMeasure
The method returns the name of the performance measure.

Specified by:
getName in class AbstractPerformanceMeasure
Returns:
the name of the performance measure