/mousetrap

Process and Analyze Mouse-Tracking Data

Primary LanguageRGNU General Public License v3.0GPL-3.0

mousetrap

cran version DOI downloads

Mouse-tracking, the analysis of mouse movements in computerized experiments, is a method that is becoming increasingly popular in the cognitive sciences. The mousetrap package offers functions for importing, preprocessing, analyzing, aggregating, and visualizing mouse-tracking data.

General Information

The mousetrap package is developed by Pascal Kieslich, Dirk Wulff, Felix Henninger, and Jonas Haslbeck. It is published under the GNU General Public License (version 3).

An overview of the functions in this package can be found online. It can also be accessed from within R using ?mousetrap once the package has been loaded. Please see news for a summary of changes in the package. Questions about using mousetrap can be asked in the forum.

The mousetrap package offers functions for importing mouse-tracking data in different formats and from various sources. One option to collect mouse-tracking data is by using the open-source graphical experiment builder OpenSesame in combination with the mousetrap-os plugin.

Installation

The current stable version is available on CRAN and can be installed via install.packages("mousetrap").

To install the latest development version from GitHub, you need the devtools package . The development version can be installed via devtools::install_github("pascalkieslich/mousetrap@master").

Mailing list

If you would like to receive information about new releases, you can add your email to the mailing list. Questions about using mousetrap can be asked in the forum.

Citation

If you use the mousetrap package in your published research, we kindly ask that you cite it as follows:

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. https://doi.org/10.4324/9781315160559-9 (preprint)

Besides, if you use functions for clustering and mapping trajectories, please also include the following reference:

Wulff, D. U., Haslbeck, J. M. B., Kieslich, P. J., Henninger, F., & Schulte-Mecklenbeck, M. (2019). Mouse-tracking: Detecting types in movement trajectories. In M. Schulte-Mecklenbeck, A. Kühberger, & J. G. Johnson (Eds.), A Handbook of Process Tracing Methods (pp. 131-145). New York, NY: Routledge. https://doi.org/10.4324/9781315160559-10 (preprint)

Acknowledgments

We thank Johanna Hepp for helpful comments on the documentation of this package and Monika Wiegelmann for testing a development version. This work was supported by the University of Mannheim’s Graduate School of Economic and Social Sciences, which is funded by the German Research Foundation.