org.HdrHistogram

Interface DoubleValueRecorder

All Known Implementing Classes:

ConcurrentDoubleHistogram, DoubleHistogram, DoubleRecorder, PackedConcurrentDoubleHistogram, PackedDoubleHistogram, SingleWriterDoubleRecorder, SynchronizedDoubleHistogram

public interface DoubleValueRecorder

Method Summary

Modifier and Type	Method and Description
void	recordValue(double value) Record a value
void	recordValueWithCount(double value, long count) Record a value (adding to the value's current count)
void	recordValueWithExpectedInterval(double value, double expectedIntervalBetweenValueSamples) Record a value.
void	reset() Reset the contents and collected stats

Method Detail

recordValue

void recordValue(double value)
          throws ArrayIndexOutOfBoundsException

Record a value

Parameters:

value - The value to be recorded

Throws:

ArrayIndexOutOfBoundsException - (may throw) if value cannot be covered by the histogram's range

recordValueWithCount

void recordValueWithCount(double value,
                          long count)
                   throws ArrayIndexOutOfBoundsException

Record a value (adding to the value's current count)

Parameters:

value - The value to be recorded

count - The number of occurrences of this value to record

Throws:

ArrayIndexOutOfBoundsException - (may throw) if value cannot be covered by the histogram's range

recordValueWithExpectedInterval

void recordValueWithExpectedInterval(double value,
                                     double expectedIntervalBetweenValueSamples)
                              throws ArrayIndexOutOfBoundsException

Record a value.

To compensate for the loss of sampled values when a recorded value is larger than the expected interval between value samples, will auto-generate an additional series of decreasingly-smaller (down to the expectedIntervalBetweenValueSamples) value records.

Note: This is a at-recording correction method, as opposed to the post-recording correction method provided by DoubleHistogram.copyCorrectedForCoordinatedOmission(double). The two methods are mutually exclusive, and only one of the two should be be used on a given data set to correct for the same coordinated omission issue.

Parameters:

value - The value to record

expectedIntervalBetweenValueSamples - If expectedIntervalBetweenValueSamples is larger than 0, add auto-generated value records as appropriate if value is larger than expectedIntervalBetweenValueSamples

Throws:

ArrayIndexOutOfBoundsException - (may throw) if value cannot be covered by the histogram's range

reset

void reset()

Reset the contents and collected stats