reportFixations: Extract a fixation report from an ELascii object

View source: R/makeReport.R

reportFixationsR Documentation

Extract a fixation report from an ELascii object

Description

Extract a fixation report from an ELascii object

Usage

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.

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.

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

Author(s)

Dave Braze davebraze@gmail.com

Examples

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

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