R Observatory: Metrics for birdscanR version 0.3.0

Balamuta, James Joseph

doi:10.5281/zenodo.21843040

birdscanR

0.3.0Package record

Migration Traffic Rate Calculation Package for 'Birdscan MR1' Radars

0packages depend

3.2Kdownloads / year

–test coverage

13/13flavors OK

Overview

About

Maintained by Birgen HaestCRAN page ↗GitHub ↗Issues ↗

Extract data from 'Birdscan MR1' 'SQL' vertical-looking radar databases, filter, and process them to Migration Traffic Rates (#objects per hour and km) or density (#objects per km3) of, for example birds, and insects. Object classifications in the 'Birdscan MR1' databases are based on the dataset of Haest et al. (2021) doi:10.5281/zenodo.5734960). Migration Traffic Rates and densities can be calculated separately for different height bins (with a height resolution of choice) as well as over time periods of choice (e.g., 1/2 hour, 1 hour, 1 day, day/night, the full time period of observation, and anything in between). Two plotting functions are also included to explore the data in the 'SQL' databases and the resulting Migration Traffic Rate results. For details on the Migration Traffic Rate calculation procedures, see Schmid et al. (2019) doi:10.1111/ecog.04025.

Changes in 0.3.0

Added functionality: The function 'computeDensity()' was added to calculate the density (expressed as #objects / km3). Note that this function only works for Birdscan MR1 database versions \>= 1.7.0.4 as the variable feature37.speed is required for the density calculation (#40{.uri}).
Added functionality: The function 'getBatClassification()' was added to get the data from the MR1 SQL tables 'bat_classification' and 'bat_class_probability'. The function 'extractDbData()' was updated to also extract the bat classification results using the prior function (#36{.uri}).
Added functionality: The function 'reclassToBats()' was added to change the class of the echoes to 'bat' for those having a classification probability higher than a specified threshold (#36{.uri}).
Added functionality: The 'feature37.speed' from the new Birdscan software v 1.7 is now also being extracted when calling the function 'getCollectionTable()' (#39{.uri}).
Bug fix: Conditional 'if (exists("mtrDayNight", envir = environment()))' caused bug in 'computeMTR()' function when variable was already defined in a user script (i.e., outside of the package). This has been fixed (#38{.uri}).

From NEWS.md in the release

Install

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

install.packages("birdscanR", 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("BirdScanCommunity/birdscanR")

Development version from BirdScanCommunity/birdscanR. 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-birdscanr

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-birdscanR

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

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

Health

CRAN checks

13OK

CRAN check page ↗

Slowest check: 1.7 min · r-oldrel-windows-x86_64

Status changes

OK13 OK2026-08-05
NOTE12 OK, 1 NOTE2026-08-01
OK14 OK2026-04-09
ERROR13 OK, 1 ERROR2026-03-10

Advisories

none known

How this is measured·How advisories are found

Documentation

In release 0.3.0

README· In the repository, left out of the releaseVignettesYes · 1 · dynamicNEWSYes · 100% structured · mentions 0.3.0Citation fileYes · computed when R runs it

Help pages: 32
Examples that run: 7%2 run in a plain check · 28 never run
Exported functions with examples: 100%
Documented parameters: 100%
Return-value docs: 100%
Help pages citing references: 0%

Vignettes (1)

birdscanR HTML

How these are measured

Downloads

3.2K

CRAN downloads in the past year

Rank #12,080 · ~9/day · ~263/mo

Releases R versions

Daily download trend is not available in this view yet.

36030 days

90590 days

3.2K1 year

Compare downloads with other packages →

Also on1.4K r2u

How downloads are counted

Repository

birdscancommunity/birdscanr ↗Organization: BirdScanCommunity

3Stars

5Forks

20Open issues

4Open PRs

3Releases

530Commits

8Commit identities

License file reads as GPL-3.0 · 530 commits · Last activity 2026-06-23 · Default branch at 0.3.0.9029, ahead of CRAN 0.3.0 (checked 2026-10-18) · Discussions: 1 post

Responsiveness

How these are sampled

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

Stars over time

2023-09-26 · 22026-07-07 · 3

How these are measured

PracticesBeta

12 development-tooling and community-health practices detected across 5 families in the upstream repository

Checks run against github.com/birdscancommunity/birdscanr on 2026-10-18.

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

Code of conductContributing guide

Docs source (4)

README.Rmdpkgdown

GitHub Pages site last deployed 2026-06-23 · The repository has a site deploy workflow

CRAN release process (2)

cran-comments.mdCRAN-SUBMISSION

Show all practicesHide 1 practice

Lint, format, editor (2)

Lint workflowRStudio project

How this is detected·Detection ruleset v3 (2026-09-26)

Dependencies

Declared dependencies

15 external dependencies (excludes base and recommended)

Installing birdscanR adds 47 packages (29 with compiled code, 52 MB of source tarballs). Heaviest: stringi 11 MB, sf 9.3 MB, ggplot2 6.0 MB.

Depends (1)

R >= 3.5.0

Imports (18)

DBI dplyr ggplot2grDevicesmagrittr suntoolsmethodsmodi reshape2 RODBC RPostgreSQL rlang rstudioapi spstatstibble tidyrutils

LinkingTo (0)

none

Suggests (1)

knitr

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

Birgen Haest

Author, Maintainer since 0.1.2 (2023)

Author

Contributor

Contributor

Contributor

Contributor

Releases (3)

Pick two releases to compare their code metrics.

R
R 4.6.0 released · 2026-04-24
R
R 4.5.0 released · 2025-04-11
0.3.0Latest
record
2024-07-05 · current release · diff ↗ ·
added 3 exports
computeDensity, getBatClassification, reclassToBats
R
R 4.4.0 released · 2024-04-24
0.2.0
record
2023-10-06 · diff ↗
R
R 4.3.0 released · 2023-04-21
0.1.2
record
2023-02-17
R
R 4.2.0 released · 2022-04-22

Package metadata

First published: 2023-02-17
Total releases: 3 / 3 yrs
License: GPL-3 OSI
Minimum R: ≥ 3.5.0
Bundled data: 0.5 KB / 2 files
Download size: 502 KB

Cite

Cite this package

Run in R for the authors' preferred citation:

citation("birdscanR")

The package provides a citation file that builds its entry when R runs it. Run citation() to see it.

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 birdscanR version 0.3.0 [Data set]. HJJB, LLC. Data release v2026-10-21. https://doi.org/10.5281/zenodo.21843040

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