Top Description Fields Constructors Methods
org.HdrHistogram

public Class ShortCountsHistogram

extends AbstractHistogram
Class Inheritance
Imports
java.io.IOException, .ObjectInputStream, java.nio.ByteBuffer, java.util.Arrays, java.util.zip.DataFormatException

A High Dynamic Range (HDR) Histogram using a short count type

See package description for org.HdrHistogram for details.

Field Summary

Modifier and TypeField and Description
pack-priv short[]
pack-priv int
pack-priv long
Inherited from org.HdrHistogram.AbstractHistogram:
leadingZeroCountBasemaxValueminNonZeroValuesubBucketHalfCountsubBucketHalfCountMagnitudesubBucketMaskunitMagnitudeunitMagnitudeMask

Constructor Summary

AccessConstructor and Description
public
ShortCountsHistogram(final int
Specifies the precision to use. This is the number of significant decimal digits to which the histogram will maintain value resolution and separation. Must be a non-negative integer between 0 and 5.
numberOfSignificantValueDigits
)

Construct an auto-resizing ShortCountsHistogram with a lowest discernible value of 1 and an auto-adjusting highestTrackableValue.

public
ShortCountsHistogram(final long
The highest value to be tracked by the histogram. Must be a positive integer that is >= 2.
highestTrackableValue
,
final int
Specifies the precision to use. This is the number of significant decimal digits to which the histogram will maintain value resolution and separation. Must be a non-negative integer between 0 and 5.
numberOfSignificantValueDigits
)

Construct a ShortCountsHistogram given the Highest value to be tracked and a number of significant decimal digits.

public
ShortCountsHistogram(final long
The lowest value that can be tracked (distinguished from 0) by the histogram. Must be a positive integer that is >= 1. May be internally rounded down to nearest power of 2.
lowestDiscernibleValue
,
final long
The highest value to be tracked by the histogram. Must be a positive integer that is >= (2 * lowestDiscernibleValue).
highestTrackableValue
,
final int
Specifies the precision to use. This is the number of significant decimal digits to which the histogram will maintain value resolution and separation. Must be a non-negative integer between 0 and 5.
numberOfSignificantValueDigits
)

Construct a ShortCountsHistogram given the Lowest and Highest values to be tracked and a number of significant decimal digits.

public
ShortCountsHistogram(final AbstractHistogram
The source histogram to duplicate
source
)

Construct a histogram with the same range settings as a given source histogram, duplicating the source's start/end timestamps (but NOT it's contents)

Method Summary

Modifier and TypeMethod and Description
pack-priv int
pack-priv void
addToCountAtIndex(final int index, final long value)

Implements abstract org.HdrHistogram.AbstractHistogram.addToCountAtIndex.

pack-priv void
pack-priv void
public ShortCountsHistogram
copy()

Implements abstract org.HdrHistogram.AbstractHistogram.copy.

Create a copy of this histogram, complete with data and everything.
public ShortCountsHistogram
copyCorrectedForCoordinatedOmission(final long
If expectedIntervalBetweenValueSamples is larger than 0, add auto-generated value records as appropriate if value is larger than expectedIntervalBetweenValueSamples
expectedIntervalBetweenValueSamples
)

Implements abstract org.HdrHistogram.AbstractHistogram.copyCorrectedForCoordinatedOmission.

Get a copy of this histogram, corrected for coordinated omission.
public static ShortCountsHistogram

Returns:

The newly constructed histogram
decodeFromByteBuffer
(final ByteBuffer
The buffer to decode from
buffer
,
final long
Force highestTrackableValue to be set at least this high
minBarForHighestTrackableValue
)

Construct a new histogram by decoding it from a ByteBuffer.

public static ShortCountsHistogram

Returns:

The newly constructed histogram
decodeFromCompressedByteBuffer
(final ByteBuffer
The buffer to decode from
buffer
,
final long
Force highestTrackableValue to be set at least this high
minBarForHighestTrackableValue
)

Hides org.HdrHistogram.EncodableHistogram.decodeFromCompressedByteBuffer.

Construct a new histogram by decoding it from a compressed form in a ByteBuffer.
public static ShortCountsHistogram

Returns:

A ShortCountsHistogram decoded from the string
fromString
(final String
A string containing a base64 encoding of a compressed histogram
base64CompressedHistogramString
)

