1 of 23

Data Viewer 3.1

Sam Hutton

2 of 23

Data Viewer 3.1

Outline:

​

  • Background / Basics
  • Recent additions

1) Aggregate Mode / Aggregate Reports

2) Creating Static, Dynamic, Difference Fixation Maps (Heat Maps)

3) Interest Area Manipulation

4) Time Series (Binning) Reports

5) Multiple Interest Period Creation

6) Event Editing

3 of 23

SR-Research Timeline

Sam Hutton, Marcus Johnson

​

SR Research Ltd

(Me and Ben Tatler buy the first EL-IIs in UK)

Jiye

4 of 23

  • Added "Add/Edit Event Mode" the Temporal Graph View
  • Added grid lines to the Temporal Graph View
  • Added a sample cursor line to the current mouse position in the Temporal Graph View
  • Added "Sample Info" button and floating window to the Temporal Graph View
  • Added interest period boundaries to the Temporal Graph View
  • Supported displaying dynamic interest areas in the Temporal Graph View
  • Added "IA Shape Actions" option to support the following operations when interest areas are selected:
    • Conversion between different interest area shapes
    • Horizontal or vertical flip
    • Rotating interest areas
    • Resizing/rescaling interest areas
    • Moving interest areas
  • Added interest area "Link" option to replace multiple interest areas with a linked object; added "Unlink" option to restore the original interest areas
  • Added "Create Output Report for all Custom Interest Periods" option to the Reports
  • Added option to create multiple consecutive duration-based interest periods
  • Added "Use Average Aggregate Cursor" option to Animation View Preferences
  • Allowed to import messages relative to the currently-selected interest period
  • Added "Gaze Cursor Transparency (0.0 - 100.0)" to Animation View Preferences
  • Added "Video Handler" option to Animation Preferences (Windows version only)
  • Added support for playing back .mov video files in the Animation View (for the data collected with SR Research Experiment Builder)
  • Added the following variables to the Trial Report:
    • MEDIAN_SACCADE_AMPLITUDE
    • MEDIAN_FIXATION_DURATION
  • Added the following variables to the Saccade and Fixation Report:
    • CURRENT/PREVIOUS/NEXT_SAC_BLINK_START
    • CURRENT/PREVIOUS/NEXT_SAC_BLINK_END
    • CURRENT/PREVIOUS/NEXT_SAC_BLINK_DURATION
  • Provided options to create a shorter sample report (i.e., down-sampling)
  • Added "File -> Unpack" menu option
  • Added "Selected Freehand Point" property to freehand interest areas for the precise adjustment of vertex coordinate
  • Added "Remember Last Browsed Directory" for some default directories
  • Added HTARGET_DISTANCE_BIN, HTARGET_X_BIN, HTARGET_Y_BIN, SAMPLING_RATE, and SAMPLE_INTERVAL variables to the Time-Course Analysis Report
  • Added "Start Event Offset" option to the Reaction Time Definitions
  • Added "Animation Background Color" to the Animation View preferences
  • Added "Apply Blink Correction in the Sample Report" option to the Data Filters preferences

​

Data Viewer 3.1

5 of 23

What is in the .edf?

A mixture of Samples, Events and Messages – all of which are time stamped

6 of 23

Samples

Samples contain Time, X, Y (in screen pixels) and pupil size (in arbitrary units)

6079861 503.7 680.3 972.0 .....

Extra columns can contain information such as resolution (ppd) / Velocity / Input status

​

Missing samples are reported as “.”

7 of 23

Events

Events are either Fixations, Saccades, or Blinks (which are always wrapped in a saccade).

Saccade / Fixation events always come in pairs…

​

8 of 23

Messages typically flag up trial events such as stimulus onset / keyboard response etc:

​

​

Some messages are intended specifically for Data Viewer:

​

​

9 of 23

What is NOT in the .edf?

  • Trial Stimui such as images / text / Videos
  • Interest Areas

​

​

​

​

​

​

​

​

​

​

​

​

​

​

The .edf contains *pointers* -special messages that tell DV where to find the trial resources / where to draw the IAs.

​

​

10 of 23

  • Trial Grouping is incredibly useful / powerful
  • But it works best if you remember to include useful grouping variables in your experiment…
  • They can always be added via the Trial Variable Manager and Trial Variable Value Editor

Trial Grouping / Aggregate Mode / Aggregate Reports

11 of 23

  • Allows data that has been aggregated over trials / participants (e.g. via Trial Grouping) to be VIEWED
  • Dynamic Heatmaps / Bee-swarm
  • Also enables the creation of aggregate reports (useful for exploratory data analysis)
    • Aggregate Event Statistics Report
    • Aggregate Interest Area Report

​

​

​

​

Aggregate Mode

12 of 23

  • Heat maps can be created for individual trials or groups of trials
  • A meaningful comparison of heatmaps requires that they both have the same scale
  • Alternatively – create difference maps

Fixation (Heat) Maps

13 of 23

  • Create Left / Right Eyes, Mouth / Nose (adjust points)
  • Save as template
  • Apply to all trials (using grouping trick)
  • Resize Edges of WholeFace
  • Resize Eyes by %
  • Flip IAs vertically and apply to upsidedown faces
  • Rotate selected IAs by 45degs
  • Unrotate and link (converting to freehand first)
  • Rotate again

​

​

Interest Area Manipulation

14 of 23

Time Series (Binning) Analysis:

Very useful for Visual World tasks

​

​

Data Viewer: Time Series

​

“The dog hated the shark at the boxing match because he...”

​

But also very useful for any experiment involving dynamic stimuli (e.g. videos) and even pupillometry research.

15 of 23

Preparing the Data…

​

  1. Import multiple .edf files
  2. Save Viewing Session….
  3. Remove Practice Trials
  4. Check messages (add more if nec…)
  5. Create Interest Period
  6. Check Cyclopean Mode

​

16 of 23

Most research is monocular, but sometimes you have to record from the “other” eye…

Things can get complicated when choosing LEFT_ / RIGHT_ variables for DV Reports….

​

Top Tip!!!

Check the Cylopean Mode preference and the AVERAGE_* Variables will contain data from whichever eye was recorded.

​

​

​

Data Viewer: Time Series

17 of 23

Data Viewer: Time Series

18 of 23

Simultaneously create multiple sequential Interest Periods:

Interest Periods

19 of 23

Simultaneously create Reports for all Interest Periods:

Data Viewer

20 of 23

Event Editing: Saccades and Fixations can be edited and inserted

​

Data Viewer: Event Editing

Relevant metrics (e.g. duration of saccade and subsequent fixation are automatically updated.

Boj003.wav: Trail 35

21 of 23

Event Editing: Saccades and Fixations can be edited and inserted

​

Data Viewer: Event Editing

Relevant metrics (e.g. duration of saccade and previous / subsequent fixation are automatically updated.

Undo saccade insertions by deleting or merging fixations

22 of 23

Thank you – any questions?

23 of 23

Eye tracking data analysis used to be a lot harder....

Raw data was a printout…

Or voltages for x / y position

Researchers had to write their own software to “automate” any analysis