reportSaccades: Extract a saccade report from an ELascii object

In davebraze/FDBeye: Functions to Ease Work with Eyetracker Data

Extract a saccade report from an ELascii object

Description

Extract a saccade report from an ELascii object

Usage

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.

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.

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).

Author(s)

Dave Braze [e-mail]

Examples

fname <- system.file("/extdata/1950006-RAN.asc.gz", package="FDBeye")
e <- readELascii(fname)
esacc <- reportSaccades(e)

davebraze/FDBeye documentation built on April 28, 2022, 1:20 a.m.