Launch app App
Documentation Chapters

Workspace Overview

The GazePlotter Workspace is your central analysis dashboard. It operates as an interactive single-page canvas where you can arrange plots, configure metrics, and manage your dataset libraries.

Workspace Layout & Interface Terms

The app has four parts: the header above, the rail on the left, the canvas, and the pane on the right.

+------------------------------------------------------------------------+
|  GazePlotter              Import   Export   Metadata   [Read guide]    |
+------------------------------------------------------------------------+
|     |                                                    |             |
|  R  |                                                    |             |
|  A  |                      CANVAS                        |    PANE     |
|  I  |                    (plot grid)                     |             |
|  L  |                                                    |             |
|     |                                                    |             |
+------------------------------------------------------------------------+

Along the top edge of the app:

Rail

A narrow column on the left side of the canvas (a strip along the bottom on phones):

  • Add Visualization (+ icon) lists the plots in three sections, Where they looked, Sequences and Metrics, each with a picture and a one-line description. Type in the search box to filter them by name or by other terms such as “gaze plot” or “dwell time”; Enter adds the first match. Plots the loaded data cannot feed, such as Event Comparison without event data, are listed last under Not available for this data with the reason. The new plot lands in the first free space. With one plot selected, the new plot opens on the same stimulus and participant selection. Right-click empty canvas for the same list, without the search box, as Add visualization here: the plot lands where you clicked, or at the nearest free spot when something is in the way. With one plot selected, the item says the new plot takes that plot’s stimulus and participants. That menu also offers Select all plots, Zoom to fit and Download all plots (the figure export with every plot ticked).
  • Undo and Redo.
  • Zoom to fit shows every plot at once. Below it, Zoom in, the current zoom level (click it to return to 100%), and Zoom out.
  • On a phone, selecting a plot swaps the strip to Edit plot settings and Deselect.

Moving around the canvas

The canvas works like a map:

  • Pan: drag empty space, drag with the middle mouse button (also over plots), or scroll with the mouse wheel or touchpad (hold Shift to scroll sideways). On a touch screen, drag with one finger or two; a finger on a selected plot moves the plot instead.
  • Zoom: Ctrl / Cmd + scroll, pinch on a touchpad or touch screen, or Ctrl / Cmd + + / -. Ctrl / Cmd + 0 returns to 100%.
  • Zoom to fit: Shift + 1, or the button in the rail.
  • You can always pan a little past your plots, but never so far that they all leave the screen. If the selection is out of view, an arrow at the edge of the canvas points to it; click the arrow to bring it back. With several plots selected, the arrow points at the group and brings the whole of it back.

Canvas

The central area of the screen where plots are arranged.

  • Selection: Click any card to select it (or hold Cmd / Ctrl / Shift to select multiple). Holding the same keys and dragging across empty canvas draws a selection rectangle: every plot it touches joins the selection. Ctrl + A (Cmd + A on Mac) selects every plot. Selection opens the Pane and reveals card controls.
  • Canvas Operations: Drag, resize, duplicate, or delete cards to arrange your grid. For details, see Plot Manipulation.

Pane

A collapsible panel located on the right side of the screen.

  • Pane Activation: Opens automatically when you select any plot card on the canvas.
  • Collapsible Settings: Customize parameters (e.g. Stimulus, Participant selection, Participant, Time Range, Areas of Interest, Events, Eye-movement Types, Metric). See Visualization Configuration Pane for details.
  • Batch Editing: Modify settings for multiple selected plots simultaneously (mixed plot types only expose shared options). A setting the selected plots disagree on shows Mixed, and a color shows each plot’s color as a stripe; editing it applies the new value to all of them.
  • On a phone: the pane rises as a sheet along the bottom edge. Pull it down by the handle above its title, or tap the canvas behind it, to close it.

Plot Manipulation

To perform any manipulation (moving, resizing, duplicating, or removing), you must select the target plot card first by clicking it. Clicking empty canvas space deselects it.

Moving a plot

