de.jstacs.classifiers.assessment

Class ClassifierAssessmentAssessParameterSet

java.lang.Object

de.jstacs.parameters.ParameterSet

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

Constructors

Constructor and Description
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

Modifier and Type	Method and Description
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