NumHask.Histogram

Documentation

data Histogram

a Histogram is a list of contiguous boundaries (a boundary being the lower edge of one bucket and the upper edge of another), and a count for each bucket Overs and Unders are counted in key=0 and key=length cut

Constructors

Histogram

Fields

• cuts :: [Double]
• values :: Map Int Double

Instances

Eq Histogram

Defined in NumHask.Histogram

Methods

(==) :: Histogram -> Histogram -> Bool

(/=) :: Histogram -> Histogram -> Bool

Show Histogram

Defined in NumHask.Histogram

Methods

showsPrec :: Int -> Histogram -> ShowS

show :: Histogram -> String

showList :: [Histogram] -> ShowS

data DealOvers

whether or not to ignore unders and overs

Constructors

IgnoreOvers

IncludeOvers Double

fill :: (Functor f, Foldable f) => [Double] -> f Double -> Histogram

fill a Histogram using pre-specified cuts >>> fill [0,50,100] [1..100] Histogram {cuts = [0.0,50.0,100.0], values = fromList [(1,50.0),(2,50.0)]}

regular :: Int -> [Double] -> Histogram

make a histogram using n equally spaced cuts over the entire range of the data >>> regular 4 [0..100] Histogram {cuts = [0.0,25.0,50.0,75.0,100.0], values = fromList [(0,1.0),(1,25.0),(2,25.0),(3,25.0),(4,25.0)]}

makeRects :: DealOvers -> Histogram -> [Rect Double]

transform a Histogram to Rects >>> makeRects IgnoreOvers (regular 4 [0..100]) [Rect 0.0 25.0 0.0 0.25,Rect 25.0 50.0 0.0 0.25,Rect 50.0 75.0 0.0 0.25,Rect 75.0 100.0 0.0 0.25]

regularQuantiles :: Double -> [Double] -> [Double]

approx regular n-quantiles >>> regularQuantiles 4 [0..100] [0.0,24.75,50.0,75.25,100.0]

quantileFold :: [Double] -> Fold Double [Double]

one-pass approximate quantiles fold

fromQuantiles :: [Double] -> [Double] -> Histogram

take a specification of quantiles and make a Histogram >>> fromQuantiles [0,0.25,0.5,0.75,1] (regularQuantiles 4 [0..100]) Histogram {cuts = [0.0,24.75,50.0,75.25,100.0], values = fromList [(1,0.25),(2,0.25),(3,0.25),(4,0.25)]}

freq :: Histogram -> Histogram

normalize a histogram so that sum values = one >>> freq $ fill [0,50,100] [1..100] Histogram {cuts = [0.0,50.0,100.0], values = fromList [(1,0.5),(2,0.5)]}