select_recorded_eye: Select the eye used during recording

In VWPre: Tools for Preprocessing Visual World Data

Description

select_recorded_eye examines each event and determines which eye contains interest area information, based on the Recording parameter (which can be determined using check_eye_recording). This function then selects the data from the recorded eye and copies it to new columns (IA_ID, IA_LABEL, IA_Data). The function prints a summary of the output.

Usage

select_recorded_eye(data, Recording = NULL, WhenLandR = NA)

Arguments

data	A data table object output by create_time_series.
Recording	A string indicating which eyes were used for recording gaze data ("R" when only right eye recording is present, "L" when only left eye recording is present, "LorR" when either the left or the right eye was recorded, "LandR" when both the left and the right eyes were recorded).
WhenLandR	A string indicating which eye ("Right" or "Left) to use if gaze data is available for both eyes (i.e., Recording = "LandR").

Value

A data table with four additional columns ('EyeRecorded', 'EyeSelected', 'IA_ID', 'IA_LABEL', 'IA_Data') added to data.

Examples

## Not run: 
library(VWPre)
# Create a unified columns for the gaze data...
df <- select_recorded_eye(data = dat, Recording = "LandR", WhenLandR = "Right")

## End(Not run)

VWPre documentation built on Nov. 30, 2020, 1:08 a.m.