asc2csv 1.4.1

A Python package for converting EyeLink .asc files to structured .csv files.

asc2csv

asc2csv is a Python package developed for converting EyeLink .asc files into structured .csv files, facilitating the analysis of eye-tracking data. It extracts gaze data and event details such as blinks, saccades, and fixations, organizing them into an easy-to-use format.

Features

• Converts EyeLink .asc files to .csv format efficiently.
• Extracts and processes blink (EBLINK), saccade (ESACC), and fixation (EFIX) event data.
• Aligns timestamps relative to trial start for consistent temporal analysis.
• Handles missing data by combining event and sample data fields where applicable.

Changelog

See the Changes in versions

Version 1.4

• Initial release of asc2csv.
• V 1.4 Update 12/11/24 make adding header=True in conversion optional. By default header=True is applied.

Version 1.4.1

• Enhanced data importing

Installation

To install the package, run:

pip install asc2csv

Usage

Import the package and use the process_asc_file() function:

import asc2csv as convert

convert.process_asc_file('input_file.asc', 'output_file.csv')

Parameters

• input_file_path (str): Path to the input .asc file.
• output_csv_path (str): Path to save the output .csv file.
• header (bool, optional): Whether to include a header row in the output CSV. Default is True.

Requirements

• Python >= 3.6
• pandas

License

This project is licensed under the MIT License. See the LICENSE file for more details.

Contributing

Contributions are welcome! If you find a bug or have an idea for an improvement, please submit a pull request or open an issue.

Creator and Maintainer

Mohammad Ahsan Khodami

• Personal Site: khodami.site
• Google Scholar: Profile
• Email: [e-mail]

Acknowledgments

• The EyeLink system and data format are provided by SR Research.