Eye Movement Analysis Tool

Overview

This is a Python-based tool for analyzing eye movement data collected during experiments. The tool provides functionalities to visualize eye movements on images, create heatmaps, and perform various data analysis tasks. This tool uses edfImport for initial preprocessing of the data.

Table of Contents

• Installation - User
• Usage
• Features
• Getting Started
• Project Architecture
• Results
• Requirements

Installation - User

1. Clone this repository to your local machine: https://github.com/sigalgrabois/EyeMovement_Analysis_Tool.git
2. Navigate to the project directory
3. Unzip Eyemovement.zip file
4. Run the exe file in the dist folder.
5. The application will launch a graphical user interface (GUI) for interacting with eye movement data and images.

Usage

1. Run the application Eyemovement.exe.
2. Run the script app.py from the cmd in the working directory.

Features

• Data Loading: Process and load eye movement data from edf files to CSV files.
• Image Visualization: Display images with eye movement trails.
• Heatmap Creation: Generate heatmaps to visualize eye movement patterns.
• Single Participant View: Analyze data for a single participant.
• Multi-Participant View: Analyze data for multiple participants on the same image.
• Data Export: Export analyzed data and visualizations.

Getting Started

In order to run the two parts of the eye movement analysis that the tool offers, you must make sure that you have the images.xlsx file provided with the project. When you click on the "Single Participant" or "Multi Participant" button, you will first be asked to insert a path to the file containing the data of the images. You must enter images.xlsx and continue according to the instructions.

1. Load Eye Movement Data:

   • Click the "Load Data" button to preprocess and load eye movement data.

2. Single Participant Analysis:

   • Click the "Single Participant" button to analyze data for a single participant.
   • Choose an image from the dataset and view eye movement trails.

3. Multi-Participant Analysis:

   • Click the "Multi Participant" button to analyze data for multiple participants.
   • Select an image to view eye movement trails of all participants on the same image.

4. Export Results:

   • Save visualizations or analyzed data as needed.

Project Architecture

This section provides an overview of the project's architecture, showing how different components interact.

Results

Visualization of 1 participant with 1 picture and their eye movements on the picture:

Visualization of a heatmap next to the eye movements trajectory:

Visualization of one picture with multiple eye movements of different participants:

Requirements

• Python 3.7
• MATLAB installed