de.jstacs.results
Class MeanResultSet

java.lang.Object
  de.jstacs.results.ResultSet
      de.jstacs.results.NumericalResultSet
          de.jstacs.results.MeanResultSet

All Implemented Interfaces:

Storable

public class MeanResultSet
extends NumericalResultSet

Class that computes the mean and the standard error of a series of NumericalResultSets. Each NumericalResultSet in the series must be added using the addResult(NumericalResult)-method. The means and the standard errors can be obtained by the getStatistics()-method.

Author:

Jan Grau, Jens Keilwagen

Nested Class Summary

static class	MeanResultSet.AdditionImpossibleException Class for the exception that is thrown if two MeanResultSet should be added that do not match.
static class	MeanResultSet.InconsistentResultNumberException Class for the exception that is thrown if an NumericalResultSet is added to the MeanResultSet that has a number of results which is not equal to the number of results of the previously added results.

Field Summary

Fields inherited from class de.jstacs.results.ResultSet

results

Constructor Summary

MeanResultSet()
Constructs a new MeanResultSet with an empty set of NumericalResultSets and no further information.

MeanResultSet(SimpleResult... infos)
Constructs a new MeanResultSet with an empty set of NumericalResultSets.

MeanResultSet(StringBuffer representation)
The constructor for a model in xml format.

Method Summary

static MeanResultSet	addResults(MeanResultSet r1, MeanResultSet r2) Adds two MeanResultsSets.
void	addResults(NumericalResultSet... rs) Adds NumericalResultSets to this MenResultSet.
protected void	fromXML(StringBuffer representation) Parses the contents of a ResultSet from its XML-representation as returned by ResultSet.toXML().
ResultSet	getInfos() Returns some information for this MeanResultSet.
NumericalResultSet	getStatistics() Returns the means and (if possible the) standard errors of the results in this MeanResultSet as a new NumericalResultSet.
StringBuffer	toXML() This method returns an XML-representation of an instance of the implementing class.

Methods inherited from class de.jstacs.results.NumericalResultSet

getResultAt

Methods inherited from class de.jstacs.results.ResultSet

findColumn, getNumberOfResults, getResults, toString

Methods inherited from class java.lang.Object

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

Constructor Detail

MeanResultSet

public MeanResultSet(SimpleResult... infos)

Constructs a new MeanResultSet with an empty set of NumericalResultSets.

Parameters:

infos - some information

MeanResultSet

public MeanResultSet()

Constructs a new MeanResultSet with an empty set of NumericalResultSets and no further information.

MeanResultSet

public MeanResultSet(StringBuffer representation)
              throws NonParsableException

The constructor for a model in xml format.

Parameters:

representation - the model in xml format

Throws:

NonParsableException - if the StringBuffer could not be parsed

Method Detail

toXML

public StringBuffer toXML()

Description copied from interface: Storable

This method returns an XML-representation of an instance of the implementing class.

Specified by:

toXML in interface Storable

Overrides:

toXML in class ResultSet

Returns:

the XML-representation

fromXML

protected void fromXML(StringBuffer representation)
                throws NonParsableException

Description copied from class: ResultSet

Parses the contents of a ResultSet from its XML-representation as returned by ResultSet.toXML().

Overrides:

fromXML in class ResultSet

Parameters:

representation - the XML-representation

Throws:

NonParsableException - is thrown if the XML-code could not be parsed

addResults

public static MeanResultSet addResults(MeanResultSet r1,
                                       MeanResultSet r2)
                                throws MeanResultSet.AdditionImpossibleException

Adds two MeanResultsSets.

Parameters:

r1 - one result

r2 - the other result

Returns:

the merged MeanResultSet

Throws:

MeanResultSet.AdditionImpossibleException - an AdditionImpossibleException is thrown if the Results does not match.

addResults

public void addResults(NumericalResultSet... rs)
                throws MeanResultSet.InconsistentResultNumberException,
                       SimpleParameter.IllegalValueException,
                       MeanResultSet.AdditionImpossibleException

Adds NumericalResultSets to this MenResultSet. The NumericalResultSets are handled as one result. So if you call this method with e.g. 3 arguments this is the same as adding one combing argument and not the same as calling the method 3-times each time with one argument.

Parameters:

rs - the NumericalResultSets

Throws:

MeanResultSet.InconsistentResultNumberException - if the number of results differ

SimpleParameter.IllegalValueException - if the new (merged) value could not be set

MeanResultSet.AdditionImpossibleException - if some results are not comparable (name, comment, type)

getStatistics

public NumericalResultSet getStatistics()

Returns the means and (if possible the) standard errors of the results in this MeanResultSet as a new NumericalResultSet.

Returns:

the means and (if possible the) standard errors

getInfos

public ResultSet getInfos()

Returns some information for this MeanResultSet.

Returns:

the information for this MeanResultSet