GazePlotter
Documentation Chapters

Scarf Plot

The Scarf Plot (or sequential graph) is a chronological visualization of eye movement data showing the sequence of fixations and saccades over time. Specific Areas of Interest (AOIs) in the stimulus are color-coded and displayed as contiguous horizontal strips. It is the primary visualization for detailed sequential analysis of visual search and scanpaths across participants or stimuli.

Plot Operations: For general canvas operations (moving, resizing, duplicating, or removing plots), see Plot Manipulation.

Metric Contract

  • Metric Contract: This visualization renders eye-tracking sequences directly and does not consume metrics from the Metric Library.

Configuration via Pane

Clicking the Scarf Plot card in the workspace selects the plot and opens its configuration options in the sidebar Pane (or bottom sheet on mobile). The settings are organized into the following collapsible sections:

Stimulus

Choose the stimulus to analyze. Each stimulus contains its own set of Areas of Interest (AOIs) which will be displayed in the scarf plot.

  • Edit stimuli & selections…: Opens the Stimuli Library to manage stimulus files.

Participants

Filter the eye-tracking data by a participant selection.

  • Participant selection: A dropdown containing All, Non-empty, and saved participant selections.
  • Edit participants & selections…: Opens the Participant Library to rename, merge, and build participant selections.

Visualisation

Configure the timeline representation mode.

  • Timeline mode: Choose how the sequence is arrayed along the horizontal axis:
    • Absolute: Displays fixations and events plotted in their exact chronological timing (in milliseconds).
    • Relative: Scales and displays sequences proportional to the participant with the longest dwell time for cross-participant comparability.
    • Ordinal: Displays strict sequential order indices of individual fixations, saccades, and other events, discarding exact durations.

Time range [ms] / Ordinal range [indices]

Defines temporal or index boundaries. GazePlotter automatically matches this section to the active timeline mode:

  • Time range [ms] (in Absolute or Relative mode): Limit sequence start and end times (ms) (0 = Auto).
  • Ordinal range [indices] (in Ordinal mode): Limit sequence by start and end fixation indices (0 = Auto).

Areas of Interest

Narrows which AOIs this plot ranges over.

  • AOI selection: A dropdown containing All and saved AOI selections; AOIs outside the picked selection count as no-AOI in this plot.
  • Edit AOIs & selections…: Opens the AOI Library to customize names, colors, merges, and selections.

Eye-movement Types

Narrows which non-fixation categories (e.g. Saccades, Blinks) this plot draws.

  • Eye-movement type selection: A dropdown containing All, None, and saved eye-movement type selections. Pick None for a “Fixations only” view.
  • Edit eye-movement types & selections…: Opens the Eye-movement Type Library to customize classification categories and selections.

Events

Narrows which event channels this plot overlays. Event channels render as an overlay — time-coded colored strips below each participant’s gaze baseline — in Absolute and Relative modes whenever the stimulus has event data.

  • Event selection: A dropdown containing All, None, and saved event selections (matched by displayed channel name, portable across stimuli). Pick None to hide the event overlay.
  • Edit events & selections…: Opens the Event Library to customize event names, colors, ordering, and selections.

Export

Located at the bottom of the Pane:

  • Download plot…: Opens the Figure Export dialog to save the scarf plot as a PNG or JPG.
  • Export Data: To export raw fixation sequences, timing, and AOI mapping data as CSV, see Segmented Data Export.

Interactivity

The scarf plot is highly interactive:

  • Sequence details: Hovering over any fixation, saccade, or event strip displays a tooltip with details (e.g. duration, start/end times, and AOI or event name).
  • Highlighting: Hovering over a category (fixation, saccade, or specific AOI/event channel) in the legend temporarily highlights all matching segments across all participants and dims the rest. Clicking a legend category toggles a persistent highlight.

Event Data Layer

GazePlotter supports event data (e.g., dynamic AOI visibility intervals) displayed under the participant gaze sequence. In Overlay mode, time-coded events hang below a shared baseline as colored strips. Overlapping events stack into lanes, and a thin gray line divides participants. Event data is displayed only in Absolute and Relative time views.