Package: radiatR 0.1.3

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().

Authors:John D. Kirwan [aut, cre, cph], A. & M.W. Mathis Labs [cph], Talmo Pereira [cph], The Trustees of Princeton University [cph]