Construct a new ShortCountsHistogram by decoding it from a String containing a base64 encoded compressed histogram representation.

pack-priv long
pack-priv long
pack-priv int
public long
getTotalCount()

Implements abstract org.HdrHistogram.AbstractHistogram.getTotalCount.

Get the total count of all recorded values in the histogram
pack-priv void
pack-priv void
private void
pack-priv void
resize(long newHighestTrackableValue)

Implements abstract org.HdrHistogram.AbstractHistogram.resize.

pack-priv void
setCountAtIndex(int index, long value)

Implements abstract org.HdrHistogram.AbstractHistogram.setCountAtIndex.

pack-priv void
pack-priv void
pack-priv void
pack-priv void
setTotalCount(final long totalCount)

Implements abstract org.HdrHistogram.AbstractHistogram.setTotalCount.

pack-priv void
shiftNormalizingIndexByOffset(int offsetToAdd, boolean lowestHalfBucketPopulated, double newIntegerToDoubleValueConversionRatio)

Implements abstract org.HdrHistogram.AbstractHistogram.shiftNormalizingIndexByOffset.

Inherited from org.HdrHistogram.AbstractHistogram:
addaddWhileCorrectingForCoordinatedOmissionallValuescopyIntocopyIntoCorrectedForCoordinatedOmissioncountsArrayIndexdecodeFromByteBufferdecodeFromCompressedByteBufferdetermineArrayLengthNeededencodeIntoByteBufferencodeIntoCompressedByteBufferencodeIntoCompressedByteBufferequalsestablishInternalTackingValuesestablishInternalTackingValuesestablishSizefillBufferFromCountsArraygetBucketIndexgetBucketsNeededToCoverValuegetCountAtValuegetCountBetweenValuesgetEndTimeStampgetEstimatedFootprintInBytesgetHighestTrackableValuegetLengthForNumberOfBucketsgetLowestDiscernibleValuegetMaxValuegetMaxValueAsDoublegetMeangetMinNonZeroValuegetMinValuegetNeededByteBufferCapacitygetNeededByteBufferCapacitygetNeededPayloadByteBufferCapacitygetNeededV0PayloadByteBufferCapacitygetNumberOfSignificantValueDigitsgetPercentileAtOrBelowValuegetStartTimeStampgetStdDeviationgetSubBucketIndexgetTaggetValueAtPercentilehashCodehighestEquivalentValueisAutoResizelinearBucketValueslogarithmicBucketValueslowestEquivalentValuemedianEquivalentValuenextNonEquivalentValuenonConcurrentNormalizingIndexShiftnormalizeIndexnumberOfSubbucketsoutputPercentileDistributionoutputPercentileDistributionoutputPercentileDistributionpercentilesrecordConvertedDoubleValuerecordConvertedDoubleValueWithCountrecordedValuesrecordValuerecordValuerecordValueWithCountrecordValueWithExpectedIntervalresetsetAutoResizesetEndTimeStampsetStartTimeStampsetTagshiftValuesLeftshiftValuesLeftshiftValuesRightshiftValuesRightsizeOfEquivalentValueRangesubtractsupportsAutoResizetoStringupdateMinAndMaxvalueFromIndexvaluesAreEquivalent

Field Detail

countsback to summary
pack-priv short[] counts
normalizingIndexOffsetback to summary
pack-priv int normalizingIndexOffset
totalCountback to summary
pack-priv long totalCount

Constructor Detail

ShortCountsHistogramback to summary
public ShortCountsHistogram(final int numberOfSignificantValueDigits)

Construct an auto-resizing ShortCountsHistogram with a lowest discernible value of 1 and an auto-adjusting highestTrackableValue. Can auto-resize up to track values up to (Long.MAX_VALUE / 2).

Parameters
numberOfSignificantValueDigits:int

Specifies the precision to use. This is the number of significant decimal digits to which the histogram will maintain value resolution and separation. Must be a non-negative integer between 0 and 5.

ShortCountsHistogramback to summary
public ShortCountsHistogram(final long highestTrackableValue, final int numberOfSignificantValueDigits)

Construct a ShortCountsHistogram given the Highest value to be tracked and a number of significant decimal digits. The histogram will be constructed to implicitly track (distinguish from 0) values as low as 1.

Parameters
highestTrackableValue:long

The highest value to be tracked by the histogram. Must be a positive integer that is >= 2.

