/gazer

Functions for reading and pre-processing eye tracking data.

Primary LanguageR

Binder Open in Code Ocean gazeR 0.0.1.2

gazeR:A package to analyze gaze position and pupil size data

For a detailed overview of how to use gazeR, please see the vignettes and posted pre-print for SR Reports (https://psyarxiv.com/gvcxb/) and more generalized processing(https://psyarxiv.com/4qwr8)

Help

Please use the issues tab (https://github.com/dmirman/gazer/issues) to file any bugs or suggestions.

Updates (December 2020)

Added a new blink detection algo based off Mathot (2013). This algo detects large negative and positive chanages in the pupil size and labels them as blinks. The algorithm has four parameters that need to be adjusted based on the particulars of the data: the amount of smoothing, the (negative) onset velocity threshold,the (positive) reversal velocity threshold, and the temporal margin. This is a major addition in my eyes as some ETs do not even include blink detection.

Updates (May 2020)

Added functionality to scale pupil size to dynamic pupil range (Ayasse et al., 2017; Piquado et al., 2010). This requires you to record participant pupil size in bright and dark conditions.

Updates (March 2020)

Good news! Gazer is now up on Code Ocean! Click on the Code Ocean button at the top. You can download the capsule to run the package and analyze your data with it. No more worrying about package or OS incompatabilites--it will run on all systems!

Here is a link showing how to use the gazeR package with Code Ocean: https://www.youtube.com/watch?v=5IQmP9Yrh1k

Updates (Jan 2020)

Happy New Year!! The gazeR package will soon be up and running on Code Ocean! You can download the gazeR capsule and run your own data using our functions from the cloud!

Updates (December 2019)

We just resubmitted our manuscript (find it here: https://psyarxiv.com/4qwr8/)! GazeR now has more generalized functionality.

  • GazeR can now read in edf files directly
  • Baseline by messages
  • Modified downsampling function
  • Smoothing and interpolation merged into single function

Updates (September 2019)

  • Read in edf files directly
  • Blink/saccades/fixation algorithm
  • Comptability with other eye trackers
  • add Binder functionality to run package in the cloud

Synopsis

This package contains functions for reading in raw eye-tracking data, formatting it for (growth curve) analysis, converting from gaze coordinates to areas of interest, binifying and aggregating data, and various helper functions for GCA and plotting. In addition to gaze-position data, it can handle pupillometric and other time course data.

Installing Package

# install devtools
install.packages("devtools")

# install gazer from GitHub
remotes::install_github("dmirman/gazer")

Citation

[1] Geller, J., Winn, M. B., Mahr, T., & Mirman, D. (2020). GazeR: A Package for Processing Gaze Position and Pupil Size Data. Behavior Research Methods.

References

[2] Mathôt, S. (2013). A Simple Way to Reconstruct Pupil Size During Eye Blinks. Retrieved from doi:10.6084/m9.figshare.688001