reportSaccades: Extract a saccade report from an ELascii object

Description Usage Arguments Details Value Author(s) Examples

View source: R/makeReport.R

Description

Extract a saccade report from an ELascii object

Usage

1
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 [email protected]

Examples

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

davebraze/FDBeye documentation built on Nov. 21, 2017, 11:23 a.m.