LabMaestro
Breadcrumbs

Free Viewing Experiment

Introduction

This project template demonstrates how to utilize the TRACKPixx3 eye tracker to replicate Yarbus's (1967) findings, which showed that viewing patterns change in response to task demands.

In this demo, we present a painting three times and collect 8 seconds of free viewing per presentation. Before each viewing, a different question is asked relative to the painting. After collecting gaze data, we can visualize fixations overlaid over the visual stimulus for initial inspection.

Prerequisites

  • LabMaestro is installed and activated.

  • An eye-tracking device (e.g., TRACKPixx3) is connected to your computer via an I/O hub (e.g., DATAPixx3).

Project Files

FreeViewingDemo.lm

Step 1 - Tracker Calibration & Instructions

An optional calibration step is included in the template experiment. If you have not previously calibrated the tracker, you can initiate a Calibration routine by pressing the N key. This routine loops until the average offset measured during validation is lower than the acceptable offset defined in the Validate Tracker component (named Validate). If the tracker is already calibrated, press Y to view instructions and begin the experiment.

image-20251024-191000.png
The first timeline of the experiment. It is used to perform a tracker calibration if requested, and then shows the task instructions.

Step 2 - Data Collection

Once the calibration step is complete, we use a Constant Stimuli method to show three trials with different tasks. Participants will examine the Luncheon of the Boating Party painting by Auguste Renoir and complete three tasks presented in random order. The questions asked are:

  1. In the image, what time of day is it?

  2. In the image, what is the average age of the group?

  3. In the image, what is the overall mood of the event?

image-20251024-192324.png
Variables used in the constant stimulus method. One holds the question string (used in the questionDisplay parameter), and the other is simply an index, used to name data files.

This is implemented in the timeline below, which loops for each trial. Looping is automatically performed to cover all the conditions defined in the Method component. A separate fixation data file is saved for each trial. The file is named after the Subject ID and trial number.

image-20251024-192514.png
Second timeline of the experiment. First, the trial question is shown. Then, the recording starts, the stimulus is displayed on the screen for 10 seconds, and fixation data is saved.

Step 3 - Data Visualization

We have included sample data in this demo to highlight data visualization using LabMaestro. It can be viewed by clicking Recordings, Sample Data, and selecting the session 202410291457. Three .trk files are available for each question. For example, here is the content of sampleData_1.trk file (In the image, what time of day is it?). Feel free to examine fixation data for the other trials as well.

image-20251024-194838.png
Fixation data plot in LabMaestro. X and Y axes are pixel coordinates, with 0 corresponding to the screen's center.

By default, the data visualization window plots fixations relative to screen coordinates (with point [0, 0] at the center of the screen).

image-20251024-194911.png
All visualizations available in LabMaestro (Version 1.8.1)

For this demo, we can use the default X vs Y plot. To better understand this data, we can add the visual stimulus to the background of the visualization window. As the stimulus fills the full screen, select the stimulus (Renoir-Boating.jpg) in the Background property.

For this demo, we can use the default X vs Y plot. To better understand this data, we can add the visual stimulus to the background of the visualization window. As the stimulus fills the full screen, select the stimulus (Renoir-Boating.jpg) in the Background property.

image-20251024-195545.png
Editing the Background property.

This will change the data plot to look like the figure below, making it much easier to interpret the data:

image-20251024-200131.png
Fixation data for the trial “In the image, what time of day is it?” overlaid on the visual stimulus.

If you wish to export data to run more in-depth analyses using your preferred programming language, right-click Recordings in the Project tab and select Export. You can export all recordings saved in your project to the BIDS format.

TRACKPixx3 page

Calibration with TRACKPixx3

Gaze Contingent Window