Data.HdrHistogram

A Haskell implementation of HdrHistogram. It allows storing counts of observed values within a range, while maintaining precision to a configurable number of significant digits.

Histogram

data Histogram config value count

A pure Histogram

Constructors

Histogram

Fields

• _config :: HistogramConfig value
• totalCount :: count
• counts :: Vector count

Instances

(Unbox count, Eq count, Eq value) => Eq (Histogram config value count)

Methods

(==) :: Histogram config value count -> Histogram config value count -> Bool

(/=) :: Histogram config value count -> Histogram config value count -> Bool

(Unbox count, Show count, Show value) => Show (Histogram config value count)

Methods

showsPrec :: Int -> Histogram config value count -> ShowS

show :: Histogram config value count -> String

showList :: [Histogram config value count] -> ShowS

(HasConfig config, Integral value, FiniteBits value, Unbox count, Integral count) => Monoid (Histogram config value count)

Methods

mempty :: Histogram config value count

mappend :: Histogram config value count -> Histogram config value count -> Histogram config value count

mconcat :: [Histogram config value count] -> Histogram config value count

empty :: forall config value count. (HasConfig config, Integral value, FiniteBits value, Unbox count, Integral count) => Histogram config value count

Construct a Histogram.

fromConfig :: (Unbox count, Integral count) => Tagged c (HistogramConfig value) -> Histogram c value count

Construct a Histogram from the given HistogramConfig. In this case c is a phantom type.

Writing

record :: (Unbox count, Integral count, Integral value, FiniteBits value) => Histogram config value count -> value -> Histogram config value count

Record a single value to the Histogram

recordValues :: (Unbox count, Integral count, Integral value, FiniteBits value) => Histogram config value count -> value -> count -> Histogram config value count

Record a multiple instances of a value value to the Histogram

Reading

data Range a

A range of values between lower and upper

Constructors

Range

Fields

• lower :: a
• upper :: a

Instances

Eq a => Eq (Range a)

Methods

(==) :: Range a -> Range a -> Bool

(/=) :: Range a -> Range a -> Bool

Show a => Show (Range a)

Methods

showsPrec :: Int -> Range a -> ShowS

show :: Range a -> String

showList :: [Range a] -> ShowS

percentile

Arguments

:: (Integral value, Integral count, Unbox count, Bits value)

=> Histogram config value count

-> Float

The percentile in the range 0 to 100

-> Range value

Calculate the Range of values at the given percentile

Re-exports

data Config lowest highest sig

Type-safe configuration for a Histogram

Instances

(KnownNat low, KnownNat high, KnownNat sig, HighLow low high, SigBounds sig) => HasConfig (Config low high sig)

Methods

getConfig :: (Integral a, FiniteBits a) => Proxy * (Config low high sig) -> HistogramConfig a

class HasConfig s

Typeclass to specify the types which can produce a HistogramConfig

Minimal complete definition

getConfig

Instances

(KnownNat low, KnownNat high, KnownNat sig, HighLow low high, SigBounds sig) => HasConfig (Config low high sig)

Methods

getConfig :: (Integral a, FiniteBits a) => Proxy * (Config low high sig) -> HistogramConfig a