Statistics.Sample.WelfordOnlineMeanVariance

Documentation

data WelfordExistingAggregate a

For the storage of required information.

Constructors

WelfordExistingAggregateEmpty

Emtpy aggregate. Needed as a can be of any type, which, hence, allows us to postpone determining a to when we receive the first value.

WelfordExistingAggregate

Fields

• welfordCountUnsafe :: !Int
• welfordMeanUnsafe :: !a
• welfordM2Unsafe :: !a

Instances

Generic (WelfordExistingAggregate a)

Defined in Statistics.Sample.WelfordOnlineMeanVariance

Associated Types

type Rep (WelfordExistingAggregate a) :: Type -> Type

Methods

from :: WelfordExistingAggregate a -> Rep (WelfordExistingAggregate a) x

to :: Rep (WelfordExistingAggregate a) x -> WelfordExistingAggregate a

Read a => Read (WelfordExistingAggregate a)

Defined in Statistics.Sample.WelfordOnlineMeanVariance

Methods

readsPrec :: Int -> ReadS (WelfordExistingAggregate a)

readList :: ReadS [WelfordExistingAggregate a]

readPrec :: ReadPrec (WelfordExistingAggregate a)

readListPrec :: ReadPrec [WelfordExistingAggregate a]

Show a => Show (WelfordExistingAggregate a)

Defined in Statistics.Sample.WelfordOnlineMeanVariance

Methods

showsPrec :: Int -> WelfordExistingAggregate a -> ShowS

show :: WelfordExistingAggregate a -> String

showList :: [WelfordExistingAggregate a] -> ShowS

Serialize a => Serialize (WelfordExistingAggregate a)

Defined in Statistics.Sample.WelfordOnlineMeanVariance

Methods

put :: Putter (WelfordExistingAggregate a)

get :: Get (WelfordExistingAggregate a)

NFData a => NFData (WelfordExistingAggregate a)

Defined in Statistics.Sample.WelfordOnlineMeanVariance

Methods

rnf :: WelfordExistingAggregate a -> ()

Eq a => Eq (WelfordExistingAggregate a)

Defined in Statistics.Sample.WelfordOnlineMeanVariance

Methods

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

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

type Rep (WelfordExistingAggregate a)

Defined in Statistics.Sample.WelfordOnlineMeanVariance

type Rep (WelfordExistingAggregate a) = D1 ('MetaData "WelfordExistingAggregate" "Statistics.Sample.WelfordOnlineMeanVariance" "welford-online-mean-variance-0.1.0.4-hxML6sAVpU3KBkNvVMB08" 'False) (C1 ('MetaCons "WelfordExistingAggregateEmpty" 'PrefixI 'False) (U1 :: Type -> Type) :+: C1 ('MetaCons "WelfordExistingAggregate" 'PrefixI 'True) (S1 ('MetaSel ('Just "welfordCountUnsafe") 'NoSourceUnpackedness 'SourceStrict 'DecidedStrict) (Rec0 Int) :*: (S1 ('MetaSel ('Just "welfordMeanUnsafe") 'NoSourceUnpackedness 'SourceStrict 'DecidedStrict) (Rec0 a) :*: S1 ('MetaSel ('Just "welfordM2Unsafe") 'NoSourceUnpackedness 'SourceStrict 'DecidedStrict) (Rec0 a))))

class WelfordOnline a where

Class for all data strucutres that can be used to computer the Welford approximation. For instance, this can be used to compute the Welford algorithm on a Vectors of Fractional, while only requiring to handle one WelfordExistingAggregate.

Methods

plus :: a -> a -> a

minus :: a -> a -> a

multiply :: a -> a -> a

divideInt :: a -> Int -> a

Instances

WelfordOnline Rational

Defined in Statistics.Sample.WelfordOnlineMeanVariance

Methods

plus :: Rational -> Rational -> Rational

minus :: Rational -> Rational -> Rational

multiply :: Rational -> Rational -> Rational

divideInt :: Rational -> Int -> Rational

WelfordOnline Double

Defined in Statistics.Sample.WelfordOnlineMeanVariance

Methods

plus :: Double -> Double -> Double

minus :: Double -> Double -> Double

multiply :: Double -> Double -> Double

divideInt :: Double -> Int -> Double

WelfordOnline Float

Defined in Statistics.Sample.WelfordOnlineMeanVariance

Methods

plus :: Float -> Float -> Float

minus :: Float -> Float -> Float

multiply :: Float -> Float -> Float

divideInt :: Float -> Int -> Float

WelfordOnline a => WelfordOnline (Vector a)

Defined in Statistics.Sample.WelfordOnlineMeanVariance

Methods

plus :: Vector a -> Vector a -> Vector a

minus :: Vector a -> Vector a -> Vector a

multiply :: Vector a -> Vector a -> Vector a

divideInt :: Vector a -> Int -> Vector a

(WelfordOnline a, Storable a) => WelfordOnline (Vector a)

Defined in Statistics.Sample.WelfordOnlineMeanVariance

Methods

plus :: Vector a -> Vector a -> Vector a

minus :: Vector a -> Vector a -> Vector a

multiply :: Vector a -> Vector a -> Vector a

divideInt :: Vector a -> Int -> Vector a

(WelfordOnline a, Unbox a) => WelfordOnline (Vector a)

Defined in Statistics.Sample.WelfordOnlineMeanVariance

Methods

plus :: Vector a -> Vector a -> Vector a

minus :: Vector a -> Vector a -> Vector a

multiply :: Vector a -> Vector a -> Vector a

divideInt :: Vector a -> Int -> Vector a

newWelfordAggregateDef :: WelfordOnline a => a -> WelfordExistingAggregate a

Create a new empty Aggreate by specifying an example a value. It is safe to use the `*Unsafe` record field selectors from `WelfordExistingAggregate a`, when creating the data structure using this fuction.

newWelfordAggregate :: WelfordExistingAggregate a

Create a new empty Aggreate for the calculation.

welfordCount :: WelfordExistingAggregate a -> Int

Get counter safely, returns Nothing if WelfordExistingAggregateEmpty.

mWelfordMean :: WelfordExistingAggregate a -> Maybe a

Get counter safely, returns Nothing if WelfordExistingAggregateEmpty.

welfordMeanDef :: WelfordOnline a => a -> WelfordExistingAggregate a -> a

Get counter with specifying a default value.

addValue :: WelfordOnline a => WelfordExistingAggregate a -> a -> WelfordExistingAggregate a

Add one value to the current aggregate.

addValues :: (WelfordOnline a, Foldable f) => WelfordExistingAggregate a -> f a -> WelfordExistingAggregate a

Add multiple values to the current aggregate. This is `foldl addValue`.

mFinalize :: WelfordOnline a => WelfordExistingAggregate a -> Maybe (Mean a, Variance a, SampleVariance a)

Calculate mean, variance and sample variance from aggregate. Safe function.

finalize :: WelfordOnline a => WelfordExistingAggregate a -> (Mean a, Variance a, SampleVariance a)

Calculate mean, variance and sample variance from aggregate. Calls error for WelfordExistingAggregateEmpty.

nextValue :: WelfordOnline a => WelfordExistingAggregate a -> a -> (WelfordExistingAggregate a, (Mean a, Variance a, SampleVariance a))

Add a new sample to the aggregate and compute mean and variances.

isWelfordExistingAggregateEmpty :: WelfordExistingAggregate a -> Bool

Check if it is aggregate is empty

type Mean a = a

type Variance a = a

type SampleVariance a = a