hmm-hmatrix-0.0.0.1: Hidden Markov Models using HMatrix primitives

Safe HaskellNone
LanguageHaskell2010

Math.HiddenMarkovModel.Example.TrafficLight

Description

Warning: do not import that module, it is only intended for demonstration

This is an example of an HMM with discrete emissions. We model a traffic light consisting of the colors red, yellow, green, where only one lamp can be switched on at every point in time. This way, when it is yellow you cannot tell immediately whether it will switch to green or red. We can only infer this from the light seen before.

There are four hidden states: 0 emits red, 1 emits yellow between red and green, 2 emits green, 3 emits yellow between green and red.

We quantise time in time steps. The transition matrix of the model hmm encodes the expected duration of every state counted in time steps and what states follow after each other. E.g. transition probability of 0.8 of a state to itself means that the expected duration of the state is 5 time steps (1/(1-0.8)). However, it is a geometric distribution, that is, shorter durations are always more probable.

The distribution of hmm encodes which lights a state activates. In our case everything is deterministic: Every state can switch exactly one light on.

Given a sequence of observed lights the function reveal tells us the most likely sequence of states. We test this with the light sequences in stateSequences where we already know the hidden states as they are stored in labeledSequences. verifyRevelation compares the computed state sequence with the given one.

We also try some trainings in hmmTrainedSupervised et.al.

Synopsis

Documentation

data Color Source

Constructors

Red 
Yellow 
Green 

Instances

Enum Color 
Eq Color 
Ord Color 
Read Color 
Show Color 
CSVSymbol Color

Using show and read is not always a good choice since they must format and parse Haskell expressions which is not of much use to the outside world.

hmmTrainedSupervised :: Discrete Double Color Source

Construct a Hidden Markov model by watching a set of manually created sequences of emissions and according states.

hmmTrainedUnsupervised :: Discrete Double Color Source

Construct a Hidden Markov model starting from a known model and a set of sequences that contain only the emissions, but no states.

hmmIterativelyTrained :: Discrete Double Color Source

Repeat unsupervised training until convergence.