Description Formatting functions Calculation functions Trackloss functions Fasttrack formatting function Data-checking functions Plotting functions Interactive functions Notes Author(s)

The VWPre package provides a set of functions for preparing Visual World data collected with SR Research Eyelink eye trackers.

The function

`create_time_series`

returns a time columns in milliseconds.The function

`prep_data`

returns a data table with correctly assigned classes for important columns.The function

`relabel_na`

returns a data table with samples containing 'NA' relabeled as outside any interest area.The function

`recode_ia`

returns a data table containing recoded interest area IDs and/or interest area labels.The function

`select_recorded_eye`

returns a data table with data from the the recorded eye in new columns (IA_ID and IA_LABEL).The function

`custom_ia`

returns a data table with gaze data remapped to new interest areas.The function

`align_msg`

returns a data table with newly aligned sample data in a new column (Align).The function

`rm_extra_DVcols`

removed DataViewer coumns that are not necessary for preprocessing with this package.

The function

`bin_prop`

returns a downsampled data table containing proportion of looks (samples) to each interest area in a particular window of time (bin size).The function

`transform_to_elogit`

returns a data table with proportion looks transformed to empirical logits with weights.The function

`create_binomial`

returns a data table with a new success/failure column for each IA which is suitable for logistic regression.

The function

`mark_trackloss`

returns a data table with data information regarding trackloss of the sample.The function

`rm_trackloss_events`

returns a data table from which events without the minimum amount of quality data have been removed.

The function

`fasttrack`

a meta-function that returns a data table of processed data containing the result of the series of necessary subroutines. This is intended for experienced users doing basic preprocessing.

The function

`check_eye_recording`

returns a summary of whether or not the dataset contains gaze data in both the Right and Left interest area columns.The function

`check_time_series`

returns the first value in the Time column for each event.The function

`check_samples_per_bin`

returns the number of samples in each bin.The function

`check_samplingrate`

returns the value corresponding to the sampling rate in the data.The function

`ds_options`

returns the binning (downsampling) options possible for the given sampling rate.The function

`check_ia`

returns a summary of the interest area IDs and Labels present in the data.The function

`check_msg_time`

returns a summary of the the time value at a given sample message for each recording event.The function

`check_all_msgs`

returns all messages in the data and their time stamp.

The function

`plot_avg`

returns a plot of the grand or conditional averages of proportion (or empirical logit) looks to each interest area along with error bars.The function

`plot_avg_contour`

returns a contour plot of the conditional average of proportion (or empirical logit) looks to a given interest area over Time and a specified continuous variable.The function

`plot_avg_diff`

returns a plot of the grand or conditional averages of the difference between looks to two interest areas (proportions or empirical logits) with error bars.The function

`plot_avg_cdiff`

returns a plot of the average difference between two conditions for looks to a given interest area (proportions or empirical logits) with error bars.The function

`make_pelogit_fnc`

returns a function that can backtransform predicted empirical logit to probability scale, particularly (though not exclusively) useful for plotting purposes.

The function

`plot_transformation_app`

opens a Shiny app for visualizing the effect of both number of observations and constant on the results of the empirical logit transformation and weight calculations.The function

`plot_indiv_app`

opens a Shiny app for inspecting by-subject or by-item averages for all interest areas, alongside the grand average (for proportion or empirical logit looks) within a specified time window.The function

`plot_var_app`

opens a Shiny app for inspecting by-subject or by-item Z-scores with respect to the overall mean for a given interest area within a specified time window.

The vignettes are available via

`browseVignettes(package = "VWPre")`

.A list of all available functions is provided in

`help(package = "VWPre")`

.This package can be cited using the information obtained from

`citation("VWPre") or print(citation("VWPre"), bibtex = TRUE)`

Vincent Porretta, Aki-Juhani Kyr<c3><b6>l<c3><a4>inen, Jacolien van Rij, Juhani J<c3><a4>rvikivi

Maintainer: Vincent Porretta ([email protected])

University of Windsor, Canada

Embedding an R snippet on your website

Add the following code to your website.

For more information on customizing the embed code, read Embedding Snippets.