MyNixOS website logo
Description

Mouse Trajectory Analyses for Behavioural Scientists.

Helping psychologists and other behavioural scientists to analyze mouse movement (and other 2-D trajectory) data. Bundles together several functions that compute spatial measures (e.g., maximum absolute deviation, area under the curve, sample entropy) or provide a shorthand for procedures that are frequently used (e.g., time normalization, linear interpolation, extracting initiation and movement times). For more information on these dependent measures, see Wirth et al. (2020) <doi:10.3758/s13428-020-01409-0>.

R-CMD-check Lifecycle:experimental

mousetRajectory: Trajectory Analyses for Behavioural Scientists

Tool helping psychologists and other behavioural scientists to analyze mouse movement (and other 2-D trajectory) data. Bundles together several functions computing spatial measures (maximum absolute deviation, area under the curve, sample entropy) or providing a shorthand for often-used procedures.

Installation

You can install mousetRajectory from CRAN with

install.packages("mousetRajectory")

Alternatively, you can keep up to date and install the latest development version of mousetRajectory from github.com/mc-schaaf/mousetRajectory with:

if(!require("devtools")){install.packages("devtools")}
devtools::install_github("mc-schaaf/mousetRajectory")

Function Overview

Currently, the following functions are featured:

  • Preprocessing:
    • is_monotonic() checks whether your timestamps make sense and warns you if they don’t.
    • is_monotonic_along_ideal() checks whether your trajectories make sense and warns you if they don’t.
    • time_circle_left() tells you the time at which the starting area was left.
    • time_circle_entered() tells you the time at which the end area was entered.
    • point_crosses() tells you how often a certain value on the x or y axis is crossed.
    • direction_changes() tells you how often the direction along the x or y axis changes.
    • interp1() directs you to the interpolation function from the awesome signal package. Thus, you do not have to call library("signal"). Such time-saving, much wow. Also, not having to attach the signal package avoids ambiguity between signal::filter() and dplyr::filter() in your search path.
    • interp2() is a convenience wrapper to interp1() that rescales the time for you.
  • Spatial measures:
    • starting_angle() computes (not only starting) angles.
    • auc() computes the (signed) Area Under the Curve (AUC).
    • max_ad() computes the (signed) Maximum Absolute Deviation (MAD).
    • curvature() computes the curvature.
    • index_max_velocity() computes the time to peak velocity, assuming equidistant times between data points.
    • index_max_acceleration() computes the time to peak acceleration, assuming equidistant times between data points.
  • Other measures
    • sampen() computes the sample entropy.

Documentation

You can find an example application as well as the full documentation at mc-schaaf.github.io/mousetRajectory/.

Bug Reports

Please report bugs to github.com/mc-schaaf/mousetRajectory/issues.

Metadata

Version

0.2.1

License

Unknown

Platforms (75)

    Darwin
    FreeBSD
    Genode
    GHCJS
    Linux
    MMIXware
    NetBSD
    none
    OpenBSD
    Redox
    Solaris
    WASI
    Windows
Show all
  • aarch64-darwin
  • aarch64-genode
  • aarch64-linux
  • aarch64-netbsd
  • aarch64-none
  • aarch64_be-none
  • arm-none
  • armv5tel-linux
  • armv6l-linux
  • armv6l-netbsd
  • armv6l-none
  • armv7a-darwin
  • armv7a-linux
  • armv7a-netbsd
  • armv7l-linux
  • armv7l-netbsd
  • avr-none
  • i686-cygwin
  • i686-darwin
  • i686-freebsd
  • i686-genode
  • i686-linux
  • i686-netbsd
  • i686-none
  • i686-openbsd
  • i686-windows
  • javascript-ghcjs
  • loongarch64-linux
  • m68k-linux
  • m68k-netbsd
  • m68k-none
  • microblaze-linux
  • microblaze-none
  • microblazeel-linux
  • microblazeel-none
  • mips-linux
  • mips-none
  • mips64-linux
  • mips64-none
  • mips64el-linux
  • mipsel-linux
  • mipsel-netbsd
  • mmix-mmixware
  • msp430-none
  • or1k-none
  • powerpc-netbsd
  • powerpc-none
  • powerpc64-linux
  • powerpc64le-linux
  • powerpcle-none
  • riscv32-linux
  • riscv32-netbsd
  • riscv32-none
  • riscv64-linux
  • riscv64-netbsd
  • riscv64-none
  • rx-none
  • s390-linux
  • s390-none
  • s390x-linux
  • s390x-none
  • vc4-none
  • wasm32-wasi
  • wasm64-wasi
  • x86_64-cygwin
  • x86_64-darwin
  • x86_64-freebsd
  • x86_64-genode
  • x86_64-linux
  • x86_64-netbsd
  • x86_64-none
  • x86_64-openbsd
  • x86_64-redox
  • x86_64-solaris
  • x86_64-windows