Introduction

Tobii Pro Lab is software used for eye tracking experiments with Tobii eye trackers. The software can be used for all stages in the experiment cycle (stimulus presentation, data recording, and gaze data analysis).

Availability, support and advice

Tobi Pro Lab is available for researchers at FSW Leiden. For managed work computers, it can be requested for at the ISSC through the helpdesk. For lab computers (if not already installed), please contact labsupport@fsw.leidenuniv.nl. A license for Tobii Pro Lab can be borrowed from SOLO through the Helpdesk (reservations tile). Full, Analyzer, and Recorder licenses are available (see License types information below).

SOLO provides support for Tobii Pro Lab. Whether or not to use Tobii Pro Lab for stimulus presentation and/or gaze data analysis depends heavily on the user's programming experience, task complexity and type of data to be analyzed (gaze/pupil). In general, although Tobii Pro Lab has an easy to use interface and can be used by researchers with no programming experience, its stimulus presentation capabilities are low and inflexible compared to other packages such as E-Prime or OpenSesame. Tobii Pro Lab provides good tools for gaze analysis (which would require extensive programming without Tobii Pro Lab), but for pupil analysis an option like the PhysioData Toolbox might be more suitable. For an overview of software that can be used with Tobii eye trackers, see the Tobii software guide

License types

SOLO owns multiple licenses of the following types (for overview of functionality see tables below):

  • Full: The Full edition contains all Pro Lab modules and can be used with all Tobii Pro Eye Trackers. All project types can be created.
  • Analyzer: The Analyzer edition is focused on glasses projects and data analysis. It therefore only contains the analyzer module. Only glasses project types can be created. However, Screen-based, Scene Camera and External Presenter projects can be opened and analyzed (but need to be created with the Full or Screen-based edition).
  • Screen-based: The Screen-based edition contains all three modules (Design, Record, Analyze), however, only Screen-based eye trackers can be used. Only Screen-based and Scene Camera projects can be created. External Presenter projects can however be opened (but need to be created with a Full edition).
  • Presenter: The Presenter edition is deprecated and is replaced by the Screen-based edition. With this edition, projects could be created and recorded, but not analyzed. The presenter licenses will keep working, however, updates are not created for these licenses. They can thus only be used in their original Pro Lab version.

Full license

LicenseProject types
 

Tobii-Pro-Lab-screen-based.jpg

Screen

Tobii-Pro-Lab-wearables.jpg

Glasses

Tobii-Pro-Lab-scene-camera.jpg

Scene Camera

Tobii-Pro-Lab-external-presenter.jpg

External Presenter (e.g. E-Prime)

Design  
Record 
Analyze

Screen based license

LicenseProject types
 

Tobii-Pro-Lab-screen-based.jpg

Screen

Tobii-Pro-Lab-wearables.jpg

Glasses

Tobii-Pro-Lab-scene-camera.jpg

Scene Camera

Tobii-Pro-Lab-external-presenter.jpg

External Presenter (e.g. E-Prime)

Design  
Record  
Analyze 

Analyzer license

LicenseProject types
 

Tobii-Pro-Lab-screen-based.jpg

Screen

Tobii-Pro-Lab-wearables.jpg

Glasses

Tobii-Pro-Lab-scene-camera.jpg

Scene Camera

Tobii-Pro-Lab-external-presenter.jpg

External Presenter (e.g. E-Prime)

Design    
Record    
Analyze

