FishDiveR

1.1.0

Classify Aquatic Animal Behaviours from Vertical Movement Data

0packages depend

1.5Kdownloads / year

82.1%test coverage

12/13checks pass

Overview

About

Maintained by Calvin BealeFirst published 2026-01-261 releasesCRAN page ↗GitHub ↗

Quantitatively analyse depth time-series data from pop-up satellite archival tags (PSATs) through the application of continuous wavelet transformation (CWT) combined with Principal Component Analysis (PCA), and k-means clustering. Import, crop, and plot depth time-depth records (TDRs). Using CWT to detect important signals within the non-stationary data, we create daily wavelet statistics to summarise vertical movements on different wavelet periods and combine with daily and diel depth statistics. Classify depth time-series with unsupervised k-means clustering into 24-hour periods of vertical movement behaviour with distinct patterns of vertical movement. Plot example days from each behaviour cluster, and plot the TDR coloured by cluster. Based on principals of combining CWT with k-means first developed by Sakamoto (2009) doi:10.1371/journal.pone.0005379 and redeveloped by Beale (2026) doi:10.21203/rs.3.rs-6907076/v1.

Install

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

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

Development version from calvinsbeale/FishDiveR. 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-fishdiver

Fast Ubuntu binaries via r2u (no compilation). The cranapt setup runs once and is skipped when it is already enabled.

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

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

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

Health

CRAN checks

1NOTE12OK

Failing flavors

NOTE r-devel-linux-x86_64-debian-gcc

Slowest check: 6.5 min · r-devel-linux-x86_64-fedora-clang

Code health

Yes

Tests · ratio 0.12

82.1%

Coverage · measured lines

100%

Documentation · exports

Dependencies · direct

Check history

NOTE2026-08-01
12 OK · 1 NOTE · 0 WARNING · 0 ERROR · 0 FAILURE
OK2026-06-09
13 OK · 0 NOTE · 0 WARNING · 0 ERROR · 0 FAILURE
ERROR2026-06-08
12 OK · 0 NOTE · 0 WARNING · 1 ERROR · 0 FAILURE
OK2026-04-25
12 OK · 0 NOTE · 0 WARNING · 0 ERROR · 0 FAILURE
NOTE2026-04-10
11 OK · 3 NOTE · 0 WARNING · 0 ERROR · 0 FAILURE

Show 2 earlier snapshots

ERROR2026-04-09
10 OK · 3 NOTE · 0 WARNING · 1 ERROR · 0 FAILURE
NOTE2026-03-10
11 OK · 3 NOTE · 0 WARNING · 0 ERROR · 0 FAILURE

Documentation

READMEYes · 1,585 wordsVignettesNopkgdown siteNoNEWSYes · 67% structuredCode of conductNoContributing guideNo

Examples that run: 100%
Documented parameters: 100%
Return-value docs: 100%
References docs: 0%

Downloads

1.5K

CRAN downloads in the past year

Rank #19,386 · ~4/day · ~122/mo

Releases R versions

Daily download trend is not available in this view yet.

20430 days

57390 days

1.5K1 year

Compare downloads with other packages →

Also on93 r2u

Repository

GitHub ↗ calvinsbeale/fishdiver

3Stars

0Forks

1Open issues

0Open PRs

0Releases

89Commits

1Contributors

License GPL-3.0 · 89 commits · Last activity 2026-05-19 · 0% stars, 30d

Stars over time

2026-03-23 · 12026-07-07 · 3

Repository practices

Upstream repositoryBeta

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

Checks run against github.com/calvinsbeale/fishdiver on 2026-07-31.

Continuous integration (1)

GitHub Actions

CRAN release process (2)

cran-comments.mdCRAN-SUBMISSION

Docs source (1)

README.Rmd

Lint, format, editor (1)

RStudio project

How this is detected·Detection ruleset v1 (2026-07-18)

Dependencies

Declared dependencies

21 external dependencies (excludes base and recommended)

Depends (1)

R >= 3.5.0

Imports (19)

clustercowplot data.table dplyr FactoMineR geometry ggplot2 gridExtra lubridate moments patchwork colorspace rgl Rfast rlang scales suncalc tidyr WaveletComp

LinkingTo (0)

none

Suggests (3)

knitr rmarkdown testthat

Enhances (0)

none

Dependency license breakdown →

Reverse dependencies

0direct

0indirect

Nothing depends on this yet.

Code & Tests

People & History

People (1)

Maintainer (1)

Calvin Beale

Author, Maintainer, Copyright holder

Authors (1)

Calvin Beale

Author, Maintainer, Copyright holder

Calvin Beale

Author, Maintainer, Copyright holder

Package Timeline

1 release. R releases are shown for context.

R
R 4.6.0 released · 2026-04-24
1.1.0Latest
2026-03-10 · current release
R
R 4.5.0 released · 2025-04-11

Package metadata

First published: 2026-01-26
Total releases: 1 / 1 yrs
License: GPL (>= 3) OSI
Minimum R: ≥ 3.5.0
Download size: 5.1 MB
Installed size: not tracked yet
With dependencies: not tracked yet

Report a problem with this page →