Extract a saccade report from an ELascii object

Extract a saccade report from an ELascii object

reportSaccades(dat, trialvars = TRUE)

Arguments

dat

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

trialvars

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

Value

A data.frame containing a saccade 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 "SACC".

5. eye: factor indicating eye for corresponding saccade, 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. xpos1: starting x position

10. ypos1: starting y position

11. xpos2: ending x position

12. ypos2: ending y position

13. ampl: amplitude (units?)

14. peakvel: peak velocity (units?)

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

Details

Saccade 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
esacc <- reportSaccades(e)