{ "_id": "6a22a541cd65a98ecbd5995e", "Package": "VWPre", "Type": "Package", "Title": "Tools for Preprocessing Visual World Data", "Version": "1.2.5", "Date": "2025-12-06", "Authors@R": "c(person(\"Vincent\", \"Porretta\", role = c(\"aut\", \"cre\"),\nemail = \"vincentporretta@gmail.com\"),\nperson(\"Aki-Juhani\", \"Kyröläinen\", role = \"aut\"),\nperson(\"Jacolien\", \"van Rij\", role = \"ctb\"),\nperson(\"Juhani\", \"Järvikivi\", role = \"ctb\"))", "Author": "Vincent Porretta [aut, cre], Aki-Juhani Kyröläinen [aut],\nJacolien van Rij [ctb], Juhani Järvikivi [ctb]", "Maintainer": "Vincent Porretta ", "Description": "Gaze data from the Visual World Paradigm requires\nsignificant preprocessing prior to plotting and analyzing the\ndata. This package provides functions for preparing visual\nworld eye-tracking data for statistical analysis and plotting.\nIt can prepare data for linear analyses (e.g., ANOVA,\nGaussian-family LMER, Gaussian-family GAMM) as well as logistic\nanalyses (e.g., binomial-family LMER and binomial-family GAMM).\nAdditionally, it contains various plotting functions for\ncreating grand average and conditional average plots. See the\nvignette for samples of the functionality. Currently, the\nfunctions in this package are designed for handling data\ncollected with SR Research Eyelink eye trackers using Sample\nReports created in SR Research Data Viewer. While we would\nlike to add functionality for data collected with other systems\nin the future, the current package is considered to be\nfeature-complete; further updates will mainly entail\nmaintenance and the addition of minor functionality.", "License": "GPL-3", "LazyData": "true", "VignetteBuilder": "knitr", "Encoding": "UTF-8", "RoxygenNote": "7.3.3", "NeedsCompilation": "no", "Packaged": { "Date": "2026-06-05 10:27:04 UTC", "User": "root" }, "Config/pak/sysreqs": "cmake make libicu-dev libuv1-dev zlib1g-dev", "Repository": "https://vincentporretta.r-universe.dev", "Date/Publication": "2025-12-06 23:30:02 UTC", "RemoteUrl": "https://github.com/cran/VWPre", "RemoteRef": "HEAD", "RemoteSha": "db3e07402f612c50bcbf66a44978602532038dc5", "MD5sum": "7a5f8263a7d538667077496244507dfe", "_user": "vincentporretta", "_type": "src", "_file": "VWPre_1.2.5.tar.gz", "_fileid": "8db111e4f9c97f077472c90ae753d5002cf91461fa669000b5c87b5adf08184c", "_filesize": 2884821, "_sha256": "8db111e4f9c97f077472c90ae753d5002cf91461fa669000b5c87b5adf08184c", "_created": "2026-06-05T10:27:04.000Z", "_published": "2026-06-05T10:30:25.071Z", "_distro": "noble", "_jobs": [ { "job": 79709748108, "time": 129, "config": "linux-devel-x86_64", "r": "4.7.0", "check": "OK", "artifact": "7434426977" }, { "job": 79709748126, "time": 148, "config": "linux-release-x86_64", "r": "4.6.0", "check": "OK", "artifact": "7434433035" }, { "job": 79709748078, "time": 163, "config": "macos-oldrel-arm64", "r": "4.5.3", "check": "OK", "artifact": "7434431709" }, { "job": 79709748077, "time": 127, "config": "macos-release-arm64", "r": "4.6.0", "check": "OK", "artifact": "7434421569" }, { "job": 79709221455, "time": 218, "config": "source", "r": "4.6.0", "check": "OK", "artifact": "7434388502" }, { "job": 79709748196, "time": 120, "config": "wasm-release", "r": "4.6.0", "check": "OK", "artifact": "7434424517" }, { "job": 79709748125, "time": 102, "config": "windows-devel", "r": "4.7.0", "check": "OK", "artifact": "7434419445" }, { "job": 79709748156, "time": 95, "config": "windows-oldrel", "r": "4.5.3", "check": "OK", "artifact": "7434417196" }, { "job": 79709748158, "time": 95, "config": "windows-release", "r": "4.6.0", "check": "OK", "artifact": "7434417467" } ], "_buildurl": "https://github.com/r-universe/vincentporretta/actions/runs/27009458336", "_status": "success", "_host": "GitHub-Actions", "_upstream": "https://github.com/cran/VWPre", "_commit": { "id": "db3e07402f612c50bcbf66a44978602532038dc5", "author": "Vincent Porretta ", "committer": "cran-robot ", "message": "version 1.2.5\n", "time": 1765063802 }, "_maintainer": { "name": "Vincent Porretta", "email": "vincentporretta@gmail.com", "login": "vincentporretta", "description": "", "uuid": 12749925 }, "_registered": true, "_dependencies": [ { "package": "R", "version": ">= 3.5.0", "role": "Depends" }, { "package": "dplyr", "version": ">= 0.7.0", "role": "Depends" }, { "package": "rlang", "version": ">= 0.1.1", "role": "Imports" }, { "package": "ggplot2", "version": ">= 2.2.0", "role": "Imports" }, { "package": "mgcv", "version": ">= 1.8-16", "role": "Imports" }, { "package": "shiny", "version": ">= 0.14.2", "role": "Imports" }, { "package": "tidyr", "version": ">= 0.6.0", "role": "Imports" }, { "package": "stats", "version": ">= 3.3.2", "role": "Imports" }, { "package": "knitr", "role": "Suggests" }, { "package": "rmarkdown", "role": "Suggests" }, { "package": "gridExtra", "role": "Suggests" } ], "_owner": "cran", "_selfowned": true, "_usedby": 1, "_updates": [ { "week": "2025-49", "n": 1 } ], "_tags": [ { "name": "1.2.5", "date": "2025-12-06" } ], "_stars": 1, "_contributors": [ { "user": "vincentporretta", "count": 14, "uuid": 12749925 } ], "_userbio": { "uuid": 12749925, "type": "user", "name": "Vincent Porretta" }, "_downloads": { "count": 215, "source": "https://cranlogs.r-pkg.org/downloads/total/last-month/VWPre" }, "_mentions": 2, "_searchresults": 99, "_rbuild": "4.6.0", "_assets": [ "extra/citation.cff", "extra/citation.html", "extra/citation.json", "extra/citation.txt", "extra/contents.json", "extra/NEWS.html", "extra/NEWS.txt", "extra/VWPre.html", "manual.pdf" ], "_realowner": "vincentporretta", "_cranurl": false, "_releases": [ { "version": "0.5.0", "date": "2016-05-09" }, { "version": "0.7.0", "date": "2016-06-19" }, { "version": "0.9.0", "date": "2016-09-28" }, { "version": "0.9.5", "date": "2016-11-25" }, { "version": "0.9.6", "date": "2017-06-15" }, { "version": "1.0.0", "date": "2017-10-24" }, { "version": "1.0.1", "date": "2017-12-05" }, { "version": "1.1.0", "date": "2018-03-20" }, { "version": "1.2.0", "date": "2019-07-10" }, { "version": "1.2.1", "date": "2019-11-05" }, { "version": "1.2.2", "date": "2019-12-18" }, { "version": "1.2.3", "date": "2020-03-10" }, { "version": "1.2.4", "date": "2020-11-29" }, { "version": "1.2.5", "date": "2025-12-11" } ], "_exports": [ "align_msg", "bin_prop", "check_all_msgs", "check_eye_recording", "check_ia", "check_msg_time", "check_samples_per_bin", "check_samplingrate", "check_time_series", "create_binomial", "create_time_series", "custom_ia", "ds_options", "fasttrack", "make_pelogit_fnc", "mark_trackloss", "plot_avg", "plot_avg_cdiff", "plot_avg_contour", "plot_avg_diff", "plot_indiv_app", "plot_transformation_app", "plot_var_app", "prep_data", "recode_ia", "relabel_na", "rename_columns", "rm_extra_DVcols", "rm_trackloss_events", "select_recorded_eye", "transform_to_elogit" ], "_datasets": [ { "name": "VWdat", "title": "This is a sample eye-tracking dataset included in the package", "object": "VWdat", "class": [ "grouped_df", "tbl_df", "tbl", "data.frame" ], "fields": [ "RECORDING_SESSION_LABEL", "LEFT_GAZE_X", "LEFT_GAZE_Y", "LEFT_IN_BLINK", "LEFT_IN_SACCADE", "LEFT_INTEREST_AREA_ID", "LEFT_INTEREST_AREA_LABEL", "RIGHT_GAZE_X", "RIGHT_GAZE_Y", "RIGHT_IN_BLINK", "RIGHT_IN_SACCADE", "RIGHT_INTEREST_AREA_ID", "RIGHT_INTEREST_AREA_LABEL", "SAMPLE_MESSAGE", "TIMESTAMP", "TRIAL_INDEX", "talker", "Rating", "Exp", "itemid" ], "rows": 188909, "table": true, "tojson": true } ], "_help": [ { "page": "dot-check_for_PupilPre", "title": "Internal helper function, not intended to be called externally.", "topics": [ ".check_for_PupilPre" ] }, { "page": "align_msg", "title": "Aligns samples to a specific message.", "topics": [ "align_msg" ] }, { "page": "bin_prop", "title": "Bins the sample data and calculates proportion looks by interest area", "topics": [ "bin_prop" ] }, { "page": "check_all_msgs", "title": "Output all messages with timestamps", "topics": [ "check_all_msgs" ] }, { "page": "check_eye_recording", "title": "Check which eyes were recorded during the experiment", "topics": [ "check_eye_recording" ] }, { "page": "check_ia", "title": "Check the interest area IDs and labels", "topics": [ "check_ia" ] }, { "page": "check_msg_time", "title": "Check the time value(s) at a specific message", "topics": [ "check_msg_time" ] }, { "page": "check_samples_per_bin", "title": "Check the number of samples in each bin", "topics": [ "check_samples_per_bin" ] }, { "page": "check_samplingrate", "title": "Determine the sampling rate present in the data", "topics": [ "check_samplingrate" ] }, { "page": "check_time_series", "title": "Check the new time series", "topics": [ "check_time_series" ] }, { "page": "create_binomial", "title": "Creates a success/failure column for each IA based on counts.", "topics": [ "create_binomial" ] }, { "page": "create_time_series", "title": "Create a time series column", "topics": [ "create_time_series" ] }, { "page": "custom_ia", "title": "Map gaze data to newly defined interest areas", "topics": [ "custom_ia" ] }, { "page": "ds_options", "title": "Determine downsampling options based on current sampling rate", "topics": [ "ds_options" ] }, { "page": "fasttrack", "title": "Fast-track basic preprocessing", "topics": [ "fasttrack" ] }, { "page": "make_pelogit_fnc", "title": "Create function for back-transforming empirical logits to proportions", "topics": [ "make_pelogit_fnc" ] }, { "page": "mark_trackloss", "title": "Mark trackloss by blink and/or screen size", "topics": [ "mark_trackloss" ] }, { "page": "plot_avg", "title": "Plots average looks to interest areas.", "topics": [ "plot_avg" ] }, { "page": "plot_avg_cdiff", "title": "Plots average difference between two conditions.", "topics": [ "plot_avg_cdiff" ] }, { "page": "plot_avg_contour", "title": "Plots average contour surface of looks to a given interest area.", "topics": [ "plot_avg_contour" ] }, { "page": "plot_avg_diff", "title": "Plots average difference between looks to two interest areas.", "topics": [ "plot_avg_diff" ] }, { "page": "plot_indiv_app", "title": "Plots diagnostic average plots of subjects/items.", "topics": [ "plot_indiv_app" ] }, { "page": "plot_transformation_app", "title": "Plots diagnostic plots of the empirical logit transformation.", "topics": [ "plot_transformation_app" ] }, { "page": "plot_var_app", "title": "Plots diagnostic plots of subject/item variance.", "topics": [ "plot_var_app" ] }, { "page": "prep_data", "title": "Check the classes of specific columns and re-assigns as necessary.", "topics": [ "prep_data" ] }, { "page": "recode_ia", "title": "Recode interest area IDs and/or interest area labels", "topics": [ "recode_ia" ] }, { "page": "relabel_na", "title": "Relabel samples containing 'NA' as outside any interest area", "topics": [ "relabel_na" ] }, { "page": "rename_columns", "title": "Rename default column names for interest areas.", "topics": [ "rename_columns" ] }, { "page": "rm_extra_DVcols", "title": "Checks for and removes unnecessary DV output columns.", "topics": [ "rm_extra_DVcols" ] }, { "page": "rm_trackloss_events", "title": "Removes events with excessive trackloss", "topics": [ "rm_trackloss_events" ] }, { "page": "select_recorded_eye", "title": "Select the eye used during recording", "topics": [ "select_recorded_eye" ] }, { "page": "transform_to_elogit", "title": "Transforms proportion looks to empirical logits.", "topics": [ "transform_to_elogit" ] }, { "page": "VWdat", "title": "This is a sample eye-tracking dataset included in the package", "topics": [ "VWdat" ] }, { "page": "VWPre", "title": "VWPre: Tools for Preprocessing Visual World Data.", "topics": [ "VWPre", "_PACKAGE" ] } ], "_rundeps": [ "base64enc", "bslib", "cachem", "cli", "commonmark", "cpp11", "digest", "dplyr", "farver", "fastmap", "fontawesome", "fs", "generics", "ggplot2", "glue", "gtable", "htmltools", "httpuv", "isoband", "jquerylib", "jsonlite", "labeling", "later", "lattice", "lifecycle", "magrittr", "Matrix", "memoise", "mgcv", "mime", "nlme", "otel", "pillar", "pkgconfig", "promises", "purrr", "R6", "rappdirs", "RColorBrewer", "Rcpp", "rlang", "S7", "sass", "scales", "shiny", "sourcetools", "stringi", "stringr", "tibble", "tidyr", "tidyselect", "utf8", "vctrs", "viridisLite", "withr", "xtable" ], "_vignettes": [ { "source": "VWPre_Message_Alignment.Rmd", "filename": "VWPre_Message_Alignment.html", "title": "Aligning Data to a Specific Sample Message", "author": "Vincent Porretta", "engine": "knitr::rmarkdown", "headings": [ "Before aligning", "Aligning to a specific message", "Creating the Time series column", "Proceed with preprocessing" ], "created": "2019-07-09 15:50:12", "modified": "2025-12-06 23:30:02", "commits": 2 }, { "source": "VWPre_Basic_Preprocessing.Rmd", "filename": "VWPre_Basic_Preprocessing.html", "title": "Basic VWP Preprocessing", "author": "Vincent Porretta", "engine": "knitr::rmarkdown", "headings": [ "Before using VWPre", "Loading the package and the data", "Preparing the data", "Verifying and creating necessary columns", "Remove unnecessary columns", "Relabel NA samples as outside any interest area", "Check encoding of interest areas", "Creating the Time series column", "Selecting which eye to use", "Trackloss", "Binning the data", "Empirical logits", "Binomial data", "Fasttrack function", "Renaming interest area columns", "Saving the data", "Subsetting and ordering", "Saving to a file", "Plotting" ], "created": "2019-07-09 15:50:12", "modified": "2025-12-06 23:30:02", "commits": 2 }, { "source": "VWPre_Plotting.Rmd", "filename": "VWPre_Plotting.html", "title": "Plotting VWP Data Processed with VWPre", "author": "Vincent Porretta", "engine": "knitr::rmarkdown", "headings": [ "Plotting the data", "Averaged data", "Conditional averages", "Error bars and Error bands", "Confidence intervals (pointwise/simultaneous)", "Single interest area by condition", "Calculation of averages - Mean vs. Grand mean", "Difference plots (between looks to two interest areas)", "Difference plots (between two conditions for looks to one interest area)", "Conditional contour surface", "Extracting plotting data", "Backtransformation of predicted values", "Interactive/Utility plotting apps", "Shiny app for understanding the empirical logit transformation", "Shiny app plots for data inspection" ], "created": "2019-07-09 15:50:12", "modified": "2025-12-06 23:30:02", "commits": 3 }, { "source": "VWPre_Interest_Areas.Rmd", "filename": "VWPre_Interest_Areas.html", "title": "Relabeling or Defining Interest Areas", "author": "Vincent Porretta", "engine": "knitr::rmarkdown", "headings": [ "Basic interest area relabelling", "Check interest area coding", "Providing new labels and IDs for existing interest areas", "Remapping gaze position to newly defined interest areas", "Creating the look-up table", "Performing the gaze remapping" ], "created": "2019-07-09 15:50:12", "modified": "2019-07-09 15:50:12", "commits": 1 } ], "_score": 4.375846436309156, "_indexed": true, "_nocasepkg": "vwpre", "_universes": [ "vincentporretta" ], "_binaries": [ { "r": "4.7.0", "os": "linux", "version": "1.2.5", "date": "2026-06-05T10:29:09.000Z", "distro": "noble", "commit": "db3e07402f612c50bcbf66a44978602532038dc5", "fileid": "97a5f4d4443d41d686617a44f5a1ac56f40c12fd9126547a036db269d4721196", "status": "success", "check": "OK", "buildurl": "https://github.com/r-universe/vincentporretta/actions/runs/27009458336" }, { "r": "4.6.0", "os": "linux", "version": "1.2.5", "date": "2026-06-05T10:29:22.000Z", "distro": "noble", "commit": "db3e07402f612c50bcbf66a44978602532038dc5", "fileid": "21b91791d81e7f89f262ad529bfc98eec9b824d8458cd6ea190d82ab523789fc", "status": "success", "check": "OK", "buildurl": "https://github.com/r-universe/vincentporretta/actions/runs/27009458336" }, { "r": "4.5.3", "os": "mac", "version": "1.2.5", "date": "2026-06-05T10:29:30.000Z", "commit": "db3e07402f612c50bcbf66a44978602532038dc5", "fileid": "49e4c29b911e9f053954685d224c23909be8d0e85c010cbf453b4799fac35a49", "status": "success", "check": "OK", "buildurl": "https://github.com/r-universe/vincentporretta/actions/runs/27009458336" }, { "r": "4.6.0", "os": "mac", "version": "1.2.5", "date": "2026-06-05T10:28:55.000Z", "commit": "db3e07402f612c50bcbf66a44978602532038dc5", "fileid": "6c46a2cce7088ee064ca69f97550820f14f140a32e1b0a315522bc615e76f0de", "status": "success", "check": "OK", "buildurl": "https://github.com/r-universe/vincentporretta/actions/runs/27009458336" }, { "r": "4.6.0", "os": "wasm", "version": "1.2.5", "date": "2026-06-05T10:29:23.000Z", "commit": "db3e07402f612c50bcbf66a44978602532038dc5", "fileid": "67a39217e92060ed7d752846ff805e08812d95f1661ae4ec521317027697fffc", "status": "success", "buildurl": "https://github.com/r-universe/vincentporretta/actions/runs/27009458336" }, { "r": "4.7.0", "os": "win", "version": "1.2.5", "date": "2026-06-05T10:28:27.000Z", "commit": "db3e07402f612c50bcbf66a44978602532038dc5", "fileid": "8d44bd82f89dbd59adbc7fc8cbcfeaa5a5ffde5a65af12a11ac5e6b6b5df8f85", "status": "success", "check": "OK", "buildurl": "https://github.com/r-universe/vincentporretta/actions/runs/27009458336" }, { "r": "4.5.3", "os": "win", "version": "1.2.5", "date": "2026-06-05T10:28:20.000Z", "commit": "db3e07402f612c50bcbf66a44978602532038dc5", "fileid": "b584fed37087a31bcdd6eb74e0960dd9765f562d4bb690d0cef36a9f23f55f8a", "status": "success", "check": "OK", "buildurl": "https://github.com/r-universe/vincentporretta/actions/runs/27009458336" }, { "r": "4.6.0", "os": "win", "version": "1.2.5", "date": "2026-06-05T10:28:20.000Z", "commit": "db3e07402f612c50bcbf66a44978602532038dc5", "fileid": "acf430924aa807473ae63775d84b3cec3a4c389fed42941eead9ea31f5a20b95", "status": "success", "check": "OK", "buildurl": "https://github.com/r-universe/vincentporretta/actions/runs/27009458336" } ] }