Skip to contents

glasses3 0.1.0

  • Initial release.
  • Reads Tobii Pro Glasses 3 recording folders directly from the SD card: gaze and pupil data, IMU data, events and metadata. Lines that cannot be parsed, such as the cut-off last line of an incomplete file, are skipped with a warning. A file whose compressed data are damaged gives an error.
  • The readers accept several recording folders, or the output of list_g3_recordings(), and add a recording column. Sync port, epoch and plotting functions work per recording.
  • g3_syncport(), g3_add_syncport() and g3_epochs() align samples with sync port pulses, and g3_pupil_long() reshapes pupil data to one row per eye.
  • g3_fill_gaps() inserts empty rows for missing samples. The recording column and columns you added that have one value per recording, such as a participant column, are copied into the new rows.
  • g3_gaze_angles() adds azimuth, elevation and vergence angles.
  • g3_downsample() averages samples into fixed time bins, for example before fitting generalised additive mixed models. Its by argument keeps further grouping columns, such as participant or condition.
  • plot_g3_pupil() and plot_g3_gaze() share one style, available as theme_g3() for other plots. The left eye is always slate blue and the right eye always Indian red, a pair checked for colour vision deficiencies. Given epochs, plot_g3_pupil() plots the time from the pulse onset, with one line per pulse and the mean. Its smooth argument draws a running median over the raw trace.
  • Data are returned as tibbles, and grouped tibbles keep their groups. The internals use dplyr, tidyr, purrr and stringr.
  • Gaze, pupil, IMU and sync port data were checked against Tobii Pro Lab exports of seven 50 Hz recordings and agree up to the rounding of the exports. 100 Hz data are covered by synthetic test recordings.
  • citation("glasses3") gives the reference for the package, with the version number from DESCRIPTION.