numberOfSignificantValueDigits:int

Specifies the precision to use. This is the number of significant decimal digits to which the histogram will maintain value resolution and separation. Must be a non-negative integer between 0 and 5.

ShortCountsHistogramback to summary
public ShortCountsHistogram(final long lowestDiscernibleValue, final long highestTrackableValue, final int numberOfSignificantValueDigits)

Construct a ShortCountsHistogram given the Lowest and Highest values to be tracked and a number of significant decimal digits. Providing a lowestDiscernibleValue is useful is situations where the units used for the histogram's values are much smaller that the minimal accuracy required. E.g. when tracking time values stated in nanosecond units, where the minimal accuracy required is a microsecond, the proper value for lowestDiscernibleValue would be 1000.

Parameters
lowestDiscernibleValue:long

The lowest value that can be tracked (distinguished from 0) by the histogram. Must be a positive integer that is >= 1. May be internally rounded down to nearest power of 2.

highestTrackableValue:long

The highest value to be tracked by the histogram. Must be a positive integer that is >= (2 * lowestDiscernibleValue).

numberOfSignificantValueDigits:int

Specifies the precision to use. This is the number of significant decimal digits to which the histogram will maintain value resolution and separation. Must be a non-negative integer between 0 and 5.

ShortCountsHistogramback to summary
public ShortCountsHistogram(final AbstractHistogram source)

Construct a histogram with the same range settings as a given source histogram, duplicating the source's start/end timestamps (but NOT it's contents)

Parameters
source:AbstractHistogram

The source histogram to duplicate

Method Detail

_getEstimatedFootprintInBytesback to summary
pack-priv int _getEstimatedFootprintInBytes()

Implements abstract org.HdrHistogram.AbstractHistogram._getEstimatedFootprintInBytes.

Annotations
@Override
addToCountAtIndexback to summary
pack-priv void addToCountAtIndex(final int index, final long value)

Implements abstract org.HdrHistogram.AbstractHistogram.addToCountAtIndex.

Annotations
@Override
addToTotalCountback to summary
pack-priv void addToTotalCount(long value)

Implements abstract org.HdrHistogram.AbstractHistogram.addToTotalCount.

Annotations
@Override
clearCountsback to summary
pack-priv void clearCounts()

Implements abstract org.HdrHistogram.AbstractHistogram.clearCounts.

Annotations
@Override
copyback to summary
public ShortCountsHistogram copy()

Implements abstract org.HdrHistogram.AbstractHistogram.copy.

Doc from org.HdrHistogram.AbstractHistogram.copy.

Create a copy of this histogram, complete with data and everything.

Returns:ShortCountsHistogram

A distinct copy of this histogram.

Annotations
@Override
copyCorrectedForCoordinatedOmissionback to summary
public ShortCountsHistogram copyCorrectedForCoordinatedOmission(final long expectedIntervalBetweenValueSamples)

Implements abstract org.HdrHistogram.AbstractHistogram.copyCorrectedForCoordinatedOmission.

Doc from org.HdrHistogram.AbstractHistogram.copyCorrectedForCoordinatedOmission.

Get a copy of this histogram, corrected for coordinated omission.

To compensate for the loss of sampled values when a recorded value is larger than the expected interval between value samples, the new histogram will include an auto-generated additional series of decreasingly-smaller (down to the expectedIntervalBetweenValueSamples) value records for each count found in the current histogram that is larger than the expectedIntervalBetweenValueSamples.

Note

This is a post-correction method, as opposed to the at-recording correction method provided by recordValueWithExpectedInterval. 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. by

See notes in the description of the Histogram calls for an illustration of why this corrective behavior is important.

Parameters
expectedIntervalBetweenValueSamples:long

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

Returns:ShortCountsHistogram

a copy of this histogram, corrected for coordinated omission.

Annotations
@Override
decodeFromByteBufferback to summary
public static ShortCountsHistogram decodeFromByteBuffer(final ByteBuffer buffer, final long minBarForHighestTrackableValue)

Construct a new histogram by decoding it from a ByteBuffer.

Parameters
buffer:ByteBuffer

The buffer to decode from

minBarForHighestTrackableValue:long

Force highestTrackableValue to be set at least this high

Returns:ShortCountsHistogram

The newly constructed histogram

