Scanpath Analysis

What It Is

Scanpath analysis records the ordered sequence of fixation targets for each participant. A fixation is confirmed when a participant dwells on the same object class for a configurable number of consecutive frames, filtering out transient glances and capturing deliberate visual attention shifts.

Research Context

Scanpath analysis is used in visual search strategy research, expertise studies, reading pattern analysis, and comparative viewing behavior experiments. By capturing the order in which participants inspect objects, researchers can identify systematic exploration strategies, compare novice versus expert scanning patterns, and quantify differences in viewing behavior across conditions or groups.

How MindSight Detects It

The algorithm uses dwell-based fixation detection per participant:

1. For each (face_idx, object_class) pair, maintain a dwell counter:
2. If the participant is looking at that class, increment the counter.
3. If not looking, decrement the counter (minimum 0, then remove the entry).
4. When a counter reaches exactly dwell_threshold and the class is a new fixation target (different from the participant's current fixation), record it in the scanpath.
5. Each participant accumulates an ordered list of (class_name, frame_no) entries representing their fixation sequence.

flowchart TD
    A[Track per-face hit classes from gaze events] --> B[Update dwell counters\nincrement if looking, decrement if not]
    B --> C{Counter reaches\ndwell_threshold?}
    C -- No --> A
    C -- Yes --> D{Is this a new target\ndifferent from current fixation?}
    D -- No --> A
    D -- Yes --> E[Add class_name + frame_no to scanpath]
    E --> A

Parameters

Parameter	Type	Default	Description
--scanpath	flag	disabled	Enable scanpath recording
--scanpath-dwell	int	8	Number of consecutive frames of dwell required to confirm a fixation

Output

CSV (scanpath): Each row contains participant and a semicolon-separated fixation sequence (e.g., knife;cup;plate).

Dashboard: A "SCANPATH" panel shows the last 3 fixations per participant in the format P0: knife->cup->plate.

Console: Reports fixation data via csv_rows.

Time-series: Plots total fixation count over time.

Example

python MindSight.py --source video.mp4 --scanpath --scanpath-dwell 12

Related Phenomena

• Attention Span -- measures dwell duration on individual targets
• Gaze Aversion -- objects absent from the scanpath may indicate avoidance

Source

Phenomena/Default/scanpath.py