radiatR: Analyse and Visualise Headings and Trajectories on the Unit Disk

A complete pipeline for analysing directional data – headings and trajectories on the unit disk. Supply a table of angles directly, or reconstruct headings from movement trajectories imported from tracking tools ('EthoVision', 'DeepLabCut', 'SLEAP', 'TRex', 'ANY-maze', 'TrackMate', 'idtracker.ai', and others) via a unified dialect-based loader system, including multi-bodypart pose estimation with likelihood-weighted centroid. Derives per-trial heading directions using multiple rules (ring-crossing, distal point, pose body-axis, velocity-based, and more). Computes circular statistics including mean direction, resultant length, von Mises and wrapped Cauchy parametric fits, circular correlation (circular-linear and circular-circular), circular-linear regression (Fisher and Lee (1992) <doi:10.2307/2532334>), model selection among orientation models (Fitak and Johnsen (2017) <doi:10.1242/jeb.167056>), and uniformity and multi-sample hypothesis tests (Rayleigh, Watson-Williams, Hermans-Rasson (Landler, Ruxton and Malkemper (2019) <doi:10.1186/s12898-019-0246-8>), and others) with multiple-comparison correction. Path tortuosity follows Benhamou (2004) <doi:10.1016/j.jtbi.2004.03.016>. Renders publication-quality 'ggplot2' radial plots with overlaid rose diagrams, parametric density curves, non-parametric kernel density estimates, and circular boxplots (Buttarazzi, Pandolfo and Porzio (2018) <doi:10.1111/biom.12889>). Includes a browser-based 'shiny' graphical interface requiring no R coding via launch_app().

Version:	0.1.3
Depends:	R (≥ 4.1.0)
Imports:	rlang, ggplot2, tibble, vctrs, circular, methods, utils, stats
Suggests:	bpDir, dplyr (≥ 1.0.0), testthat (≥ 3.2.0), knitr, rmarkdown, ggrepel, arrow, data.table (≥ 1.14.0), jsonlite, readr, readxl, yaml, withr, writexl, shiny (≥ 1.7.0), bslib (≥ 0.5.0), pkgload, png, jpeg, svglite, shinytest2, chromote, CircMLE, vdiffr, sphunif
Published:	2026-10-27
DOI:	10.32614/CRAN.package.radiatR (may not be active yet)
Author:	John D. Kirwan [aut, cre, cph], A. & M.W. Mathis Labs [cph] (test fixture tests/testthat/fixtures/real/dlc_CollectedData_Pranav.csv, from 'DeepLabCut'), Talmo Pereira [cph] (example file inst/extdata/sleap_example.csv, from 'SLEAP'), The Trustees of Princeton University [cph] (example file inst/extdata/sleap_example.csv, from 'SLEAP')
Maintainer:	John D. Kirwan <john at jkirwan.org>
BugReports:	https://github.com/JohnKirwan/radiatR/issues
License:	GPL (≥ 3)
Copyright:	file inst/COPYRIGHTS radiatR copyright details
URL:	https://johnkirwan.github.io/radiatR/, https://github.com/JohnKirwan/radiatR
NeedsCompilation:	no
Language:	en-GB
Materials:	README, NEWS
CRAN checks:	radiatR results

Documentation:

Reference manual:	radiatR.html , radiatR.pdf
Vignettes:	Guide for AI agents (source, R code) Circular Statistics and Distribution Overlays (source, R code) radiatR design contract (source, R code) Working with Loaders (source, R code) Quantifying path shape (source, R code)

Downloads:

Package source:	radiatR_0.1.3.tar.gz
Windows binaries:	r-devel: not available, r-release: not available, r-oldrel: not available
macOS binaries:	r-release (arm64): not available, r-oldrel (arm64): not available, r-release (x86_64): not available, r-oldrel (x86_64): radiatR_0.1.3.tgz

Linking:

Please use the canonical form https://CRAN.R-project.org/package=radiatR to link to this page.