Skip to content

JohnBacho/VIBES-Lab-Project2-CSV-Processor

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

21 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

CSV Eye-Tracking Processor

CSV Processor Logo

License: CC BY-NC 4.0 JavaScript Platform Status


📖 Overview

CSV Eye-Tracking Processor is a lightweight JavaScript tool that reads raw eye-tracking CSV files and outputs cleaned, trial-averaged data ready for analysis.

This updated version introduces:

  • Baseline calculation used to calculate change
  • Trial summary metrics for CS+ and CS- stimuli
  • Flexible handling of VR and non-VR datasets
  • Automatic generation of summary CSVs with combined trial averages 2-trial blocks grouped by CS+ or CS-

⚠️ Supports VR-based eye-tracking (HTC VIVE Pro Eye) and Tobii eye-tracking datasets created in Project 1.


🛠️ Features

  • Column filtering – Only relevant columns are retained (Date, LocalTime, Phase, TrialNumber, Step, Stage, Context, leftEyePupilSize, rightEyePupilSize, GameObjectInFocus)
  • Trial-based aggregation – Computes average pupil size and baseline-corrected pupil size per trial
  • Proportion of gaze on objects of interest (GOI) automatically computed per trial
  • Baseline handling – Uses instruction phase to calculate baseline for all subsequent trials
  • Context classification – Automatically tags data as AAA or ABA depending on unique context characters
  • Hardware detection – Differentiates between VR and non-VR data based on headers
  • Summary CSV generation – Outputs CS+ and CS- averages for all metrics
  • Automatic CSV download – Processed file named Program_[Hardware]_[ContextType]_DONE.csv

📥 Usage

  1. Open the HTML page in your browser: Live Demo
  2. Select your raw CSV file using the file input.
  3. Optionally, enter a program name in the text field (spaces will be removed automatically).
  4. The script processes the file and downloads a cleaned CSV, including trial averages and summary metrics.

Runs entirely in-browser using JavaScript FileReader, no server needed.


⚙️ How It Works

  1. Reads CSV and splits into rows/columns

  2. Filters only the required columns

  3. Computes:

    • Average pupil size per trial
    • Baseline-corrected pupil size using instruction-phase baseline
    • Proportion of gaze on target objects (GOI)
  4. Detects baseline switches and updates baseline values dynamically

  5. Generates a new CSV including:

    • Trial-level averages
    • Baseline-corrected averages
    • GOI metrics
    • Combined summary for CS+ and CS- trials

👥 Core Team

Name Major
John Bacho Computer Science
Lauren Dunlap Computer Science
Albert Selby Computer Science / Data Science
Marissa Brigger Neuroscience
Alexa Gossett Neuroscience / Psychology
Jace Lander Software Engineer
Corey Schwarz Computer Science / Data Science
Cydney Hudson Neuroscience
Olivia Mullins Neuroscience

📄 License

This project is licensed under CC BY-NC 4.0.


📧 Contact


Made with ❤️ by the VIBES Lab Team

About

A website designed for the Virtual Immersive Behavioral Science Lab at Baldwin Wallace University to help process eye tracking and gambling data faster

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors