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 |
| 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) |
| Package source: | radiatR_0.1.3.tar.gz |
| Windows binaries: | r-devel: not available, r-release: radiatR_0.1.3.zip, r-oldrel: not available |
| macOS binaries: | r-release (arm64): radiatR_0.1.3.tgz, r-oldrel (arm64): radiatR_0.1.3.tgz, r-release (x86_64): radiatR_0.1.3.tgz, r-oldrel (x86_64): radiatR_0.1.3.tgz |
Please use the canonical form https://CRAN.R-project.org/package=radiatR to link to this page.