.. _citing-pymovements:

==================
Citing pymovements
==================

If you use pymovements in a scientific publication, please cite both the published software and the
following paper:

- `pymovements: A Python Package for Processing Eye Movement Data <pymovements-paper_>`_.
  Daniel G. Krakowczyk, David R. Reich, Jakob Chwastek, Deborah N. Jakobi, Paul Prasse,
  Assunta Süss, Oleksii Turuta, Paweł Kasprowski, and Lena A. Jäger. 2023.
  *In Proceedings of the 2023 Symposium on Eye Tracking Research and Applications (ETRA '23).*
  https://doi.org/10.1145/3588015.3590134

  .. _pymovements-paper: https://doi.org/10.1145/3588015.3590134

  .. code:: bibtex

    @inproceedings{pymovementsPaper,
      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\l{} and
        J\"{a}ger, Lena A.
      },
      title     = {pymovements: A Python Package for Processing Eye Movement Data},
      year      = {2023},
      isbn      = {9798400701504},
      publisher = {Association for Computing Machinery},
      address   = {New York, NY, USA},
      url       = {https://doi.org/10.1145/3588015.3590134},
      doi       = {10.1145/3588015.3590134},
      booktitle = {Proceedings of the 2023 Symposium on Eye Tracking Research and Applications},
      articleno = {53},
      numpages  = {2},
      location  = {Tubingen, Germany},
      series    = {ETRA '23}
    }

- `pymovements on Zenodo <pymovements-zenodo_>`_. Each new pymovements release is archived on Zenodo
  and assigned a unique DOI. Please choose the citation corresponding to the specific pymovements
  version you are using. If needed, you may replace the full author list with
  “*The pymovements project team*” as shown in the example for *pymovements v0.26.2* below.

  .. _pymovements-zenodo: https://doi.org/10.5281/zenodo.17397139

  .. code:: bibtex

    @software{pymovements,
      author    = {The pymovements project team},
      title     = {pymovements: A Python Package for Processing Eye Movement Data},
      month     = apr,
      year      = 2026,
      publisher = {Zenodo},
      version   = {v0.26.2},
      doi       = {10.5281/zenodo.19486286},
      url       = {https://doi.org/10.5281/zenodo.19486286},
    }

In case you want to cite specific parts of the package, like our dataset library or data quality
reports, please consider the publications below.

- `The More the Merrier: Boost Your Dataset Visibility and Discover Eye-Tracking Datasets with
  pymovements <pymovements-datasets_>`_ .
  Daniel G. Krakowczyk, David R. Reich, Andreas Säuberli, Iza Škrjanec, Isabelle C. R. Cretton,
  Deborah N. Jakobi, Sergiu Nisioi, Paul Prasse, and Lena A. Jäger. 2025.
  *In Proceedings of the 2025 Symposium on Eye Tracking Research and Applications (ETRA '25).*
  https://doi.org/10.1145/3715669.3726810

  .. _pymovements-datasets: https://doi.org/10.1145/3715669.3726810

  .. code:: bibtex

    @inproceedings{pymovementsDatasets,
      author    = {
        Krakowczyk, Daniel G. and Reich, David R. and S\"{a}uberli, Andreas and \v{S}krjanec, Iza
        and Cretton, Isabelle C. R. and Jakobi, Deborah N. and Nisioi, Sergiu and Prasse, Paul and
        J\"{a}ger, Lena A.
      },
      title     = {
        The More the Merrier: Boost Your Dataset Visibility and Discover Eye-Tracking Datasets with
        pymovements
      },
      year      = {2025},
      isbn      = {9798400714870},
      publisher = {Association for Computing Machinery},
      address   = {New York, NY, USA},
      url       = {https://doi.org/10.1145/3715669.3726810},
      doi       = {10.1145/3715669.3726810},
      booktitle = {Proceedings of the 2025 Symposium on Eye Tracking Research and Applications},
      articleno = {63},
      numpages  = {3},
      location  = {Tokyo, Japan},
      series    = {ETRA '25}
    }

- `Reporting Eye-Tracking Data Quality: Towards a New Standard <pymovements-data-quality_>`_.
  Deborah N. Jakobi, Daniel G. Krakowczyk, and Lena A. Jäger. 2024.
  *In Proceedings of the 2024 Symposium on Eye Tracking Research and Applications (ETRA '24).*
  https://doi.org/10.1145/3649902.3655658

  .. _pymovements-data-quality: https://doi.org/10.1145/3649902.3655658

  .. code:: bibtex

    @inproceedings{pymovementsDataQuality,
      author    = {Jakobi, Deborah N. and Krakowczyk, Daniel G. and J\"{a}ger, Lena A.},
      title     = {Reporting Eye-Tracking Data Quality: Towards a New Standard},
      year      = {2024},
      isbn      = {9798400706073},
      publisher = {Association for Computing Machinery},
      address   = {New York, NY, USA},
      url       = {https://doi.org/10.1145/3649902.3655658},
      doi       = {10.1145/3649902.3655658},
      booktitle = {Proceedings of the 2024 Symposium on Eye Tracking Research and Applications},
      articleno = {47},
      numpages  = {3},
      location  = {Glasgow, United Kingdom},
      series    = {ETRA '24}
    }