asc2csv

Overview

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

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.