Management and Processing of Autonomous Recording Unit (ARU) Data
Overview
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.
New version number for CRAN re-submission.
From NEWS.md in the release
Install
Health
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 haltedERRORre-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 haltedERRORtestsr-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- 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
Documentation
- 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
Repository
- 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
Releases over time
Issues over time
PRs over time
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.
The R CMD check workflow runs on Linux, macOS and Windows, and on R-devel
GitHub Pages site last deployed 2025-07-28 · The repository has a site deploy workflow
pkgdown site last built 2025-07-28
Show all practicesHide 3 practices
Dependencies
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.
CRAN will archive these unless their check problems are fixed by the date shown. This package needs each one to install.
- suncalcfix by Oct 26
Code & Tests
Datasets
People & History
Pick two releases to compare their code metrics.
- RR 4.6.0 released · 2026-04-24
- unarchivedReturned to CRAN2025-07-28
- 0.7.3Latest
- archivedRemoved from CRAN2025-07-01requires archived package 'parzer'
- RR 4.5.0 released · 2025-04-11
- 0.7.22025-03-19 · diff ↗
- 0.7.12024-10-08 · diff ↗
- 0.7.02024-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 - RR 4.4.0 released · 2024-04-24
- 0.6.22024-04-18
- RR 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.
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.