this is a Python library for eye-movement analysis, visualization and comparison, with a focus on scanpath comparison.
The ultimate goal of the library is to make advanced fixation map statistics (eg: entropy) and scanpath comparison accesible (hidden markov model based, and saccade direction based).
The library also provides general descripitve statistics about eye-movements. It is intended to work with ordered fixation data. (a row for each fixation), that is loaded into a pandas dataframe.
Additionaly, easy visualizations about the statistics (overall stats, stimulus based stats, within trial progrression) and heatmaps are also provided.
three main scanpath similarity functionalities:
- Within group similarity (for a single group of observers in a single condition)
- Between condition similarity (for single group of observers, observing the same stimuli in two conditions)
- Between group similarity (for two groups of observers observing the same stimuli)
The library started to develop for use in art perception studies, therefore, there is an emphasis on stimulus based eye-movement comparison.
in the terminal/anaconda prompt
pip install pyeyesim
OR
if you cloned the library and are in the root folder of the library using the terminal (mac) or anaconda prompt (windows), you can install it, using the command: " pip install -e . "
for examples of using the library, see the PyEyeSimDemo.ipynb in the Notebooks folder
scikit-image hmmlearn xarray
https://pypi.org/project/pyeyesim/
dataset is from: Wilming, N., Onat, S., Ossandón, J. P., Açık, A., Kietzmann, T. C., Kaspar, K., ... & König, P. (2017). An extensive dataset of eye movements during viewing of complex images. Scientific data, 4(1), 1-11.
to run the demo download the CSV from: https://ucloud.univie.ac.at/index.php/s/3FF3iqZDzc3MxK9
images can be downloaded from: https://datadryad.org/stash/dataset/doi:10.5061/dryad.9pf75 only download images: Stimuli_8.zip