Learn R Programming

VWPre (version 1.2.4)

Tools for Preprocessing Visual World Data

Description

Gaze data from the Visual World Paradigm requires significant preprocessing prior to plotting and analyzing the data. This package provides functions for preparing visual world eye-tracking data for statistical analysis and plotting. It can prepare data for linear analyses (e.g., ANOVA, Gaussian-family LMER, Gaussian-family GAMM) as well as logistic analyses (e.g., binomial-family LMER and binomial-family GAMM). Additionally, it contains various plotting functions for creating grand average and conditional average plots. See the vignette for samples of the functionality. Currently, the functions in this package are designed for handling data collected with SR Research Eyelink eye trackers using Sample Reports created in SR Research Data Viewer. While we would like to add functionality for data collected with other systems in the future, the current package is considered to be feature-complete; further updates will mainly entail maintenance and the addition of minor functionality.

Copy Link

Version

Install

install.packages('VWPre')

Monthly Downloads

200

Version

1.2.4

License

GPL-3

Maintainer

Vincent Porretta

Last Published

November 29th, 2020

Functions in VWPre (1.2.4)

fasttrack

Fast-track basic preprocessing
plot_avg

Plots average looks to interest areas.
mark_trackloss

Mark trackloss by blink and/or screen size
create_binomial

Creates a success/failure column for each IA based on counts.
check_time_series

Check the new time series
recode_ia

Recode interest area IDs and/or interest area labels
prep_data

Check the classes of specific columns and re-assigns as necessary.
rename_columns

Rename default column names for interest areas.
select_recorded_eye

Select the eye used during recording
relabel_na

Relabel samples containing 'NA' as outside any interest area
create_time_series

Create a time series column
make_pelogit_fnc

Create function for back-transforming empirical logits to proportions
transform_to_elogit

Transforms proportion looks to empirical logits.
bin_prop

Bins the sample data and calculates proportion looks by interest area
plot_avg_diff

Plots average difference between looks to two interest areas.
plot_indiv_app

Plots diagnostic average plots of subjects/items.
custom_ia

Map gaze data to newly defined interest areas
plot_var_app

Plots diagnostic plots of subject/item variance.
plot_transformation_app

Plots diagnostic plots of the empirical logit transformation.
plot_avg_cdiff

Plots average difference between two conditions.
.check_for_PupilPre

Internal helper function, not intended to be called externally.
ds_options

Determine downsampling options based on current sampling rate
plot_avg_contour

Plots average contour surface of looks to a given interest area.
rm_extra_DVcols

Checks for and removes unnecessary DV output columns.
rm_trackloss_events

Removes events with excessive trackloss
check_samplingrate

Determine the sampling rate present in the data
check_eye_recording

Check which eyes were recorded during the experiment
check_all_msgs

Output all messages with timestamps
check_samples_per_bin

Check the number of samples in each bin
align_msg

Aligns samples to a specific message.
check_msg_time

Check the time value(s) at a specific message
check_ia

Check the interest area IDs and labels
VWPre

VWPre: Tools for Preprocessing Visual World Data.
VWdat

This is a sample eye-tracking dataset included in the package