Extract a fixation report from an ELascii object

reportFixations(dat, trialvars = TRUE)

Arguments

dat

An object of class "ELascii", as created by readELascii().

trialvars

Logical, defaults TRUE to include trial variables in fixation report.

Value

A data.frame containing a fixation report with the following columns:

  1. subject: factor for subject ID, taken from the name of the source EDF file.

  2. trialn: factor for trial ID.

  3. time0: integer indicating timestamp (ms) of first sample in recording block.

  4. event: factor for event type, always "FIX".

  5. eye: factor indicating eye for corresponding fixation, ranges over c("L", "R").

  6. stime: integer indicating start time for fixation (ms).

  7. etime: integer indicating end time for fixation (ms).

  8. dur: integer indicating duration of fixation (ms).

  9. xpos: integer, x position of fixation in screen coordinates (pixels).

  10. ypos: integer, y position of fixation in screen coordinates (pixels). Origin is upper left corner of screen.

  11. pupil: integer, pupil size (pixels), may be either area or radius depending on ET settings

Returned data.frame will also include trial_vars from edf file if requested (TRUE by default).

Details

Fixation reports include data from both eyes, if available, as well as subject ID, trial number, time stamp of first sample in each trial. By default, values for trial variables found in each trial are also include, although these may be suppressed.

Author

Dave Braze davebraze@gmail.com

Examples

fname <- system.file("/extdata/1950006-RAN.asc.gz", package="FDBeye")
e <- readELascii(fname)
#> Warning: seek on a gzfile connection returned an internal error
efix <- reportFixations(e)