Skip to main content

A python package for processing eye movement data

Project description


PyPI Latest Release Conda Latest Release PyPI status Python version Operating System License Test Status Documentation Status codecov PyPI downloads/month Binder

pymovements is an open-source python package for processing eye movement data. It provides a simple interface to download publicly available datasets, preprocess gaze data, detect oculomotoric events and render plots to visually analyze your results.

Getting Started

With pymovements loading your eye movement datasets is just a few lines of code away

import pymovements as pm

dataset = pm.Dataset(
    'JuDo1000',                  # choose a public dataset from our dataset library
    path='data/judo100',         # setup your local dataset path
)               # download a public dataset from our dataset library
dataset.load()                   # download the dataset

calculate velocities on the fly

dataset.pix2deg()                # transform pixel coordinates to degrees of visual angle
dataset.pos2vel()                # transform positional data to velocity data

and extract events with different eye movements event extraction algorithms

dataset.detect('ivt')            # detect fixation using the I-VT algorithm
dataset.detect('microsaccades')  # detect saccades using the microsaccades algorithm

Check out our guide on how to install pymovements and get started here: Installation

We provide a range of tutorial aimed at beginners: Tutorials

The complete reference of the package can be found here: API Reference


We welcome any sort of contribution to pymovements!

For a detailed guide, please refer to our first.

If you have any questions, please open an issue or write us at


If you are using pymovements in your research, we would be happy if you cite our work by using the following BibTex entry:

    author = {Krakowczyk, Daniel G. and Reich, David R. and Chwastek, Jakob and Jakobi, Deborah N.
   and Prasse, Paul and Süss, Assunta and Turuta, Oleksii and Kasprowski, Paweł
   and Jäger, Lena A.},
    title = {pymovements: A Python Package for Processing Eye Movement Data},
    year = {2023},
    isbn = {979-8-4007-0150-4/23/05},
    publisher = {Association for Computing Machinery},
    address = {New York, NY, USA},
    url = {},
    doi = {10.1145/3588015.3590134},
    booktitle = {2023 Symposium on Eye Tracking Research and Applications},
    location = {Tubingen, Germany},
    series = {ETRA '23},

There is also a preprint available on arxiv.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

pymovements-0.18.0.tar.gz (97.4 kB view hashes)

Uploaded Source

Built Distribution

pymovements-0.18.0-py3-none-any.whl (164.4 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page