About the EMIP Toolkit
The use of eye tracking in the study of program comprehension in software engineering allows researchers to gain a better understanding of the strategies and processes applied by programmers. Despite the large number of eye tracking studies in software engineering, very few datasets are publicly available. The existence of the large Eye Movements in Programming Dataset (EMIP) opens the door for new studies and makes reproducibility of existing research easier. The toolkit is specifically designed to make using the EMIP dataset easier and more accessible. It implements features for fixation detection and correction, trial visualization, source code lexical data enrichment, and mapping fixation data over areas of interest.
Read More...Please Cite:
Naser Al Madi, Drew T. Guarnera, Bonita Sharif, and Jonathan I. Maletic.2021. EMIP Toolkit: A Python Library for Customized Post-processing of the Eye Movements in Programming Dataset. In ETRA ’21: 2021 Symposium on Eye Tracking Research and Applications (ETRA ’21 Short Papers), May25–27, 2021, Virtual Event, Germany. ACM, New York, NY, USA, 6 pages. https://doi.org/10.1145/3448018.3457425
Features:
The toolkit is specifically designed to make using the EMIP dataset easier and more accessible by providing the following functions:
- Parsing raw data files from the EMIP dataset into Experiment, Trial, and Fixation containers.
- Customizable dispersion-based fixation detection algorithm implementation according to the manual of the SMI eye tracker used in the data collection.
- Raw data and filtered data visualizations for each trial.
- Performing hit testing between fixations and AOIs to determine the fixations over each AOI.
- Customizable offset-based fixation correction implementation for each trial.
- Customizable Areas Of Interest (AOIs) mapping implementation at the line level or token level in source code for each trial.
- Visualizing AOIs before and after fixations overlay on the code stimulus.
- Mapping source code tokens to generated AOIs and eye movement data.
- Adding source code lexical category tags to eye movement data using srcML. srcML is a static analysis tool and data format that provides very accurate syntactic categories (method signatures, parameters, function names, method calls, declarations and so on) for source code. We use it to enhance the eye movements dataset to enable better querying capabilities.
- Downloading specific datasets from the EMIP-Toolkit replication package and other data sources.
Examples and Tutorial:
The Jupyter Notebook file “EMIP Toolkit Examples.ipynb” contains examples and a tutorial on using the EMIP Toolkit. The file describes the required file structure and raw EMIP files and metadata from here.
Corrected Dataset:
The directory “Corrected EMIP Dataset” includes our second contribution of a filtered, corrected, and processed version of the EMIP dataset.
Requirements:
- numpy
- pandas
- matplotlib
- Pillow
- requests