R Observatory: Metrics for tagtools version 0.3.0

Balamuta, James Joseph

doi:10.5281/zenodo.21843040

tagtools

0.3.0Package record

Work with Data from High-Resolution Biologging Tags

0packages depend

3.1Kdownloads / year

23.7%test coverage

13/13flavors OK

Overview

About

Maintained by Stacy DeRuiterCRAN page ↗GitHub ↗Website ↗Issues ↗

High-resolution movement-sensor tags typically include accelerometers to measure body posture and sudden movements or changes in speed, magnetometers to measure direction of travel, and pressure sensors to measure dive depth in aquatic or marine animals. The sensors in these tags usually sample many times per second. Some tags include sensors for speed, turning rate (gyroscopes), and sound. This package provides software tools to facilitate calibration, processing, and analysis of such data. Tools are provided for: data import/export; calibration (from raw data to calibrated data in scientific units); visualization (for example, multi-panel time-series plots); data processing (such as event detection, calculation of derived metrics like jerk and dynamic acceleration, dive detection, and dive parameter calculation); and statistical analysis (for example, track reconstruction, a rotation test, and Mahalanobis distance analysis).

Changes in 0.3.0

This release removes a dependency, speeds up filtering and decimation via C++,

and fixes several bugs.

Breaking changes

m_dist() documentation clarified and input names changed to match rest of tagtools (all now snake case); unused inputs expStart and expEnd removed. To update old code, change input names: smoothDur to smooth_dur, cumSum to cum_sum, and baselineStart, baselineEnd, and BL_COV to baseline_start, baseline_end, and bl_cov.

New features

