SSJ
V. 2.6.

umontreal.iro.lecuyer.stat
Class TallyStore

java.lang.Object
  extended by umontreal.iro.lecuyer.stat.StatProbe
      extended by umontreal.iro.lecuyer.stat.Tally
          extended by umontreal.iro.lecuyer.stat.TallyStore
All Implemented Interfaces:
Cloneable

public class TallyStore
extends Tally

This class is a variant of Tally for which the individual observations are stored in a list implemented as a DoubleArrayList. The DoubleArrayList object used to store the values can be either passed to the constructor or created by the constructor, and can be accessed via the getDoubleArrayList method.

The same counters as in Tally are maintained and are used by the inherited methods. One must access the list of observations to compute quantities not supported by the methods in Tally, and/or to use methods provided by the COLT package.

Never add or remove observations directly on the DoubleArrayList object, because this would put the counters of the TallyStore object in an inconsistent state.

There are two potential reasons for using a TallyStore object instead of directly using a DoubleArrayList object: (a) it can broadcast observations and (b) it maintains a few additional counters that may speed up some operations such as computing the average.


Constructor Summary
TallyStore()
          Constructs a new TallyStore statistical probe.
TallyStore(cern.colt.list.DoubleArrayList a)
          Constructs a new TallyStore statistical probe with given associated array.
TallyStore(int capacity)
          Constructs a new TallyStore statistical probe with given initial capacity capacity for its associated array.
TallyStore(String name)
          Constructs a new TallyStore statistical probe with name name.
TallyStore(String name, int capacity)
          Constructs a new TallyStore statistical probe with name name and given initial capacity capacity for its associated array.
 
Method Summary
 void add(double x)
          Gives a new observation x to the statistical collector.
 TallyStore clone()
          Clones this object and the array which stores the observations.
 double covariance(TallyStore t2)
          Returns the sample covariance of the observations contained in this tally, and the other tally t2.
 double[] getArray()
          Returns the observations stored in this probe.
 cern.colt.list.DoubleArrayList getDoubleArrayList()
          Returns the DoubleArrayList object that contains the observations for this probe.
 void init()
          Initializes the statistical collector.
 void quickSort()
          Sorts the elements of this probe using the quicksort from Colt.
 String toString()
          Returns the observations stored in this object as a String.
 
Methods inherited from class umontreal.iro.lecuyer.stat.Tally
average, confidenceIntervalNormal, confidenceIntervalStudent, confidenceIntervalVarianceChi2, formatCINormal, formatCINormal, formatCIStudent, formatCIStudent, formatCIVarianceChi2, getConfidenceLevel, numberObs, report, report, reportAndCIStudent, reportAndCIStudent, setConfidenceIntervalNone, setConfidenceIntervalNormal, setConfidenceIntervalStudent, setConfidenceLevel, setShowNumberObs, shortReport, shortReportHeader, standardDeviation, variance
 
Methods inherited from class umontreal.iro.lecuyer.stat.StatProbe
addObservationListener, clearObservationListeners, getName, isBroadcasting, isCollecting, max, min, notifyListeners, removeObservationListener, report, report, setBroadcasting, setCollecting, setName, sum
 
Methods inherited from class java.lang.Object
equals, getClass, hashCode, notify, notifyAll, wait, wait, wait
 

Constructor Detail

TallyStore

public TallyStore()
Constructs a new TallyStore statistical probe.


TallyStore

public TallyStore(String name)
Constructs a new TallyStore statistical probe with name name.

Parameters:
name - the name of the tally.

TallyStore

public TallyStore(int capacity)
Constructs a new TallyStore statistical probe with given initial capacity capacity for its associated array.

Parameters:
capacity - initial capacity of the array of observations

TallyStore

public TallyStore(String name,
                  int capacity)
Constructs a new TallyStore statistical probe with name name and given initial capacity capacity for its associated array.

Parameters:
name - the name of the tally.
capacity - initial capacity of the array of observations

TallyStore

public TallyStore(cern.colt.list.DoubleArrayList a)
Constructs a new TallyStore statistical probe with given associated array. This array must be empty.

Parameters:
a - array that will contain observations
Method Detail

init

public void init()
Description copied from class: StatProbe
Initializes the statistical collector.

Overrides:
init in class Tally

add

public void add(double x)
Description copied from class: Tally
Gives a new observation x to the statistical collector. If broadcasting to observers is activated for this object, this method also transmits the new information to the registered observers by invoking the method notifyListeners.

Overrides:
add in class Tally
Parameters:
x - observation being added to this tally

getArray

public double[] getArray()
Returns the observations stored in this probe.

Returns:
the array of observations associated with this object

getDoubleArrayList

public cern.colt.list.DoubleArrayList getDoubleArrayList()
Returns the DoubleArrayList object that contains the observations for this probe. WARNING: In previous releases, this function was named getArray.

Returns:
the array of observations associated with this object

quickSort

public void quickSort()
Sorts the elements of this probe using the quicksort from Colt.


covariance

public double covariance(TallyStore t2)
Returns the sample covariance of the observations contained in this tally, and the other tally t2. Both tallies must have the same number of observations. This returns Double.NaN if the tallies do not contain the same number of observations, or if they contain less than two observations.

Parameters:
t2 - the other tally.
Returns:
the sample covariance.

clone

public TallyStore clone()
Clones this object and the array which stores the observations.

Overrides:
clone in class Tally

toString

public String toString()
Returns the observations stored in this object as a String.

Overrides:
toString in class Object

SSJ
V. 2.6.

To submit a bug or ask questions, send an e-mail to Pierre L'Ecuyer.