๐Ÿ“Œ Introduction to etformat#

etformat is a Python package designed for processing and analyzing eye-tracking data from EDF (Eye Data Format) files. It provides tools to convert, extract, visualize, and analyze gaze data with ease.

๐Ÿ”น Key Features#

โœ” Convert EDF to CSV for easy access (export())
โœ” Extract metadata like sampling rate & screen size (edfinfo())
โœ” Analyze trials for fixations, saccades & blinks (describe())
โœ” Visualize gaze paths (plot_gaze())
โœ” Plot saccades with movement directions (plot_saccades())
โœ” Extract and validate calibration data (calibration())

๐Ÿš€ Quick Example#

import etformat as et

# Convert EDF file to CSV
et.export("test.EDF")

# Extract EDF metadata
et.edfinfo("test.EDF")

# Analyze trials
et.describe("test.EDF")

# Plot gaze for trial 3
et.plot_gaze(samples, trial_number=3)

# Plot saccades for trial 3
et.plot_saccades(events, trial_number=3)

# Extract calibration details
et.calibration("test.EDF")

#Clean EDF fiel and Preprocess
et.clean('file')

#Average Saccade Report
et.saccade_amplitude_average(events)

#Recording report
et.report(events)

โœ… Easy to use, powerful, and built for eye-tracking research! ๐Ÿš€