Parallel Colt 0.7.2

hep.aida.tfloat.bin
Class AbstractFloatBin1D

java.lang.Object
  extended by cern.colt.PersistentObject
      extended by hep.aida.tfloat.bin.AbstractFloatBin
          extended by hep.aida.tfloat.bin.AbstractFloatBin1D
All Implemented Interfaces:
FloatBufferConsumer, Serializable, Cloneable
Direct Known Subclasses:
StaticFloatBin1D

public abstract class AbstractFloatBin1D
extends AbstractFloatBin
implements FloatBufferConsumer

Abstract base class for all 1-dimensional bins consumes float elements. First see the package summary and javadoc tree view to get the broad picture.

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.

Version:
0.9, 03-Jul-99
Author:
wolfgang.hoschek@cern.ch
See Also:
Serialized Form

Field Summary
 
Fields inherited from class cern.colt.PersistentObject
serialVersionUID
 
Method Summary
abstract  void add(float element)
          Adds the specified element to the receiver.
 void addAllOf(FloatArrayList list)
          Adds all values of the specified list to the receiver.
 void addAllOfFromTo(FloatArrayList list, int from, int to)
          Adds the part of the specified list between indexes from (inclusive) and to (inclusive) to the receiver.
 FloatBuffer buffered(int capacity)
          Constructs and returns a streaming buffer connected to the receiver.
 String compareWith(AbstractFloatBin1D other)
          Computes the deviations from the receiver's measures to another bin's measures.
 boolean equals(Object object)
          Returns whether two bins are equal; They are equal if the other object is of the same class or a subclass of this class and both have the same size, minimum, maximum, sum and sumOfSquares.
abstract  float max()
          Returns the maximum.
 float mean()
          Returns the arithmetic mean, which is Sum( x[i] ) / size().
abstract  float min()
          Returns the minimum.
 float rms()
          Returns the rms (Root Mean Square), which is Math.sqrt( Sum( x[i]*x[i] ) / size() ).
 float standardDeviation()
          Returns the sample standard deviation, which is Math.sqrt(variance()).
 float standardError()
          Returns the sample standard error, which is Math.sqrt(variance() / size())
abstract  float sum()
          Returns the sum of all elements, which is Sum( x[i] ).
abstract  float sumOfSquares()
          Returns the sum of squares, which is Sum( x[i] * x[i] ).
 String toString()
          Returns a String representation of the receiver.
 void trimToSize()
          Trims the capacity of the receiver to be the receiver's current size.
 float variance()
          Returns the sample variance, which is Sum( (x[i]-mean())2 ) / (size()-1).
 
Methods inherited from class hep.aida.tfloat.bin.AbstractFloatBin
center, center, clear, error, error, isRebinnable, offset, offset, size, value, value
 
Methods inherited from class cern.colt.PersistentObject
clone
 
Methods inherited from class java.lang.Object
getClass, hashCode, notify, notifyAll, wait, wait, wait
 

Method Detail

add

public abstract void add(float element)
Adds the specified element to the receiver.

Parameters:
element - element to be appended.

addAllOf

public final void addAllOf(FloatArrayList list)
Adds all values of the specified list to the receiver.

Specified by:
addAllOf in interface FloatBufferConsumer
Parameters:
list - the list of which all values shall be added.

addAllOfFromTo

public void addAllOfFromTo(FloatArrayList list,
                           int from,
                           int to)
Adds the part of the specified list between indexes from (inclusive) and to (inclusive) to the receiver. You may want to override this method for performance reasons.

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:
IndexOutOfBoundsException - if list.size()>0 && (from<0 || from>to || to>=list.size()) .

buffered

public FloatBuffer buffered(int capacity)
Constructs and returns a streaming buffer connected to the receiver. Whenever the buffer is full it's contents are automatically flushed to this. (Addding elements via a buffer to a bin is significantly faster than adding them directly.)

Parameters:
capacity - the number of elements the buffer shall be capable of holding before overflowing and flushing to the receiver.
Returns:
a streaming buffer having the receiver as target.

compareWith

public String compareWith(AbstractFloatBin1D other)
Computes the deviations from the receiver's measures to another bin's measures.

Parameters:
other - the other bin to compare with
Returns:
a summary of the deviations.

equals

public boolean equals(Object object)
Returns whether two bins are equal; They are equal if the other object is of the same class or a subclass of this class and both have the same size, minimum, maximum, sum and sumOfSquares.

Overrides:
equals in class AbstractFloatBin

max

public abstract float max()
Returns the maximum.


mean

public float mean()
Returns the arithmetic mean, which is Sum( x[i] ) / size().


min

public abstract float min()
Returns the minimum.


rms

public float rms()
Returns the rms (Root Mean Square), which is Math.sqrt( Sum( x[i]*x[i] ) / size() ).


standardDeviation

public float standardDeviation()
Returns the sample standard deviation, which is Math.sqrt(variance()).


standardError

public float standardError()
Returns the sample standard error, which is Math.sqrt(variance() / size())


sum

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


sumOfSquares

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


toString

public String toString()
Returns a String representation of the receiver.

Overrides:
toString in class AbstractFloatBin

trimToSize

public void trimToSize()
Trims the capacity of the receiver to be the receiver's current size. Releases any superfluos internal memory. An application can use this operation to minimize the storage of the receiver. This default implementation does nothing.

Overrides:
trimToSize in class AbstractFloatBin

variance

public float variance()
Returns the sample variance, which is Sum( (x[i]-mean())2 ) / (size()-1).


Parallel Colt 0.7.2

Jump to the Parallel Colt Homepage