org.jlab.coda.emu.support.data

Class Statistics

java.lang.Object

org.jlab.coda.emu.support.data.Statistics

public final class Statistics
extends java.lang.Object

This class keeps some statistics on time to build an event.

Author:

timmer (10/24/14)

Constructor Summary

Constructors

Constructor and Description
Statistics(int window) Constructor.
Statistics(int window, int binCount) Constructor.
Statistics(int window, int binCount, int binSize) Constructor.

Method Summary

Modifier and Type	Method and Description
void	addValue(int val) Method to add data point.
int[]	fillHistogram() Fill the histogram integer array with data points.
int[]	getHistogram() Method to get the histogram array of ints.
void	printBuildTimeHistogram(java.lang.String label, java.lang.String units) Print out a histogram of data points.

Methods inherited from class java.lang.Object

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

Constructor Detail

Statistics

public Statistics(int window)

Constructor. As new values are added to data and their total number exceeds "window", old points are deleted. Use 40 histogram bins. Size of each bin is determined automatically by dividing the range ( (5*mean) minus the number rounded to nearest 100 which is less than the min data point) by the number of bins.

Parameters:

window - max number of data points to hold at once.

Statistics

public Statistics(int window,
                  int binCount)

Constructor. As new values are added to data and their total number exceeds "window", old points are deleted. Size of each bin is determined automatically by dividing the range ( (5*mean) minus the number rounded to nearest 100 which is less than the min data point) by the number of bins.

Parameters:

window - max number of data points to hold at once.

binCount - number of histogram bins.

Statistics

public Statistics(int window,
                  int binCount,
                  int binSize)

Constructor. As new values are added to data and their total number exceeds "window", old points are deleted.

Parameters:

window - max number of data points to hold at once.

binCount - number of histogram bins.

binSize - size of each histogram bin.

Method Detail

getHistogram

public int[] getHistogram()

Method to get the histogram array of ints. It contains metadata before the actual data:

1. The 1st element contains the bin size.

2. The 2nd element contains the first bin's starting value

3. The 3rd element contains the data's mean value

4. The 4rd element contains the data's minimum value

5. The 5rd element contains the data's maximum value

The rest of the array contains the histogram itself.

Returns:

histogram

addValue

public void addValue(int val)

Method to add data point.

Parameters:

val - data to add

fillHistogram

public int[] fillHistogram()

Fill the histogram integer array with data points. Only data points with a value < 5*mean are used.

Returns:

histogram just filled

printBuildTimeHistogram

public void printBuildTimeHistogram(java.lang.String label,
                                    java.lang.String units)

Print out a histogram of data points. Only data points of value < 5*mean are used.

Parameters:

label - header string to print.

units - unit string to print.