WARNING: This tool is not currently intended for use by the general public. There is no documentation and it is currently intended to process data from specific protocols. You can still download it as is if you wish, but chances are it won't be of much help to you in processing your data :-)

Boogui

Boogui (named so after the great Boo, who was always keen to "go for the eyes") is a software dedicated to viewing and processing gaze data recorded with EyeLink or SMI eye trackers.

Boogui currently includes:

• Visualization of gaze data over time for each trial with target frames displayed
• A video view that plays back the trial with eye movements overlaid
• Filtering of SMI data based on fixation / saccade / blink parameters (e.g. duration). Compared to the default algorithm provided by SMI, it takes into account artifacts and allows to consider both dispersion and velocity for more accurate calculation of fixations.
• Output reports (.txt or .csv files) that can then be directly imported in statistical analysis packages such as Statistica or R for further processing.

Boogui currently implements experiments conducted during a thesis work conducted by Jessica Bourgin:

• Visual search
• Pro-saccade/anti-saccade (Reference)
• Gaze-contingent
• Saccadic choice

Any further experiment may be implemented upon request.

Install

Requirements

On Windows

1. Python 3.6

   This program requires Python 3.6. It was tested on versions 3.6.5 and 3.6.7.

2. PIP

   If pip is not installed, download get-pip.py and run:

python get-pip.py

3. PIPENV

   Dependencies are handled by Pipenv. To install Pipenv:

pip install pipenv

On Debian

1. Python 3.6

   This program requires Python 3.6. It was tested on versions 3.6.5 and 3.6.7.

2. PIP

   Further dependencies will be handled by the Pipenv, which requires the PIP package manager of Python. To install pip:

apt install pip

3. PIPENV

   Dependencies are handled by Pipenv. To install Pipenv:

pip install pipenv

4. MISC

   For ubuntu: see pypa/packaging-problems#211

sudo apt install libqt5multimedia5-plugins

sudo rm /usr/local/lib/python3.6/dist-packages/PyQt5/Qt/plugins/mediaservice/libgstmediaplayer.so

sudo ln -s /usr/lib/x86_64-linux-gnu/qt5/plugins/mediaservice/libgstmediaplayer.so /usr/local/lib/python3.6/dist-packages/PyQt5/Qt/plugins/mediaservice/libgstmediaplayer.so

Installation

Once the requirements are installed, the python environment is built by

pipenv install

Usage

To launch the gui, type

make run

or

pipenv run python test_gui.py