read_cats()` now can now read deployments with multiple csv files.
dec_dc() now implements convolution via RCppArmadillo, which speeds it up.
gsignal package dependency replaces signal, for speed and flexibility.

Show all changes in 0.3.0Hide the rest of the changes in 0.3.0

prh_predictor1() and prh_predictor2() interactivity is now optional, toggled via a new input argument.

Minor improvements and fixes

latex2exp package dependency removed, as requested by CRAN Team.
m_dist() documentation clarified and input names changed to match rest of tagtools (all now snake case); unused inputs expStart and expEnd removed. To update old code, change input names: smoothDur to smooth_dur, cumSum to cum_sum, and baselineStart, baselineEnd, and BL_COV to baseline_start, baseline_end, and bl_cov.
norm2() checks that output is a column vector (1-column matrix).
o2p() and read_cats() helper functions moved outside function definitions.
save_nc() now accepts dots input.
add_nc() works correctly even if sensor data stream name vname not input.

From NEWS.md in the release

Install

R (CRAN)pak (dev)Ubuntu (r2u)Fedora (COPR)openSUSE (OBS)

install.packages("tagtools", repos = "https://cloud.r-project.org/")

Installs the current CRAN release. Prebuilt binaries on Windows and macOS.

if (!requireNamespace("pak", quietly = TRUE))
  install.packages("pak", repos = "https://cloud.r-project.org/")
pak::pak("animaltags/tagtools_r")

Development version from animaltags/tagtools_r. Installs pak first if it is not already available.

Release

# enable cranapt (r2u) if it is not already set up, then install
grep -rqs r2u.stat.illinois.edu /etc/apt/sources.list /etc/apt/sources.list.d/ \
  || curl -fsSL https://raw.githubusercontent.com/eddelbuettel/r2u/master/inst/scripts/add_cranapt_noble.sh | sudo bash
sudo apt install -y r-cran-tagtools

Fast Ubuntu binaries via r2u (no compilation). The cranapt setup runs once and is skipped when it is already enabled. We list this channel from recorded r2u download activity rather than from a live index of the repository, so treat it as last known rather than guaranteed.

bspm (used by r2u) also needs make: sudo apt install make

# enable the iucar/cran COPR if it is not already present, then install
ls /etc/yum.repos.d/*iucar*cran*.repo >/dev/null 2>&1 \
  || sudo dnf copr enable -y iucar/cran
sudo dnf install -y R-CRAN-tagtools

RPMs from the iucar/cran COPR, rebuilt from CRAN.

For install.packages() integration in R, also: sudo dnf install R-CoprManager

# add the autoCRAN OBS repo (Tumbleweed) if it is missing, then install
zypper -q lr | grep -qi autoCRAN \
  || sudo zypper addrepo https://download.opensuse.org/repositories/devel:/languages:/R:/autoCRAN/openSUSE_Tumbleweed/devel:languages:R:autoCRAN.repo
sudo zypper install -y R-tagtools

RPMs auto-built from CRAN on openSUSE OBS (Tumbleweed). We list this channel from recorded autoCRAN download activity rather than from a live index of the repository, so treat it as last known rather than guaranteed.

Health

CRAN checks

13OK

CRAN check page ↗

Slowest check: 3.8 min · r-devel-windows-x86_64

Status changes

OK13 OK2026-08-04
NOTE12 OK, 1 NOTE2026-08-01
OK13 OK2026-06-09
ERROR12 OK, 1 ERROR2026-06-07
OK14 OK2026-04-22

Show 2 earlier changesHide 2 earlier changes

ERROR13 OK, 1 ERROR2026-04-18
OK14 OK2026-03-10

Advisories

none known

How this is measured·How advisories are found

Documentation

In release 0.3.0

READMEYes · 218 wordsVignettesNoNEWSYes · 100% structured · mentions 0.3.0Citation fileNoWebsiteYes · pkgdown

The repository also keeps web-only articles.

Help pages: 89 (1 internal)includes a package overview page
Examples that run: 99%72 run in a plain check · 1 never run
Exported functions with examples: 88%
Documented parameters: 99%
Return-value docs: 100%
Help pages citing references: 1%

How these are measured

Downloads

3.1K

CRAN downloads in the past year

Rank #12,474 · ~9/day · ~262/mo

Releases R versions

Daily download trend is not available in this view yet.

36630 days

89590 days

3.1K1 year

Compare downloads with other packages →

Also on372 r2u3 autocran

How downloads are counted

Repository

animaltags/tagtools_r ↗Organization: animaltags

10Stars

1Forks

6Open issues

0Open PRs

1Releases

213Commits

3Commit identities

213 commits · Last activity 2026-08-13 · 0% stars, 30d

Responsiveness

How these are sampled

PRs merged (all time): 100%
Median days to close, 50 most recently updated closed issues: 18
Median days to close, 50 most recently updated closed PRs: 0

Stars over time

2024-12-17 · 72026-07-28 · 10

How these are measured

PracticesBeta

7 development-tooling and community-health practices detected across 3 families in the upstream repository

Checks run against github.com/animaltags/tagtools_r on 2026-10-21.

Continuous integration (2)

GitHub ActionsR CMD check workflow

The R CMD check workflow runs on Linux, macOS and Windows, and on R-devel

Docs source (3)

README.Rmdpkgdown

GitHub Pages site last deployed 2026-08-13

pkgdown site last built 2025-12-01, before release 0.3.0 (2025-12-18)

CRAN release process (2)

cran-comments.mdCRAN-SUBMISSION

How this is detected·Detection ruleset v4 (2026-10-20)

Dependencies

Declared dependencies

19 external dependencies (excludes base and recommended)

Installing tagtools adds 84 packages (46 with compiled code, 71 MB of source tarballs). Heaviest: stringi 11 MB, ggplot2 6.0 MB, data.table 5.7 MB.

Depends (1)

R >= 4.1

Imports (17)

CircStats cowplot dplyr ggplot2graphicsgsignal lubridate ncdf4 plotly pracma Rcpp readrstatsstringrutilszoo zoom

LinkingTo (2)

Rcpp RcppArmadillo

Suggests (3)

knitr rmarkdown testthat

Enhances (0)

none

Dependency license breakdown →

Reverse dependencies

0direct

0indirect

Nothing depends on this yet.

How these are counted

Code & Tests

Datasets

People & History

People (9)

Stacy DeRuiter

Samuel Fynewever

Author

Mark Johnson

Author, Copyright holder

Tiago Marques

Author

Ye Joo McNamara-Oh

Author

(Oghenesuvwe) Su Ogedegbe

Author

David Sweeney

Author

(Oghenkevwe) Racheal Tejevbo

Author

Yuqian Wang

Author

Releases (3)

Pick two releases to compare their code metrics.

R
R 4.6.0 released · 2026-04-24
0.3.0Latest
record
2025-12-18 · current release · diff ↗ ·
added 2 exports
conv_cpp, read_cats_csv
R
R 4.5.0 released · 2025-04-11
0.2.0
record
2024-06-28 · diff ↗ ·
removed 1 export
col_line

added 1 export
plott_base
R
R 4.4.0 released · 2024-04-24
0.1.0
record
2023-07-18
R
R 4.3.0 released · 2023-04-21

Package metadata

First published: 2023-07-18
Total releases: 3 / 3 yrs
License: GPL (>= 3) OSI
Minimum R: ≥ 4.1
Bundled data: 572 KB / 2 files
Download size: 947 KB

Appears in task views

Processing and Analysis of Tracking Data

Cite

Cite this package

Run in R for the authors' preferred citation:

citation("tagtools")

Format

DeRuiter, S., Fynewever, S., Johnson, M., Marques, T., McNamara-Oh, Y. J., Ogedegbe, (. S., Sweeney, D., Tejevbo, (. R., & Wang, Y. (2025). tagtools: Work with Data from High-Resolution Biologging Tags (Version 0.3.0) [Computer software]. https://doi.org/10.32614/CRAN.package.tagtools

This package has no citation file, so citation() returns this entry built from DESCRIPTION.

Cite the R Observatory

For a number measured here: a download total, a coverage figure, an archival date.

Format

APA

Balamuta, J. J. (2026). R Observatory: Metrics for tagtools version 0.3.0 [Data set]. HJJB, LLC. Data release v2026-10-23. https://doi.org/10.5281/zenodo.21843040

From data release v2026-10-23, which the citation names so these numbers can be found later. More on citing and the projects behind them.

Report a problem with this page →