Skip to content

Manual Mapper

Manual Mapper header image

The Manual Mapper offers a simple interface for manually mapping fixations to a reference image, aiding gaze data visualization and analysis. Click on the reference image to map a fixation and the recording auto-advances to the next one. Fixations outside the image can be marked by clicking beyond the image boundary.

Setup

  • Upload a Reference Image: Upload the image you want to map fixations on.
  • Map Fixations: Begin mapping the recorded fixations onto the reference image by clicking the corresponding location on the image. If a fixation does not fall on the reference image, use the keyboard shortcut S.
    • The field Fixation shows the ID of the current fixation.
    • The field Recording Mapping Progress indicates how many fixations have been mapped within the specified enrichment section.

In the example below, we manually map the fixations detected between the epoch_start and epoch_end events. This section includes 44 fixations in total, and we currently map the fixation with ID 72.

Manual Mapper image one

You will see all fixations and their durations visualized in the timeline below.

Manual Mapper image two

Export Format

fixations.csv

This file contains fixation events detected in the gaze data stream and mapped to the reference image.

FieldDescription
section idUnique identifier of the corresponding section.
recording idUnique identifier of the recording this sample belongs to.
fixation idIdentifier of fixation within the section. The id corresponds to the fixation id of the raw unmapped data.
start timestamp [ns]UTC timestamp in nanoseconds of the start of the fixation.
end timestamp [ns]UTC timestamp in nanoseconds of the end of the fixation.
duration [ms]Duration of the fixation in milliseconds.
fixation statusTrue if the fixation was mapped inside the reference image, False if it was marked as outside of the reference image, and Not mapped if the fixation was not mapped at all.