de.jstacs.classifiers.assessment
Class ClassifierAssessmentAssessParameterSet

java.lang.Object
  extended by de.jstacs.parameters.ParameterSet
      extended by de.jstacs.classifiers.assessment.ClassifierAssessmentAssessParameterSet
All Implemented Interfaces:
GalaxyConvertible, Storable, Cloneable
Direct Known Subclasses:
KFoldCrossValidationAssessParameterSet, RepeatedHoldOutAssessParameterSet, RepeatedSubSamplingAssessParameterSet, Sampled_RepeatedHoldOutAssessParameterSet

public class ClassifierAssessmentAssessParameterSet
extends ParameterSet

This class is the superclass used by all ClassifierAssessmentAssessParameterSets. It is a container of user specified parameters that are necessary to define a run of an assess( ... )-method in a ClassifierAssessment instance.

It is recommended to extend this class for each subclass of ClassifierAssessment.

Author:
Andre Gohr (bioinf (nospam:.) ag (nospam:@) googlemail (nospam:.) com)
See Also:
ClassifierAssessment.assess(de.jstacs.classifiers.performanceMeasures.NumericalPerformanceMeasureParameterSet, ClassifierAssessmentAssessParameterSet, de.jstacs.data.DataSet...), ClassifierAssessment.assess(de.jstacs.classifiers.performanceMeasures.NumericalPerformanceMeasureParameterSet, ClassifierAssessmentAssessParameterSet, de.jstacs.utils.ProgressUpdater, de.jstacs.data.DataSet...)

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
ClassifierAssessmentAssessParameterSet()
          Constructs a new ClassifierAssessmentAssessParameterSet with empty parameter values.
ClassifierAssessmentAssessParameterSet(int elementLength, boolean exceptionIfMPNotComputable)
          Constructs a new ClassifierAssessmentAssessParameterSet with given parameter values.
ClassifierAssessmentAssessParameterSet(StringBuffer representation)
          The standard constructor for the interface Storable.
 
Method Summary
 Collection<Result> getAnnotation()
          Returns a Collection of parameters containing informations about this ClassifierAssessmentAssessParameterSet.
 int getElementLength()
          Returns the length of elements (sequences) defined by this ClassifierAssessmentAssessParameterSet.
 boolean getExceptionIfMPNotComputable()
          Returns the flag defined by this ClassifierAssessmentAssessParameterSet.
 boolean getStoreAll()
          Returns the flag for storing all performance measures in each iteration defined by this ClassifierAssessmentAssessParameterSet.
 void setStoreAll(boolean b)
          This method allows to set the switch for storing all individual performance measure values of each iteration of the ClassifierAssessment.
 
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

ClassifierAssessmentAssessParameterSet

public ClassifierAssessmentAssessParameterSet()
                                       throws UnsupportedOperationException
Constructs a new ClassifierAssessmentAssessParameterSet with empty parameter values.

Throws:
UnsupportedOperationException - if the ClassifierAssessmentAssessParameterSet could not be constructed or the parameters could not be loaded
See Also:
ParameterSet.ParameterSet()

ClassifierAssessmentAssessParameterSet

public ClassifierAssessmentAssessParameterSet(StringBuffer representation)
                                       throws NonParsableException
The standard constructor for the interface Storable. Constructs a ClassifierAssessmentAssessParameterSet out of its XML representation.

Parameters:
representation - the XML representation as StringBuffer
Throws:
NonParsableException - if the ClassifierAssessmentAssessParameterSet could not be reconstructed out of the XML representation (the StringBuffer representation could not be parsed)
See Also:
ParameterSet.ParameterSet(StringBuffer), Storable

ClassifierAssessmentAssessParameterSet

public ClassifierAssessmentAssessParameterSet(int elementLength,
                                              boolean exceptionIfMPNotComputable)
                                       throws SimpleParameter.IllegalValueException,
                                              UnsupportedOperationException
Constructs a new ClassifierAssessmentAssessParameterSet with given parameter values.

Parameters:
elementLength - defines the length of elements (sequences) the classifiers to be assessed are able to classify
exceptionIfMPNotComputable - A ClassifierAssessmentAssessParameterSet is used in combination with an AbstractPerformanceMeasure-object to call assess( ... )-methods of ClassifierAssessments. If exceptionIfMPNotComputable==true an Exception is thrown if a user selected measure parameters that could not be computed.
Throws:
SimpleParameter.IllegalValueException - is thrown in case of out-of-range or invalid given parameters
UnsupportedOperationException - if the ClassifierAssessmentAssessParameterSet could not be constructed or the parameters could not be loaded
See Also:
ParameterSet.ParameterSet()
Method Detail

getElementLength

public int getElementLength()
Returns the length of elements (sequences) defined by this ClassifierAssessmentAssessParameterSet.

Returns:
the element length defined by this ClassifierAssessmentAssessParameterSet

getExceptionIfMPNotComputable

public boolean getExceptionIfMPNotComputable()
Returns the flag defined by this ClassifierAssessmentAssessParameterSet.

Returns:
the flag defined by this ClassifierAssessmentAssessParameterSet (true : an exception is thrown if a user selected measure parameters that could not be computed, false: no exception is thrown)

getStoreAll

public boolean getStoreAll()
Returns the flag for storing all performance measures in each iteration defined by this ClassifierAssessmentAssessParameterSet.

Returns:
the flag defined by this ClassifierAssessmentAssessParameterSet (true: all performance measures in each iteration are stored separately, false: only values need for mean and standard error are stored)
See Also:
MeanResultSet.MeanResultSet(boolean, de.jstacs.results.SimpleResult...), MeanResultSet.getAllValues(int)

getAnnotation

public Collection<Result> getAnnotation()
Returns a Collection of parameters containing informations about this ClassifierAssessmentAssessParameterSet.

Returns:
a Collection of parameters containing informations about this ClassifierAssessmentAssessParameterSet

setStoreAll

public void setStoreAll(boolean b)
                 throws SimpleParameter.IllegalValueException
This method allows to set the switch for storing all individual performance measure values of each iteration of the ClassifierAssessment.

Parameters:
b - the value to be set
Throws:
SimpleParameter.IllegalValueException - if the parameter could not be set