hep.aida.tdouble.bin

Class StaticDoubleBin1D

java.lang.Object

cern.colt.PersistentObject

hep.aida.tdouble.bin.AbstractDoubleBin

hep.aida.tdouble.bin.AbstractDoubleBin1D

hep.aida.tdouble.bin.StaticDoubleBin1D

All Implemented Interfaces:

DoubleBufferConsumer, java.io.Serializable, java.lang.Cloneable

Direct Known Subclasses:

MightyStaticDoubleBin1D

public class StaticDoubleBin1D
extends AbstractDoubleBin1D

1-dimensional non-rebinnable bin consuming double elements; Efficiently computes basic statistics of data sequences. First see the package summary and javadoc tree view to get the broad picture.

The data streamed into a SimpleBin1D is not preserved! As a consequence infinitely many elements can be added to this bin. As a further consequence this bin cannot compute more than basic statistics. It is also not rebinnable. If these drawbacks matter, consider to use a DynamicDoubleBin1D, which overcomes them at the expense of increased memory requirements.

This class is fully thread safe (all public methods are synchronized). Thus, you can have one or more threads adding to the bin as well as one or more threads reading and viewing the statistics of the bin while it is filled. For high performance, add data in large chunks (buffers) via method addAllOf rather than piecewise via method add.

Implementation: Incremental maintainance. Performance linear in the number of elements added.

See Also:

Serialized Form

Constructor Summary

Constructors

Constructor and Description
StaticDoubleBin1D() Constructs and returns an empty bin.

Method Summary

Modifier and Type	Method and Description
void	add(double element) Adds the specified element to the receiver.
void	addAllOfFromTo(DoubleArrayList list, int from, int to) Adds the part of the specified list between indexes from (inclusive) and to (inclusive) to the receiver.
void	clear() Removes all elements from the receiver.
boolean	isRebinnable() Returns false.
double	max() Returns the maximum.
double	min() Returns the minimum.
int	size() Returns the number of elements contained in the receiver.
double	sum() Returns the sum of all elements, which is Sum( x[i] ).
double	sumOfSquares() Returns the sum of squares, which is Sum( x[i] * x[i] ).

Methods inherited from class hep.aida.tdouble.bin.AbstractDoubleBin1D

addAllOf, buffered, compareWith, equals, mean, rms, standardDeviation, standardError, toString, trimToSize, variance

Methods inherited from class hep.aida.tdouble.bin.AbstractDoubleBin

center, center, error, error, offset, offset, value, value

Methods inherited from class cern.colt.PersistentObject

clone

Methods inherited from class java.lang.Object

getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Detail

StaticDoubleBin1D

public StaticDoubleBin1D()

Constructs and returns an empty bin.

Method Detail

add

public void add(double element)

Adds the specified element to the receiver.

Specified by:

add in class AbstractDoubleBin1D

Parameters:

element - element to be appended.

addAllOfFromTo

public void addAllOfFromTo(DoubleArrayList list,
                           int from,
                           int to)

Adds the part of the specified list between indexes from (inclusive) and to (inclusive) to the receiver.

Overrides:

addAllOfFromTo in class AbstractDoubleBin1D

Parameters:

list - the list of which elements shall be added.

from - the index of the first element to be added (inclusive).

to - the index of the last element to be added (inclusive).

Throws:

java.lang.IndexOutOfBoundsException - if list.size()>0 && (from<0 || from>to || to>=list.size()) .

clear

public void clear()

Removes all elements from the receiver. The receiver will be empty after this call returns.

Specified by:

clear in class AbstractDoubleBin

isRebinnable

public boolean isRebinnable()

Returns false. Returns whether a client can obtain all elements added to the receiver. In other words, tells whether the receiver internally preserves all added elements. If the receiver is rebinnable, the elements can be obtained via elements() methods.

Specified by:

isRebinnable in class AbstractDoubleBin

max

public double max()

Returns the maximum.

Specified by:

max in class AbstractDoubleBin1D

min

public double min()

Returns the minimum.

Specified by:

min in class AbstractDoubleBin1D

size

public int size()

Returns the number of elements contained in the receiver.

Specified by:

size in class AbstractDoubleBin

Returns:

the number of elements contained in the receiver.

sum

public double sum()

Returns the sum of all elements, which is Sum( x[i] ).

Specified by:

sum in class AbstractDoubleBin1D

sumOfSquares

public double sumOfSquares()

Returns the sum of squares, which is Sum( x[i] * x[i] ).

Specified by:

sumOfSquares in class AbstractDoubleBin1D