VWPre (version 1.2.4)

custom_ia: Map gaze data to newly defined interest areas

Description

custom_ia uses a lookup data frame to map Left and Right gaze data to newly defined/supplied interest areas for each recording event. The lookup data should contain columns Event, IA_LABEL, IA_ID, Top, Bottom, Left, Right, which specify the Interest area label, its corresponding ID, and the boundaries (in pixel values) for each recording event. The function will overwrite existing columns RIGHT_INTEREST_AREA_LABEL, RIGHT_INTEREST_AREA_ID, LEFT_INTEREST_AREA_LABEL, and LEFT_INTEREST_AREA_ID.

Usage

custom_ia(data, iaLookup = NULL)

Arguments

data

A data table object output by prep_data.

iaLookup

A data frame object containing by-event mapping information.

Value

A data table object.

Examples

# NOT RUN {
library(VWPre)
# Map gaze data to newly defined interest areas...
df <- custom_ia(data = dat, iaLookup = LookUpDF)
 
# For a more complete tutorial on VWPre plotting functions:
vignette("SR_Interest_Areas", package="VWPre")
# }
# NOT RUN {
# }