Animal Trajectory Analysis

A toolbox to assist with statistical analysis of 2-dimensional animal trajectories. It provides simple access to algorithms for calculating and assessing a variety of characteristics such as speed and acceleration, as well as multiple measures of straightness or tortuosity. McLean & Skowron Volponi (2018) .

Travis-CI Build Status codecov CRAN_Status_Badge CRAN download count

Trajectory Analysis in R

An R package for analysing 2-dimensional animal trajectories, which represent the movements of animals through space and time. It provides functions to easily calculate various quantitative measures of trajectories such as speed and straightness or tortuosity. It also provides a range of other trajectory operations such as resampling to fixed step lengths (rediscretization), determining turning angles and step lengths, and so on. If you use trajr in your research, please cite McLean, D. J., & Skowron Volponi, M. A. (2018). trajr: An R package for characterisation of animal trajectories. Ethology, 124(6), 440-448.

trajr does not provide functionality to create trajectories; it operates on existing trajectories which are sequences of (x, y, time) coordinates.


$ install.packages("trajr")

Or to install the latest development version directly from Github:

$ install.packages("devtools")
$ devtools::install_github("JimMcL/trajr")

Or else, to install from Github and get the user documentation (vignette):

$ install.packages("devtools")
$ devtools::install_github("JimMcL/trajr", build_vignettes = TRUE)

Unfortunately, installing vignettes can be time-consuming.

Using trajr

The best way to start is to read the package vignette. After installation from CRAN (or from github including vignettes), run browseVignettes(package = "trajr").


Session info ----------------------------------------------------------------------------------------------------------------
 setting  value                       
 version  R version 3.5.0 (2018-04-23)
 system   x86_64, mingw32             
 ui       RStudio (1.1.447)           
 language (EN)                        
 collate  English_Australia.1252      
 tz       Australia/Sydney            
 date     2018-05-09                  

Packages --------------------------------------------------------------------------------------------------------------------
 package   * version    date       source        
 base      * 3.5.0      2018-04-23 local         
 compiler    3.5.0      2018-04-23 local         
 datasets  * 3.5.0      2018-04-23 local         
 devtools    1.13.5     2018-02-18 CRAN (R 3.5.0)
 digest      0.6.15     2018-01-28 CRAN (R 3.5.0)
 graphics  * 3.5.0      2018-04-23 local         
 grDevices * 3.5.0      2018-04-23 local         
 memoise     1.1.0      2017-04-21 CRAN (R 3.5.0)
 methods   * 3.5.0      2018-04-23 local         
 stats     * 3.5.0      2018-04-23 local         
 tools       3.5.0      2018-04-23 local         
 trajr     * 1.1.0      2018-05-07 local         
 utils     * 3.5.0      2018-04-23 local         
 withr       2.1.2      2018-03-15 CRAN (R 3.5.0)
 yaml        2.1.18     2018-03-08 CRAN (R 3.5.0)```


Reference manual

It appears you don't have a PDF plugin for this browser. You can click here to download the reference manual.


1.3.0 by Jim McLean, 10 days ago

Report a bug at

Browse source code at

Authors: Jim McLean [aut, cre]

Documentation:   PDF Manual  

MIT + file LICENSE license

Imports signal, utils, stats, graphics, plotrix, grDevices

Suggests knitr, rmarkdown, testthat, BH, readr, tcltk

See at CRAN