de.jstacs.classifiers.performanceMeasures
Class AbstractNumericalTwoClassPerformanceMeasure

java.lang.Object
  extended by de.jstacs.parameters.ParameterSet
      extended by de.jstacs.classifiers.performanceMeasures.AbstractPerformanceMeasure
          extended by de.jstacs.classifiers.performanceMeasures.AbstractTwoClassPerformanceMeasure
              extended by de.jstacs.classifiers.performanceMeasures.AbstractNumericalTwoClassPerformanceMeasure
All Implemented Interfaces:
NumericalPerformanceMeasure, PerformanceMeasure, GalaxyConvertible, Storable, Cloneable
Direct Known Subclasses:
FalsePositiveRateForFixedSensitivity, MaximumNumericalTwoClassMeasure, PositivePredictiveValueForFixedSensitivity, SensitivityForFixedSpecificity

public abstract class AbstractNumericalTwoClassPerformanceMeasure
extends AbstractTwoClassPerformanceMeasure
implements NumericalPerformanceMeasure

This class is the abstract super class of any performance measure that can only be computed for binary classifiers.

Author:
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
protected AbstractNumericalTwoClassPerformanceMeasure()
          Constructs a new AbstractNumericalTwoClassPerformanceMeasure with empty parameter values.
protected AbstractNumericalTwoClassPerformanceMeasure(StringBuffer xml)
          The standard constructor for the interface Storable.
 
Method Summary
 NumericalResultSet compute(double[][][] classSpecificScores)
          This method allows to compute the performance measure of given class specific scores.
 NumericalResultSet compute(double[][][] classSpecificScores, double[][] weights)
          This method allows to compute the performance measure of given class specific scores.
 NumericalResultSet compute(double[] sortedScoresClass0, double[] sortedScoresClass1)
          This method allows to compute the performance measure of given sorted score ratios.
abstract  NumericalResultSet compute(double[] sortedScoresClass0, double[] weightClass0, double[] sortedScoresClass1, double[] weightsClass1)
          This method allows to compute the performance measure of given sorted score ratios.
 
Methods inherited from class de.jstacs.classifiers.performanceMeasures.AbstractTwoClassPerformanceMeasure
getAllowedNumberOfClasses
 
Methods inherited from class de.jstacs.classifiers.performanceMeasures.AbstractPerformanceMeasure
findSplitIndex, findThreshold, getCollectionOfAllMeasures, getName, 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
 
Methods inherited from interface de.jstacs.classifiers.performanceMeasures.PerformanceMeasure
getAllowedNumberOfClasses, getName
 

Constructor Detail

AbstractNumericalTwoClassPerformanceMeasure

protected AbstractNumericalTwoClassPerformanceMeasure()
Constructs a new AbstractNumericalTwoClassPerformanceMeasure with empty parameter values.


AbstractNumericalTwoClassPerformanceMeasure

protected AbstractNumericalTwoClassPerformanceMeasure(StringBuffer xml)
                                               throws NonParsableException
The standard constructor for the interface Storable. Constructs a AbstractNumericalTwoClassPerformanceMeasure out of an XML representation.

Parameters:
xml - the XML representation as StringBuffer
Throws:
NonParsableException - if the AbstractNumericalTwoClassPerformanceMeasure could not be reconstructed out of the StringBuffer xml
Method Detail

compute

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

Specified by:
compute in interface NumericalPerformanceMeasure
Specified by:
compute in interface PerformanceMeasure
Overrides:
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
See Also:
PerformanceMeasure.compute(double[][][], double[][])

compute

public final NumericalResultSet compute(double[][][] classSpecificScores,
                                        double[][] weights)
Description copied from interface: PerformanceMeasure
This method allows to compute the performance measure of given class specific scores.

Specified by:
compute in interface NumericalPerformanceMeasure
Specified by:
compute in interface PerformanceMeasure
Overrides:
compute in class AbstractTwoClassPerformanceMeasure
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

compute

public final NumericalResultSet compute(double[] sortedScoresClass0,
                                        double[] sortedScoresClass1)
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.

Specified by:
compute in interface NumericalPerformanceMeasure
Specified by:
compute in interface PerformanceMeasure
Overrides:
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:
PerformanceMeasure.compute(double[], double[], double[], double[])

compute

public abstract NumericalResultSet compute(double[] sortedScoresClass0,
                                           double[] weightClass0,
                                           double[] sortedScoresClass1,
                                           double[] weightsClass1)
Description copied from interface: NumericalPerformanceMeasure
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 interface NumericalPerformanceMeasure
Specified by:
compute in interface PerformanceMeasure
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
weightsClass1 - 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[]...)