Learn R Programming

VWPre (version 1.2.5)

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

162

Version

1.2.5

License

GPL-3

Maintainer

Vincent Porretta

Last Published

December 6th, 2025

Functions in VWPre (1.2.5)

mark_trackloss

Mark trackloss by blink and/or screen size
check_time_series

Check the new time series
fasttrack

Fast-track basic preprocessing
create_binomial

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

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

Plots diagnostic plots of the empirical logit transformation.
.check_for_PupilPre

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

Removes events with excessive trackloss
plot_indiv_app

Plots diagnostic average plots of subjects/items.
ds_options

Determine downsampling options based on current sampling rate
plot_avg_contour

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

Plots average difference between looks to two interest areas.
rm_extra_DVcols

Checks for and removes unnecessary DV output columns.
select_recorded_eye

Select the eye used during recording
plot_avg_cdiff

Plots average difference between two conditions.
transform_to_elogit

Transforms proportion looks to empirical logits.
recode_ia

Recode interest area IDs and/or interest area labels
plot_var_app

Plots diagnostic plots of subject/item variance.
relabel_na

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

Rename default column names for interest areas.
check_eye_recording

Check which eyes were recorded during the experiment
VWdat

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

Determine the sampling rate present in the data
align_msg

Aligns samples to a specific message.
bin_prop

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

VWPre: Tools for Preprocessing Visual World Data.
check_samples_per_bin

Check the number of samples in each bin
check_all_msgs

Output all messages with timestamps
check_ia

Check the interest area IDs and labels
check_msg_time

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

Plots average looks to interest areas.
create_time_series

Create a time series column
custom_ia

Map gaze data to newly defined interest areas
make_pelogit_fnc

Create function for back-transforming empirical logits to proportions