mt_space_normalize: Space normalize trajectories.

Description

Adjust trajectories so that all trajectories have an identical start and end point. If no end points are provided, trajectories are only adjusted so that they have the same start position.

Usage

mt_space_normalize(data, use = "trajectories", save_as = "sn_trajectories", dimensions = c("xpos", "ypos"), start = c(0, 0), end = NULL, verbose = FALSE, xpos_start = NULL, xpos_end = NULL, ypos_start = NULL, ypos_end = NULL, show_progress = NULL)

Arguments

data

a mousetrap data object created using one of the mt_import functions (see mt_example for details). Alternatively, a trajectory array can be provided directly (in this case use will be ignored).

use

a character string specifying which trajectory data should be used.

save_as

a character string specifying where the resulting trajectory data should be stored.

dimensions

a character vector specifying the dimensions in the trajectory array that should be space-normalized.

start

a numeric vector specifying the start values for each dimension, i.e., the values the first recorded position should have in every trial.

end

a numeric vector specifying the end values for each dimension, i.e., the values the last recorded position should have in every trial. If NULL, trajectories are only adjusted so that they have the same start position.

verbose

logical indicating whether function should report its progress.

xpos_start

Deprecated. Please use start instead.

xpos_end

Deprecated. Please use end instead.

ypos_start

Deprecated. Please use start instead.

ypos_end

Deprecated. Please use end instead.

show_progress

Deprecated. Please use verbose instead.

Value

A mousetrap data object (see mt_example) with an additional array (by default called sn_trajectories) containing the space-normalized trajectories. All other trajectory dimensions not specified in dimensions (e.g., timestamps) will be kept as is in the resulting trajectory array. If a trajectory array was provided directly as data, only the space-normalized trajectories will be returned.

References

Dale, R., Kehoe, C., & Spivey, M. J. (2007). Graded motor responses in the time course of categorizing atypical exemplars. Memory & Cognition, 35(1), 15-28.

Examples

Run this code

mt_example <- mt_space_normalize(mt_example,
  save_as ="sn_trajectories",
  start=c(0,0), end=c(-1,1))