Skip to content
/ fix8 Public

Fix8 (Fixate) is an Open-Source GUI Tool for Working with Eye Tracking Data in Reading Tasks.

License

Notifications You must be signed in to change notification settings

nalmadi/fix8

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Fix8 Overview

Fix8 (Fixate) is an open-source GUI Tool for working with eye tracking data in reading tasks. FIx8 includes a novel semi-automated correction approach for eye tracking data in reading tasks. The proposed approach allows the user to collaborate with an algorithm to produce accurate corrections in less time without sacrificing accuracy.

Watch the video

Main Features ⭐

  • Drift correction including manual, assisted (semi-automated), and automated correction.
  • Fully customizable and interactive visualization.
  • Synthetic data and distortion generation including full control of word skipping, within-line and between-line regressions.
  • Filters: high-pass, low-pass, outlier, merge, and outside screen filters.
  • Analyses including hit-test and eye movement metrics like First-Fixation Duration, Single-Fixation Duration, and Total Time.
  • Data Converters: EyeLink data, ASCII, CSV, and JSON are supported.
  • Request a feature by making an issue on this page!

Manual 📖

A comprehensive manual of Fix8 GUI and every feature can be found here: Fix8_Manual_v1.2

Executables 💻

  • Windows:

    Compressed executable (single file): [Download]

    UNcompressed executable (many files): [Download]

    to download and run Fix8 do the following:

    • Click on one of the download link above.
    • In the top right, right-click the Raw button.
    • Click on "Save as..."
    • Unzip the file.
    • Locate Fix8.exe and run it, first run might take a minute.
    • Enjoy!
  • Mac:

    Compressed executable (single file): [Download]

  • Linux:

    Coming soon!

Run Fix8 from code 🚀

To run Fix8 from the Python code, follow these steps:

  1. Clone the Repository:

    git clone https://github.com/nalmadi/fix8.git
    cd fix8
  2. Create a Virtual Environment:

    It's recommended to use a virtual environment to manage dependencies and isolate your project's environment:

    python -m venv myvenv

    Activate the virtual environment:

    On Windows:

    myvenv\Scripts\activate

    On macOS and Linux:

    source myvenv/bin/activate
  3. Install Requirements:

    Once the virtual environment is activated, install the package via pip:

    pip install .

    If you plan to make changes to the code and rerun the package with the new changes, use this command instead:

    pip install -e .
  4. Run the Tool:

    Once done, run the tool simply by entering the command "fix8" in the terminal:

    fix8
  5. Deactivate the Virtual Environment:

    When you're done using the tool, deactivate the virtual environment:

    deactivate

Keyboard Shortcuts ⌨️​

Watch the video

Key Functionality
a assign current fixation to line above
z assign current fixation to line below
space accept suggestion
backspace delete fixation (click on fixation to select)
right next fixation
left previous fixation
1-9 assign fixation to the line number

Datasets 🗂️​

Complete or partial data from the following datasets is included in Fix8:

  • AlMadi2018: Al Madi, Naser, and Javed Khan. "Constructing semantic networks of comprehension from eye-movement during reading." 2018 IEEE 12th International Conference on Semantic Computing (ICSC). IEEE, 2018.
  • EyeLink_experiment: Al Madi, Naser, and Javed Khan. "Constructing semantic networks of comprehension from eye-movement during reading." 2018 IEEE 12th International Conference on Semantic Computing (ICSC). IEEE, 2018.
  • EMIP2021: Bednarik, Roman, et al. "EMIP: The eye movements in programming dataset." Science of Computer Programming 198 (2020): 102520.
  • EMIP2021_90: Al Madi, Naser, et al. "EMIP Toolkit: A Python Library for Customized Post-processing of the Eye Movements in Programming Dataset." ACM Symposium on Eye Tracking Research and Applications. 2021.
  • Carr2022: Carr, J. W., Pescuma, V. N., Furlan, M., Ktori, M., & Crepaldi, D. (2022). Algorithms for the automated correction of vertical drift in eye-tracking data. Behavior Research Methods, 54(1), 287-310.
  • GazeBase: Griffith, H., Lohr, D., Abdulin, E., & Komogortsev, O. (2021). GazeBase, a large-scale, multi-stimulus, longitudinal eye movement dataset. Scientific Data, 8(1), 184.
  • MET_Dataset: Raymond, O., Moldagali, Y., & Al Madi, N. (2023, May). A dataset of underrepresented languages in eye tracking research. In Proceedings of the 2023 Symposium on Eye Tracking Research and Applications (pp. 1-2).

API and Documentation for Developers ⚙️

Developers can find the Fix8 Core API documentation HERE

Citation 📝

Naser Al Madi, Brett Torra, Yixin Li, Najam Tariq. (2024). Combining Automation and Expertise: A Semi-automated Approach to Correcting Eye Tracking Data in Reading Tasks.

@article{Al2024combining,
author = {Naser Al Madi, Brett Torra, Yixin Li, Najam Tariq},
title = {Combining Automation and Expertise: A Semi-automated Approach to Correcting Eye Tracking Data in Reading Tasks},
journal = {},
year = {},
volume = {},
pages = {},
doi = {}
}

About

Fix8 (Fixate) is an Open-Source GUI Tool for Working with Eye Tracking Data in Reading Tasks.

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Contributors 4

  •  
  •  
  •  
  •