decodeFromCompressedByteBufferback to summary
public static ShortCountsHistogram decodeFromCompressedByteBuffer(final ByteBuffer buffer, final long minBarForHighestTrackableValue) throws DataFormatException

Hides org.HdrHistogram.EncodableHistogram.decodeFromCompressedByteBuffer.

Construct a new histogram by decoding it from a compressed form in a ByteBuffer.

Parameters
buffer:ByteBuffer

The buffer to decode from

minBarForHighestTrackableValue:long

Force highestTrackableValue to be set at least this high

Returns:ShortCountsHistogram

The newly constructed histogram

Exceptions
DataFormatException:
on error parsing/decompressing the buffer
fromStringback to summary
public static ShortCountsHistogram fromString(final String base64CompressedHistogramString) throws DataFormatException

Construct a new ShortCountsHistogram by decoding it from a String containing a base64 encoded compressed histogram representation.

Parameters
base64CompressedHistogramString:String

A string containing a base64 encoding of a compressed histogram

Returns:ShortCountsHistogram

A ShortCountsHistogram decoded from the string

Exceptions
DataFormatException:
on error parsing/decompressing the input
getCountAtIndexback to summary
pack-priv long getCountAtIndex(final int index)

Implements abstract org.HdrHistogram.AbstractHistogram.getCountAtIndex.

Annotations
@Override
getCountAtNormalizedIndexback to summary
pack-priv long getCountAtNormalizedIndex(final int index)

Implements abstract org.HdrHistogram.AbstractHistogram.getCountAtNormalizedIndex.

Annotations
@Override
getNormalizingIndexOffsetback to summary
pack-priv int getNormalizingIndexOffset()

Implements abstract org.HdrHistogram.AbstractHistogram.getNormalizingIndexOffset.

Annotations
@Override
getTotalCountback to summary
public long getTotalCount()

Implements abstract org.HdrHistogram.AbstractHistogram.getTotalCount.

Doc from org.HdrHistogram.AbstractHistogram.getTotalCount.

Get the total count of all recorded values in the histogram

Returns:long

the total count of all recorded values in the histogram

Annotations
@Override
incrementCountAtIndexback to summary
pack-priv void incrementCountAtIndex(final int index)

Implements abstract org.HdrHistogram.AbstractHistogram.incrementCountAtIndex.

Annotations
@Override
incrementTotalCountback to summary
pack-priv void incrementTotalCount()

Implements abstract org.HdrHistogram.AbstractHistogram.incrementTotalCount.

Annotations
@Override
readObjectback to summary
private void readObject(final ObjectInputStream o) throws IOException, ClassNotFoundException

Hides org.HdrHistogram.AbstractHistogram.readObject.

resizeback to summary
pack-priv void resize(long newHighestTrackableValue)

Implements abstract org.HdrHistogram.AbstractHistogram.resize.

Annotations
@Override
setCountAtIndexback to summary
pack-priv void setCountAtIndex(int index, long value)

Implements abstract org.HdrHistogram.AbstractHistogram.setCountAtIndex.

Annotations
@Override
setCountAtNormalizedIndexback to summary
pack-priv void setCountAtNormalizedIndex(int index, long value)

Implements abstract org.HdrHistogram.AbstractHistogram.setCountAtNormalizedIndex.

Annotations
@Override
setIntegerToDoubleValueConversionRatioback to summary
pack-priv void setIntegerToDoubleValueConversionRatio(double integerToDoubleValueConversionRatio)

Implements abstract org.HdrHistogram.AbstractHistogramBase.setIntegerToDoubleValueConversionRatio.

Annotations
@Override
setNormalizingIndexOffsetback to summary
pack-priv void setNormalizingIndexOffset(int normalizingIndexOffset)

Implements abstract org.HdrHistogram.AbstractHistogram.setNormalizingIndexOffset.

Annotations
@Override
setTotalCountback to summary
pack-priv void setTotalCount(final long totalCount)

Implements abstract org.HdrHistogram.AbstractHistogram.setTotalCount.

Annotations
@Override
shiftNormalizingIndexByOffsetback to summary
pack-priv void shiftNormalizingIndexByOffset(int offsetToAdd, boolean lowestHalfBucketPopulated, double newIntegerToDoubleValueConversionRatio)

Implements abstract org.HdrHistogram.AbstractHistogram.shiftNormalizingIndexByOffset.

Annotations
@Override