SyeLink Documentation

SyeLink is a Python library for parsing EyeLink eye tracker data from ASC files. It extracts calibration, validation, recording, and gaze sample data into structured Python objects, with export to JSON and CSV.

Features

• Parse EyeLink ASC files into structured dataclasses

• Extract calibration, validation, recording, and gaze sample data

• Export gaze samples to CSV with optional raw pupil/CR data

• Visualize calibration and validation results

• Command-line interface for common tasks

• Support for binocular and monocular recordings

Contents

• Getting Started
  • Installation
  • Quick Start
  • Examples
• Command-Line Interface
  • Commands
  • convert
  • info
  • export-samples
  • plot-validation
  • plot-calibration

API Reference

• API Reference
  • Data Models
  • Parsing
  • Plotting

---

Note

This project has received funding from the European Union’s Horizon Europe research and innovation funding program under grant agreement No 101072410, Eyes4ICU project.

Note

If you use SyeLink in your research, please cite:

Salari, M., Nyström, M., Niehorster, D. C., & Bednarik, R. (2026). PyeLink and SyeLink: Open-source Python tools for low-level EyeLink experiment control and data parsing. In Proceedings of the 2026 Eye Tracking Research & Applications (ETRA 2026) Late-Breaking Work. ACM. DOI: 10.1145/3797246.3805844

Author: Mohammadhossein Salari