Skip to content
ARUtools needs suncalc, which CRAN will archive unless its check problems are fixed by Oct 26.

ARUtools

0.7.3Package record

Management and Processing of Autonomous Recording Unit (ARU) Data

0packages depend
3.3Kdownloads / year
89.0%test coverage
12/13flavors OK

Overview

About
Maintained by David HopeCRAN page ↗GitHub ↗Website ↗Issues ↗Declared funder: Government of Canada

Parse Autonomous Recording Unit (ARU) data and for sub-sampling recordings. Extract Metadata from your recordings, select a subset of recordings for interpretation, and prepare files for processing on the 'WildTrax' https://wildtrax.ca/ platform. Read and process metadata from recordings collected using the SongMeter and BAR-LT types of ARUs.

Changes in 0.7.3

New version number for CRAN re-submission.

From NEWS.md in the release

Install

Health

CRAN checks
1ERROR12OK
Check messages
ERRORexamplesr-devel-windows-x86_64
Running examples in 'ARUtools-Ex.R' failed
The error most likely occurred in:

> ### Name: calc_selection_weights
> ### Title: Calculate Selection Weights
> ### Aliases: calc_selection_weights
> 
> ### ** Examples
> 
> s <- clean_site_index(example_sites_clean,
+   name_date_time = c("date_time_start", "date_time_end")
+ )
> m <- clean_metadata(project_files = example_files) |>
+   add_sites(s) |>
+   calc_sun()
Extracting ARU info...
Extracting Dates and Times...
Joining by columns `date_time_start` and `date_time_end`
Error in `dplyr::mutate()`:
ℹ In argument: `times = purrr::map2(.data$dates, .data$tz,
  ~calc_all_ss(.x, tz = .y))`.
