extract_x: Extract x coordinates of time-normalized mouse-tracking data

In dosc91/mtqgam: Mouse-Tracking Data in QGAMs

Extract x coordinates of time-normalized mouse-tracking data

Description

extract_x extracts the x coordinates from a time-normalized mousetrap object.

Usage

extract_x(
  mousetrap,
  ID_column,
  timestamps,
  verbose = TRUE)

Arguments

mousetrap	A mousetrap object containing time-normalized data (commonly achieved using mousetrap::mt_time_normalize).
tn_data	obsolete: Specify mousetrap instead. For now, tn_data remains useable. It will be depricated in due time. tn_data is the time-normalized mouse-tracking data. Can be extracted from the mousetrap object via df$tn_trajectories.
ID_column	To maintain identification of individual trials, specify your ID variable. In older versions, this had to be part of tn_data.
timestamps	Specify the number of timestamps you have used for time-normalizing.
verbose	If TRUE (which is the default), a progress bar is displayed.

Value

A data frame.

• key - Numbered coordinates per mouse-track ID.

• value - The x coordinate value.

• ID - Mouse-track IDs.

Author(s)

D. Schmitz

References

Kieslich, P. J., Henninger, F., Wulff, D. U., Haslbeck, J. M. B., & Schulte-Mecklenbeck, M. (2019). Mouse-tracking: A practical guide to implementation and analysis. In M. Schulte-Mecklenbeck, A. Kühberger, & J. G. Johnson (Eds.), A Handbook of Process Tracing Methods (pp. 111-130). New York, NY: Routledge.

Examples

x_data <- extract_x(mousetrap = mtqgam_mousetrap,
  ID_column = "ID",
  timestamps = 100,
  verbose = FALSE)

head(x_data)

dosc91/mtqgam documentation built on Sept. 29, 2023, 9:38 a.m.