FishDiveR

1.1.0

Classify Aquatic Animal Behaviours from Vertical Movement Data

0packages depend

1.3Kdownloads / year

–test coverage

13/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

13OK

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

Code health

Yes

Tests · ratio 0.12

not tracked

Coverage

100%

Documentation · exports

None

Vignettes

Yes

README

Dependencies · direct

Check history

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
ERROR2026-04-09
10 OK · 3 NOTE · 0 WARNING · 1 ERROR · 0 FAILURE

Show 1 earlier snapshots

NOTE2026-03-10
11 OK · 3 NOTE · 0 WARNING · 0 ERROR · 0 FAILURE

Downloads

1.3K

CRAN downloads in the past year

Rank #20,457 · ~4/day · ~111/mo

Releases R versions

Daily download trend is not available in this view yet.

26730 days

58790 days

1.3K1 year

Compare downloads with other packages →

Also on78 r2u

Repository

GitHub ↗ calvinsbeale/fishdiver

3Stars

1Forks

1Open issues

0Open PRs

0Releases

89Commits

License GPL-3.0 · 89 commits · 0% stars, 30d

Stars over time

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

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

Code Composition

R 5,175 (82%)Rd 1,130 (18%)

Code characteristics

Cyclomatic complexity: 36.0 median / 79 max
Test cases: 10 / 0.12 per code line
Documented parameters: 100%

Test coverage

Line coverage

–

Expression

–

Tests / Examples

–

Functions

15 13 exported

Complexity

35.1 avg / 79 max

Call network

15 nodes / 0 edges

Test coverage has not been measured for this package yet; nodes fall back to a neutral fill.

Call graph

Open call graph →

Loading call graph…

Lowest coverage

Per-function coverage is not measured for this package yet.

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

Release 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