Caused by error in `purrr::map2()`:
ℹ In index: 3.
Caused by error in `C_force_tz()`:
! CCTZ: Unrecognized output timezone: "America/Winnipeg"
Backtrace:
     ▆
  1. ├─ARUtools::calc_sun(...)
  2. │ ├─dplyr::select(...)
  3. │ ├─tidyr::unnest(...)
  4. │ ├─dplyr::mutate(...)
  5. │ └─dplyr:::mutate.data.frame(...)
  6. │   └─dplyr:::mutate_cols(.data, dp
...[truncated]...
allingHandlers(...)
 15. │   ├─purrr:::call_with_cleanup(...)
 16. │   └─ARUtools (local) .f(.x[[i]], .y[[i]], ...)
 17. │     └─ARUtools:::calc_all_ss(.x, tz = .y)
 18. │       └─ARUtools:::calc_ss(dates, tz)
 19. │         ├─dplyr::as_tibble(...)
 20. │         ├─dplyr::relocate(...)
 21. │         ├─dplyr::rename(...)
 22. │         ├─dplyr::mutate(...)
 23. │         └─suncalc::getSunlightTimes(...)
 24. │           ├─base::which(...)
 25. │           ├─lubridate::force_tz(...)
 26. │           └─lubridate:::force_tz.default(...)
 27. │             └─timechange::time_force_tz(time, tz = tzone, roll_dst = roll_dst)
 28. │               └─timechange:::.force_tz(time, tz, tzout, roll_dst)
 29. │                 ├─timechange:::from_posixct(...)
 30. │                 └─timechange:::C_force_tz(to_posixct(time), tz, roll_dst)
 31. └─base::.handleSimpleError(...)
 32.   └─purrr (local) h(simpleError(msg, call))
 33.     └─cli::cli_abort(...)
 34.       └─rlang::abort(...)
Execution halted
ERRORre-building of vignette outputsr-devel-windows-x86_64
Error(s) in re-building vignettes:
--- re-building 'ARUtools.Rmd' using rmarkdown

Quitting from ARUtools.Rmd:194-197 [unnamed-chunk-14]
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
<error/dplyr:::mutate_error>
Error in `dplyr::mutate()`:
ℹ In argument: `times = purrr::map2(.data$dates, .data$tz,
  ~calc_all_ss(.x, tz = .y))`.
Caused by error in `purrr::map2()`:
ℹ In index: 3.
Caused by error in `C_force_tz()`:
! CCTZ: Unrecognized output timezone: "America/Winnipeg"
---
Backtrace:
     ▆
  1. ├─ARUtools::calc_sun(m)
  2. │ ├─dplyr::select(...)
  3. │ ├─tidyr::unnest(...)
  4. │ ├─dplyr::mutate(...)
  5. │ └─dplyr:::mutate.data.frame(...)
  6. │   └─dplyr:::mutate_cols(.data, dplyr_quosures(...), by)
  7. │     ├─base::withCallingHandlers(...)
  8. │     └─dplyr:::mutate_col(dots[[i]], data, mask, new_columns)
  9. │       └─mask$eval_all_mutate(quo)
 10. │         └─dplyr (local) eval()
 11. └─purrr::map2(.data$dates, .data$tz, ~calc_all_ss(.x, tz =
...[truncated]...
5.             ├─lubridate::force_tz(...)
 26.             └─lubridate:::force_tz.default(...)
 27.               └─timechange::time_force_tz(time, tz = tzone, roll_dst = roll_dst)
 28.                 └─timechange:::.force_tz(time, tz, tzout, roll_dst)
 29.                   ├─timechange:::from_posixct(...)
 30.                   └─timechange:::C_force_tz(to_posixct(time), tz, roll_dst)
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

Error: processing vignette 'timezones.Rmd' failed with diagnostics:
ℹ In argument: `times = purrr::map2(.data$dates, .data$tz,
  ~calc_all_ss(.x, tz = .y))`.
Caused by error in `purrr::map2()`:
ℹ In index: 3.
Caused by error in `C_force_tz()`:
! CCTZ: Unrecognized output timezone: "America/Winnipeg"
--- failed re-building 'timezones.Rmd'

SUMMARY: processing the following files failed:
  'ARUtools.Rmd' 'SubSample.Rmd' 'multisampling.Rmd' 'spatial.Rmd'
  'timezones.Rmd'

Error: Vignette re-building failed.
Execution halted
ERRORtestsr-devel-windows-x86_64
Running 'testthat.R' [42s]
Running the tests in 'tests/testthat.R' failed.
Complete output:
  > library(testthat)
  > library(ARUtools)
  > 
  > test_check("ARUtools")
  Saving _problems/test-06_calc_sun-156.R
  Saving _problems/test-08_selections-67.R
  Saving _problems/test-08_selections-101.R
  Extracting Dates and Times...
  ! Omitted 1 extra, non-json/GPS files
  ! Detected 2 log files
  [ FAIL 5 | WARN 0 | SKIP 4 | PASS 507 ]
  
  ══ Skipped tests (4) ═══════════════════════════════════════════════════════════
  • On CRAN (3): 'test-08_selections.R:1:1', 'test-10_clean_logs.R:1:1',
    'test-10_clean_logs.R:32:1'
  • SoX not available (1): 'test-07_wave_files.R:193:3'
  
  ══ Failed tests ════════════════════════════════════════════════════════════════
  ── Error ('test-06_calc_sun.R:36:3'): calc_ss() ────────────────────────────────
  Error in `C_force_tz(to_posixct(time), tz, roll_dst)`: CCTZ: Unrecognized output timezone: "America/Winnipeg"
  Backtrace:
       ▆
    1. ├─testt
...[truncated]...
z"), times = purrr::map2(.data$dates, .data$tz, ~calc_all_ss(.x, tz = .y)))`: i In argument: `times = purrr::map2(.data$dates, .data$tz, ~calc_all_ss(.x, tz = .y))`.
  Caused by error in `purrr::map2()`:
  i In index: 3.
  Caused by error in `C_force_tz()`:
  ! CCTZ: Unrecognized output timezone: "America/Winnipeg"
  ── Error ('test-08_selections.R:98:3'): sample_recordings() ────────────────────
  <dplyr:::mutate_error/rlang_error/error/condition>
  Error in `dplyr::mutate(tidyr::nest(tidyr::drop_na(dplyr::distinct(dplyr::select(m, "date", "tz", "longitude", "latitude"))), dates = -"tz"), times = purrr::map2(.data$dates, .data$tz, ~calc_all_ss(.x, tz = .y)))`: i In argument: `times = purrr::map2(.data$dates, .data$tz, ~calc_all_ss(.x, tz = .y))`.
  Caused by error in `purrr::map2()`:
  i In index: 3.
  Caused by error in `C_force_tz()`:
  ! CCTZ: Unrecognized output timezone: "America/Winnipeg"
  
  [ FAIL 5 | WARN 0 | SKIP 4 | PASS 507 ]
  Error:
  ! Test failures.
  Execution halted

CRAN check page ↗

Slowest check: 5.0 min · r-oldrel-windows-x86_64
Status changes
  • ERROR12 OK, 1 ERROR2026-10-15
  • OK13 OK2026-08-05
  • NOTE12 OK, 1 NOTE2026-08-01
  • OK13 OK2026-06-09
  • ERROR12 OK, 1 ERROR2026-06-08
Show 1 earlier changeHide 1 earlier change
  • OK14 OK2026-03-10
Advisories

none known

Documentation

In release 0.7.3
READMEYes · 464 wordsVignettesYes · 7 · dynamicNEWSYes · 100% structured · mentions 0.7.3Citation fileYes · software entry onlyWebsiteYes · pkgdown
Help pages
40 (1 internal)includes a package overview page
Examples that run
100%31 run in a plain check (5 of them under a condition)
Exported functions with examples
100%
Documented parameters
100%
Return-value docs
94%
Help pages citing references
0%

Downloads

3.3K
CRAN downloads in the past year
Rank #10,031 · ~9/day · ~272/mo
Daily download trend is not available in this view yet.
42230 days
98790 days
3.3K1 year
Compare downloads with other packages →
Also on89 r2u59 autocran

Repository

0Stars
3Forks
3Open issues
1Open PRs
10Releases
442Commits
3Commit identities
442 commits · Last activity 2025-07-28
Responsiveness
How these are sampled
PRs merged (all time)
100%
Median days to close, 50 most recently updated closed issues
62
Median days to close, 50 most recently updated closed PRs
0

Forks over time

2024-11-01 · 32026-07-07 · 3
PracticesBeta

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

Checks run against github.com/arutools/arutools on 2026-10-11.

Continuous integration (2)
GitHub ActionsR CMD check workflow

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

Governance and community (1)
Issue templates
Docs source (4)
README.Rmdpkgdown

GitHub Pages site last deployed 2025-07-28 · The repository has a site deploy workflow

pkgdown site last built 2025-07-28

Coverage (1)
Coverage reporting (Codecov)
Show all practicesHide 3 practices
Reproducibility and dev environment (1)
data-raw/
CRAN release process (1)
cran-comments.md
Lint, format, editor (1)
RStudio project
How this is detected·Detection ruleset v3 (2026-09-26)

Dependencies

Declared dependencies
32 external dependencies (excludes base and recommended)

Installing ARUtools adds 69 packages (45 with compiled code, 70 MB of source tarballs). Heaviest: stringi 11 MB, sf 9.3 MB, data.table 5.7 MB.

Depends (1)
R >= 4.1.0
LinkingTo (0)
none
Enhances (0)
none
Dependencies facing archival

CRAN will archive these unless their check problems are fixed by the date shown. This package needs each one to install.

Reverse dependencies
0direct
0indirect

Nothing depends on this yet.

Datasets

People & History

People (3)
Author, Maintainer since 0.6.2 (2024)
Copyright holder, Funder
Releases (5)

Pick two releases to compare their code metrics.

  • R
    R 4.6.0 released · 2026-04-24
  • unarchivedReturned to CRAN
    2025-07-28
  • 0.7.3Latest
    record
    2025-07-28 · current release · diff ↗
  • archivedRemoved from CRAN
    2025-07-01
    requires archived package 'parzer'
  • R
    R 4.5.0 released · 2025-04-11
  • 0.7.2
    record
    2025-03-19 · diff ↗
  • 0.7.1
    record
    2024-10-08 · diff ↗
  • 0.7.0
    record
    2024-09-06 · diff ↗ ·
    added 7 exports
    add_pattern_aru_type, create_lookaround, create_pattern_tz_offset, get_pattern, guess_ARU_type, meta_clean_logs, set_pattern
  • R
    R 4.4.0 released · 2024-04-24
  • 0.6.2
    record
    2024-04-18
  • R
    R 4.3.0 released · 2023-04-21

Package metadata

First published
2024-04-18
Total releases
5 / 2 yrs
License
MIT + file LICENSE OSI
Minimum R
≥ 4.1.0
Bundled data
5.3 KB / 7 files
Download size
856 KB

Cite

Cite this package

Run in R for the authors' entry:

citation("ARUtools")

The package provides a citation file, so citation() returns the authors' own entry.

Cite the R Observatory

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

APA

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

From data release v2026-10-18, 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 →

Privacy choices

These apply to this browser and are stored on this device only. Nothing about your choice is sent to us.

Read the privacy policy