umontreal.iro.lecuyer.stat
Class TallyStore

java.lang.Object
  umontreal.iro.lecuyer.stat.StatProbe
      umontreal.iro.lecuyer.stat.Tally
          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(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.
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, sum, variance

Methods inherited from class umontreal.iro.lecuyer.stat.StatProbe

addObservationListener, clearObservationListeners, getName, isBroadcasting, isCollecting, max, min, notifyListeners, removeObservationListener, report, report, setBroadcasting, setCollecting, setName

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(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 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