Tips & Tricks

  • Converting Tobii Studio projects to Tobii Pro Lab
    It is not possible to convert Tobii Studio projects to Tobii Pro Lab projects. Projects need to be created in Tobii Pro Lab from scratch.
     
  • Eye tracker set-up
    When connecting a screen based eye tracker to a computer for the first time, it needs to be set-up in the Eye Tracker Manager application.
     
  • Tobii Pro project location
    Make sure that the project is located locally (on the C: drive). The default location can be changed by clicking Browse in the Create new Project tab. Do not save the project (also not in exported form) in a folder that is synced with cloud storage such as OneDrive! This will potentially break the project.
     
  • TTL pulses to mark stimulus onset
    When enabled, Tobii Pro Lab sends a TTL marker (8 bit) to the parallel port at the onset of every stimulus on the Timeline, unless manually specified otherwise. The marker signal is active for 34 ms. Marker values can be specified manually per stimulus or can be automatically chosen by Tobii Pro Lab (increasing number per stimulus starting from 1). Tobii Pro Lab sends the TTL markers when it estimates that the stimulus has appeared on the screen. This estimation uses a zero lag display and a 10 ms screen latency (the screen latency can be adjusted in the lower left corner of the Record tab, see also the Screen latency point below). It is not possible to send information from Tobii Pro Lab to any port other than the parallel port, therefore, synchronization options are still limited when using Tobii Pro Lab on a laptop. Note that TTL pulses will only be sent at the onset of stimuli. Instruction elements, for example, are not stimuli and therefore TTL pulses cannot be sent. Only images and movies are stimuli. It is also possible to receive TTL pulses (TTL-in markers) for synchronization purposes, but only for Pro Spectrum and Tobii Pro TX300 eye trackers.
     
  • Using two screens
    Tobii Pro Lab does not support presentation screens that have the Windows screen duplication setting enabled. Tobii Pro Lab does support two screens in extended mode. On one screen, the task is presented to the participant. On the other screen, it is possible to enable a Moderater view on which the experimenter can view the track status, the stimuli displayed, and a gaze data live view. Note that the live view feature is performance demanding and may cause timing issues with stimulus display in computers with lower specifications.
     
  • Screen latency
    Tobii Pro Lab timestamps the moment when the application assumes that a stimulus was displayed. This assumption is based on the screen latency. This is the delay between sending a stimulus to the screen and the screen displaying it. The screen latency needs to be entered manually in the Record tab (default is 10 ms). The screen latency can be found in the screen’s technical specifications.
     
  • Import glasses project
    Import a glasses project (*.ttgp) directly from the SD card. Do not move the project from the SD card to a different location, and then import it. 

FAQ

TopicQuestionAnswer
I cannot import my glasses project Make sure to import the project (*.ttgp file) directly from the SD card. Use an SD card reader to be able to read an SD card on your computer.
I cannot open my project anymore. Tobii Pro Lab tries to open it, but then shuts down without giving an error/warning message. It is possible that the project is corrupt. Tobii support can usually help with this. Ask labsupport to contact Tobii.
I cannot create a project. Tobii Pro Lab either creates an "empty" project (all tabs are just completely empty) or shuts down without giving an error/warning message. 

In version 1.181 issues with creating a project have been observed. This is due to Tobii Pro Lab trying to bind to port 8080, but can't, because another application is already using this port. In case of FSW lab computers, it seems that NIApplicationWebServer is using port 8080. This is a National Instruments application, part of the National Instruments runtime, used by and installed with BioSemi Actiview.

A workaround is using an older version of Tobii Pro Lab, or disabling the application using port 8080. When this happens on a lab computer at the FSW, contact labsupport.

Tobii Pro Lab crashes Make sure to store your project on the local C-drive. Do not work from a network drive (such as the University J-drive or P-drive)/
Videos are not shown smoothly. A black screen precedes the videos and the videos stammer at the start.  

The black screen before the video seems to be an issue in older version of Tobii Pro Lab. In the newer version (from 1.194) this does not occur anymore.

Make sure to use the preferred system requirements.

Even when the system requirements are met, issues with playing videos smoothly in Tobii Pro Lab can occur. Pro Lab's performance is just not optimal when working with videos. For optimal performance and precise timing, it is advised to use Tobii Pro Lab with E-Prime, so that E-Prime can handle stimulus presentation, but the (gaze) data can be analyzed in Tobii Pro Lab.

Tobii Pro Lab External Presenter with E-Prime does not work. Because of a bug in Tobii Pro Lab 1.194, Tobii Pro Lab cannot be used with E-Prime.

Resources