mt_add_trajectory: Add new trajectory to trajectory array.

In mousetrap: Process and Analyze Mouse-Tracking Data

Add new trajectory to trajectory array.

Description

Add a single new trajectory to trajectory array.

Usage

mt_add_trajectory(
  data,
  use = "trajectories",
  save_as = use,
  xpos = NULL,
  ypos = NULL,
  xypos = NULL,
  id = "new"
)

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.
xpos	a vector of x positions. Ignored, if xypos is provided.
ypos	a vector of y positions. Ignored, if xypos is provided.
xypos	a matrix, the first column corresponding to the x positions, the second to the y positions.
id	a character string specifying the identifier of the to be added trajectory.

Value

A mousetrap data object (see mt_example) where the new trajectory has been added. If the trajectory array was provided directly as data, only the trajectory array will be returned.

Author(s)

Pascal J. Kieslich

Felix Henninger

Examples

# Add additional prototype to mt_prototypes
mt_prototypes_ext <- mt_add_trajectory(mt_prototypes,
   xpos = c(0,1,-1,1,-1), ypos = c(0,1.5,1.5,1.5,1.5), id = "dCoM3"
)

mousetrap documentation built on May 29, 2024, 11:39 a.m.