|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Objectcom.lmax.disruptor.collections.Histogram
public final class Histogram
Histogram for tracking the frequency of observations of values below interval upper bounds. This class is useful for recording timings in nanoseconds across a large number of observations when high performance is required.
Constructor Summary | |
---|---|
Histogram(long[] upperBounds)
Create a new Histogram with a provided list of interval bounds. |
Method Summary | |
---|---|
boolean |
addObservation(long value)
Add an observation to the histogram and increment the counter for the interval it matches. |
void |
addObservations(Histogram histogram)
Add observations from another Histogram into this one. |
void |
clear()
Clear the list of interval counters. |
long |
getCount()
Count total number of recorded observations. |
long |
getCountAt(int index)
Get the count of observations at a given index. |
long |
getFourNinesUpperBound()
Calculate the upper bound within which 99.99% of observations fall. |
long |
getMax()
Get the maximum observed value. |
java.math.BigDecimal |
getMean()
Calculate the mean of all recorded observations. |
long |
getMin()
Get the minimum observed value. |
int |
getSize()
Size of the list of interval bars. |
long |
getTwoNinesUpperBound()
Calculate the upper bound within which 99% of observations fall. |
long |
getUpperBoundAt(int index)
Get the upper bound of an interval for an index. |
long |
getUpperBoundForFactor(double factor)
Get the interval upper bound for a given factor of the observation population. |
java.lang.String |
toString()
|
Methods inherited from class java.lang.Object |
---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait |
Constructor Detail |
---|
public Histogram(long[] upperBounds)
upperBounds
- of the intervals.Method Detail |
---|
public int getSize()
public long getUpperBoundAt(int index)
index
- of the upper bound.
public long getCountAt(int index)
index
- of the observations counter.
public boolean addObservation(long value)
value
- for the observation to be added.
public void addObservations(Histogram histogram)
histogram
- from which to add the observation counts.public void clear()
public long getCount()
public long getMin()
public long getMax()
public java.math.BigDecimal getMean()
public long getTwoNinesUpperBound()
public long getFourNinesUpperBound()
public long getUpperBoundForFactor(double factor)
factor
- representing the size of the population.
public java.lang.String toString()
toString
in class java.lang.Object
|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |