https://github.com/pascalkieslich/mousetrap

Process and Analyze Mouse-Tracking Data
https://github.com/pascalkieslich/mousetrap

analysis clustering mouse-tracking r visualization

Last synced: 4 months ago
JSON representation

Process and Analyze Mouse-Tracking Data

• Host: GitHub
• URL: https://github.com/pascalkieslich/mousetrap
• Owner: PascalKieslich
• License: gpl-3.0
• Created: 2016-02-15T13:26:02.000Z (over 10 years ago)
• Default Branch: master
• Last Pushed: 2025-09-25T11:48:40.000Z (9 months ago)
• Last Synced: 2025-09-25T13:33:02.908Z (9 months ago)
• Topics: analysis, clustering, mouse-tracking, r, visualization
• Language: R
• Homepage: http://pascalkieslich.github.io/mousetrap
• Size: 14.8 MB
• Stars: 47
• Watchers: 6
• Forks: 17
• Open Issues: 1
• Metadata Files:
  • Readme: README.Rmd
  • Changelog: NEWS.md
  • License: LICENSE

Awesome Lists containing this project

README

          
---

output:

  github_document

---

```{r, echo = FALSE}

knitr::opts_chunk$set(

  collapse = TRUE,

  comment = "#>",

  fig.path = "README-"

)

```

# mousetrap 

[![cran version](http://www.r-pkg.org/badges/version/mousetrap)](https://CRAN.R-project.org/package=mousetrap)

[![DOI](https://zenodo.org/badge/DOI/10.5281/zenodo.596640.svg)](https://doi.org/10.5281/zenodo.596640)

[![downloads](https://cranlogs.r-pkg.org/badges/grand-total/mousetrap?color=yellow)](https://CRAN.R-project.org/package=mousetrap)

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](http://pascalkieslich.github.io/mousetrap/reference/mousetrap.html).

It can also be accessed from within R using `?mousetrap` once the package has been loaded.

Please see [news](http://pascalkieslich.github.io/mousetrap/news/) for a summary of changes in the package. Questions about using `mousetrap` can be asked in the [forum](https://forum.cogsci.nl/index.php?p=/categories/mousetrap).

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](https://osdoc.cogsci.nl/) in combination with the [mousetrap-os plugin](https://github.com/pascalkieslich/mousetrap-os).

## 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")`.

## Questions

Questions about using `mousetrap` can be asked in the [forum](https://forum.cogsci.nl/index.php?p=/categories/mousetrap).

## Citation

If you use the `mousetrap` package in your published research, we kindly ask that you cite the associated article:

Wulff, D. U.[\*](https://doi.org/10.3758/s13428-025-02695-2 "equal contribution"), Kieslich, P. J.[\*](https://doi.org/10.3758/s13428-025-02695-2 "equal contribution"), Henninger, F., Haslbeck, J. M. B., & Schulte-Mecklenbeck, M. (2025). Movement tracking of psychological processes: A tutorial using mousetrap. _Behavior Research Methods, 57_, 307. https://doi.org/10.3758/s13428-025-02695-2

## 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.