hmatrix-gsl-stats-0.2.1: GSL Statistics interface

Copyright(c) A. V. H. McPhail 2010
LicenseBSD3
Maintainerhaskell.vivian.mcphail <at> gmail <dot> com
Stabilityprovisional
Portabilityuses ffi
Safe HaskellNone
LanguageHaskell2010

Numeric.GSL.Histogram

Contents

Description

Synopsis

Creation

data Histogram Source

A histogram structure

emptyRanges Source

Arguments

:: Vector Double

the ranges

-> Histogram

result

create a histogram with n bins from ranges (x0->x1),(x1->x2)..(xn->xn+1)

emptyLimits Source

Arguments

:: Int

bins

-> (Double, Double)

lower and upper limits

-> Histogram

result

create a histogram with n bins and lower and upper limits

fromRanges Source

Arguments

:: Vector Double

the ranges

-> Vector Double

the data

-> Histogram

result

create a histogram with n bins from ranges (x0->x1),(x1->x2)..(xn->xn+1) and increment from a vector

fromLimits Source

Arguments

:: Int

bins

-> (Double, Double)

lower and upper limits

-> Vector Double

the data

-> Histogram

result

create a histogram with n bins and lower and upper limits and increment from a vector

Loading

addList :: Histogram -> [Double] -> Histogram Source

adds 1.0 to the correct bin for each element of the list

addVector :: Histogram -> Vector Double -> Histogram Source

adds 1.0 to the correct bin for each element of the vector

addListWeighted :: Histogram -> [(Double, Double)] -> Histogram Source

adds the appropriate weight for each element of the list

addVectorWeighted :: Histogram -> Vector Double -> Vector Double -> Histogram Source

adds the appropriate weight for each element of the list

Marshalling

toVectors Source

Arguments

:: Histogram 
-> (Vector Double, Vector Double)

(ranges,bins)

extract the ranges and bin weights

fromVectors :: Vector Double -> Vector Double -> Histogram Source

create a histogram from the ranges and bin weights

Information

getBin :: Histogram -> Int -> Double Source

returns the contents of the i-th bin

getRange :: Histogram -> Int -> (Double, Double) Source

returns the upper and lower limits of the i-th bin

getMax :: Histogram -> Double Source

the maximum upper range limit

getMin :: Histogram -> Double Source

the minimum lower range limit

getBins :: Histogram -> Int Source

the number of bins

Querying

find :: Histogram -> Double -> Maybe Int Source

find the bin corresponding to the value

count :: Histogram -> Vector Double -> Vector Double Source

find the number of occurences for each element of the input vector

prob :: Histogram -> Vector Double -> Vector Double Source

find the probability of occurring for each element of the input vector

countInstance :: Histogram -> Double -> Double Source

find the number of occurences for the input

probability :: Histogram -> Double -> Double Source

find the probability of the input

maxVal :: Histogram -> Double Source

the maximum value contained in the bins

maxBin :: Histogram -> Int Source

the index of the bin containing the maximum value

minVal :: Histogram -> Double Source

the minimum value contained in the bins

minBin :: Histogram -> Int Source

the index of the bin containing the minimum value

Statistics

mean :: Histogram -> Double Source

the mean of the values, accuracy limited by bin width

stddev :: Histogram -> Double Source

the standard deviation of the values, accuracy limited by bin width

sum :: Histogram -> Double Source

the sum of the values, accuracy limited by bin width

equalBins :: Histogram -> Histogram -> Bool Source

returns True of all the individual bin ranges of the two histograms are identical

Mathematics

add :: Histogram -> Histogram -> Histogram Source

adds the contents of the bins of the second histogram to the first

subtract :: Histogram -> Histogram -> Histogram Source

subtracts the contents of the bins of the second histogram from the first

multiply :: Histogram -> Histogram -> Histogram Source

multiplies the contents of the bins of the second histogram by the first

divide :: Histogram -> Histogram -> Histogram Source

divides the contents of the bins of the first histogram by the second

shift :: Histogram -> Double -> Histogram Source

adds a constant to the contents of the bins

scale :: Histogram -> Double -> Histogram Source

multiplies the contents of the bins by a constant

Files

fwriteHistogram :: FilePath -> Histogram -> IO () Source

write a histogram in the native binary format (may not be portable)

freadHistogram :: FilePath -> Int -> IO Histogram Source

read a histogram in the native binary format, number of bins must be known

fprintfHistogram :: FilePath -> String -> String -> Histogram -> IO () Source

saves the histogram with the given formats (%f,%e,%g) for ranges and bins each line comprises: range[i] range[i+1] bin[i]

fscanfHistogram :: FilePath -> Int -> IO Histogram Source

reads formatted data as written by fprintf, the number of bins must be known in advance

PDF

data HistogramPDF Source

A histogram-derived cumulative distribution function (CDF)

fromHistogram :: Histogram -> HistogramPDF Source

create a histogram PDF from a histogram

sample :: HistogramPDF -> Double -> Double Source

given a random number from the uniform distribution [0,1], draw a random sample from the PDF