de.jstacs.results
Class MeanResultSet

java.lang.Object
  extended by de.jstacs.results.ResultSet
      extended by de.jstacs.results.NumericalResultSet
          extended by 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