Exclude a potential phase at the end of a trial where the mouse was not moved. The corresponding samples (x- and y-positions and timestamps) in the trajectory data will be removed.
mt_exclude_finish( data, use = "trajectories", save_as = use, dimensions = c("xpos", "ypos"), timestamps = "timestamps", verbose = FALSE )
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).
a character string specifying which trajectory data should be used.
a character string specifying where the resulting trajectory data should be stored.
a character vector specifying the dimensions in the trajectory array that contain the mouse positions.
a character string specifying the trajectory dimension containing the timestamps.
logical indicating whether function should report its progress.
A mousetrap data object (see mt_example) from which a
potential phase without mouse movement at the end of the trial was removed.
If the trajectory array was provided directly as
data, only the
trajectory array will be returned.
mt_exclude_finish removes all samples (except the first) at the end of
the trial during which the mouse was not moved compared to its final
position. It returns only x- and y-positions as well as timestamps.
Please note that this operation may result in changes in several mouse-tracking measures, for example, the response time (RT).
mt_exclude_initiation for removing a potential initial phase without mouse movement.
mt_example <- mt_exclude_finish(mt_example, save_as="mod_trajectories")