How aaronkhodami/etformat works
etformat turns EyeLink EDF recordings into event and sample tables, then provides separate tools for cleaning, trial analysis, quality reporting, metadata and channel inspection, calibration review, and plotting. The main conversion path is documented and supported by source references; some downstream tools accept tables or CSVs independently, so the graph does not imply a shared pipeline among them. Several relationships for unsampled modules are documented in the README rather than verified from their implementations.
Main entry points: edffile.py EDFFile reader · export.py CSV export · edfdata_containers.py Table containers · edfinfo.py Recording metadata
Components 17
EDF ingestion
- EDFFile reader
etformat/edffile.py - EDF structures
etformat/edfdata.py - Table containers
etformat/edfdata_containers.py
Table export
- CSV export
etformat/export.py - Events and samples CSV
- Data cleaning
etformat/clean.py
Analysis tools
- Trial QC report
etformat/report.py - Trial summaries
etformat/describe.py - Saccade amplitudes
etformat/saccade_analysis.py
Inspection and plots
- Recording metadata
etformat/edfinfo.py - Channel inspection
etformat/channels.py - Calibration review
etformat/calibration.py - Gaze plotting
etformat/plot_gaze.py - Saccade plotting
etformat/plot_saccades.py
Other components
- Researcher
- EDF recording
- EyeLink edfapi
Connections 21
- Researcher → CSV export: requests conversion
README.md - CSV export → EDFFile reader: loads recording
etformat/export.py - EDF recording → EDFFile reader: opens EDF
README.md - EDFFile reader → EyeLink edfapi: reads via
README.md - EDFFile reader → EDF structures: uses definitions
etformat/edffile.py - EDFFile reader → Table containers: builds tables with
etformat/edffile.py - Table containers → EDF structures: uses definitions
etformat/edfdata_containers.py - CSV export → Events and samples CSV: writes CSVs
README.md - Researcher → Data cleaning: requests cleaning
README.md - Researcher → Trial QC report: requests QC
README.md - Events and samples CSV → Trial QC report: reads events and samples
README.md - Researcher → Trial summaries: requests summaries
README.md - Researcher → Saccade amplitudes: requests amplitudes
README.md - Researcher → Recording metadata: requests metadata
README.md - Recording metadata → EDFFile reader: loads recording
etformat/edfinfo.py - Researcher → Channel inspection: requests channels
README.md - Channel inspection → EDFFile reader: loads recording
etformat/channels.py - Researcher → Calibration review: requests calibration
README.md - Calibration review → EDFFile reader: loads recording
etformat/calibration.py - Researcher → Gaze plotting: requests plot
README.md - Researcher → Saccade plotting: requests plot
README.md