VWPre1.2.5 package

Tools for Preprocessing Visual World Data

align_msg

Aligns samples to a specific message.

bin_prop

Bins the sample data and calculates proportion looks by interest area

check_all_msgs

Output all messages with timestamps

check_eye_recording

Check which eyes were recorded during the experiment

check_ia

Check the interest area IDs and labels

check_msg_time

Check the time value(s) at a specific message

check_samples_per_bin

Check the number of samples in each bin

check_samplingrate

Determine the sampling rate present in the data

check_time_series

Check the new time series

create_binomial

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

create_time_series

Create a time series column

custom_ia

Map gaze data to newly defined interest areas

dot-check_for_PupilPre

Internal helper function, not intended to be called externally.

ds_options

Determine downsampling options based on current sampling rate

fasttrack

Fast-track basic preprocessing

make_pelogit_fnc

Create function for back-transforming empirical logits to proportions

mark_trackloss

Mark trackloss by blink and/or screen size

plot_avg_cdiff

Plots average difference between two conditions.

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.

plot_avg

Plots average looks to interest areas.

plot_indiv_app

Plots diagnostic average plots of subjects/items.

plot_transformation_app

Plots diagnostic plots of the empirical logit transformation.

plot_var_app

Plots diagnostic plots of subject/item variance.

prep_data

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

recode_ia

Recode interest area IDs and/or interest area labels

relabel_na

Relabel samples containing 'NA' as outside any interest area

rename_columns

Rename default column names for interest areas.

rm_extra_DVcols

Checks for and removes unnecessary DV output columns.

rm_trackloss_events

Removes events with excessive trackloss

select_recorded_eye

Select the eye used during recording

transform_to_elogit

Transforms proportion looks to empirical logits.

VWPre

VWPre: Tools for Preprocessing Visual World Data.

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.

  • Maintainer: Vincent Porretta
  • License: GPL-3
  • Last published: 2025-12-06