========================================================================

  Eye-Movement analysis with Hidden Markov Models (HMMs)
  emhmm-toolbox

  Antoni B. Chan, City University of Hong Kong
  Janet H. Hsiao, University of Hong Kong
  Tim Chuk, University of Hong Kong
  Cynthia Y.H. Chan, University of Hong Kong

  Copyright (c) 2019, City University of Hong Kong & University of Hong Kong

========================================================================

--- DESCRIPTION ---
This is a MATLAB toolbox for analyzing eye movement data with hidden Markov Models (HMMs). 
The major functions of the toolbox are:
  1) Estimating HMMs for an individual's eye-gaze data.
  2) Clustering individuals' HMMs to find common strategies.
  3) Visualizing HMMs
  4) Statistical tests to see if two HMMs are different.
  5) Using representative Holistic and Analytic models to compute HA scale value.

--- BRIEF INSTRUCTIONS ---
In MATLAB, run "setup" to setup the toolbox.
In demo folder, run "demo_faces" for an example.
Also see "demo_faces_jov_clustering", "demo_faces_jov_compare", "demo_faces_duration", 
and "demo_conversion".
There are also demos in the "models" folder: "demo_PBR_model".

More documentation and descriptions are in the "docs" folder. In particular, 
"docs/emhmm-tutorial.pdf" contains slides introducing how to use the toolbox, while
"docs/emhmm-documentation.pdf" contains more detailed information.

--- REFERENCES ---
If you use this toolbox, please cite the following papers:

For learning HMMs for eye gaze data:
  Tim Chuk, Antoni B. Chan, and Janet H. Hsiao.
  "Understanding eye movements in face recognition using hidden Markov models."
  Journal of Vision, 14(11):8, Sep 2014.

For clustering HMMs with the VHEM algorithm:  
  Emanuele Coviello, Antoni B. Chan, and Gert R.G. Lanckriet.
  "Clustering hidden Markov models with variational HEM".
  Journal of Machine Learning Research (JMLR), 15(2):697-747, Feb 2014.

If you use the representative Holistic/Analytic models and HA Scale: 
  Cynthia Y.H. Chan, Antoni B. Chan, Tatia M.C. Lee, and Janet H. Hsiao.
  "Eye Movement Patterns in Face Recognition are Associated with Cognitive 
   Decline in Older Adults.? 
  Psychonomic Bulletin & Review, to appear 2018. 

--- CHANGE LOG ---
see CHANGELOG.txt for version information.

--- CONTACT INFO ---
Please send comments, bug reports, feature requests to Antoni Chan (abchan at cityu dot edu . hk).

--- ACKNOWLEDGEMENTS ---

We are grateful for supported from the Research Grant Council of Hong Kong SAR:
#17402814 and HKU 745210H for J.H. Hsiao; CityU 110513 and G-CityU109/14 for A.B. Chan.
We also thank the HKU Seed Funding Programme for Basic Research (Project number 201311159131) to J.H. Hsiao.