With the plot selected, the whole card is a drag target: click and drag anywhere on the card frame to move it. Plots snap to a 40×40 pixel grid. Hold a plot near the edge of the canvas and the view moves along, so you can place it anywhere, including above or to the left of all other plots. With several plots selected, drag any one to move them all together. The arrow keys move the selection one grid cell at a time.

Resizing a plot

Drag any of the four corner handles on a selected plot. The card snaps to the grid as it resizes.

A selected plot carries a small chip that floats just above its outline’s top-left corner, holding two buttons: Duplicate and Remove. Hover either one for its name and shortcut.

Right-click a plot for its verbs at the pointer, grouped: Settings and Zoom to plot (fits it to the view, at most 100%); Duplicate, Next stimulus and Previous stimulus; Copy as image (puts the figure on the clipboard, ready to paste into slides or a document; Ctrl+C), Download plot and the pane’s Download data or Download segments when the plot has one; and Remove. When the plot is the selection, each item shows its shortcut at the right. Right-clicking leaves the selection as it is (Settings selects the plot, and is left out while its pane is open); on a plot that belongs to a multi-selection, the items act on the whole selection (there is no Copy as image, since the clipboard holds one image).

Duplicating a plot

Click Duplicate in the chip, or press Ctrl+D (Cmd+D on Mac). The copy keeps every setting: participant selection, stimulus, axis bounds, colors. The copy is selected, so Alt+Down (Option+Down on Mac) right after puts it on the next stimulus: two keys for a side-by-side comparison.

With several plots selected, the chip moves to the group’s outline and duplicates all of them at once, keeping the arrangement they are in: the copies land together, in the same shape, in the first free space that fits them. They become the new selection, and one Undo takes them all back.

Removing a plot

Click Remove in the chip, or press Delete (Backspace on Mac). With several plots selected, the chip on the group’s outline removes all of them in one step.

Keyboard shortcuts

On a Mac, use Cmd wherever the table says Ctrl (Delete is Backspace). Shortcuts that act on plots work when no dialog is open and you are not typing in a field.

ShortcutAction
Ctrl + OImport data or a workspace
Ctrl + SSave the workspace (Ctrl + Shift + S: save as)
Ctrl + Z / Ctrl + YUndo / redo
Ctrl + ASelect every plot
Ctrl + DDuplicate the selected plots
Ctrl + CCopy the selected plot to the clipboard as an image (when no text is selected)
DeleteRemove the selected plots
Arrow keysMove the selected plots one grid cell
Alt + Up / DownShow the previous / next stimulus in the selected plots (Option on Mac)
EscClose the dialog or pane, or clear the selection (in a text or number field, the first Esc only leaves the field)
Shift + 1Zoom to fit
Ctrl + + / - / 0Zoom in / out / back to 100%
Letters in an open menuJump to the item that starts with them
Enter / Shift + Enter in a library’s name fieldMove to the next / previous name, for renaming a list in one pass
Up / Down, Home / End or letters on a focused dropdownPick the previous / next, the first / last, or the first option that starts with the letters, without opening it
Right-clickA plot: its verbs; empty canvas: add a plot there; a dialog list item or selection chip: select only it, or all but it
?Open this shortcut list in a new tab

Customization Libraries

GazePlotter includes dedicated libraries to customize and configure how your data is grouped, colored, named, and calculated:

  • AOI Library: Control how Areas of Interest (AOIs) are colored, labeled, merged, and narrowed with selections. Managed per stimulus.
  • Event Library: Color-code and group event markers, and pair start/end events to derive custom event intervals.
  • Eye-movement Type Library: Configure and customize classification categories (like fixations, saccades, and blinks) by renaming, recoloring, merging, or saving selections, across the workspace.
  • Participant Library: Rename participant labels individually or in bulk (using regular expressions), sort or reorder the active participant sequence, and build named participant selections for cross-cohort comparisons.
  • Stimuli Library: Manage stimulus names, perform bulk regex renaming, and reorder stimulus lists.