FishDiveR: Classify Aquatic Animal Behaviours from Vertical Movement Data
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 principles of combining CWT with k-means first developed by Sakamoto et al. (2009) <doi:10.1371/journal.pone.0005379> and redeveloped by Beale et al. (2026) <doi:10.1186/s40462-025-00622-w>.
| Version: | 1.3.0 |
| Depends: | R (≥ 3.5.0) |
| Imports: | cluster, cowplot, data.table, dplyr, FactoMineR, geometry, ggplot2, gridExtra, lubridate, moments, patchwork, colorspace, rgl, Rfast, rlang, scales, suncalc, tidyr, WaveletComp |
| Suggests: | bslib, DT, knitr, rmarkdown, rstudioapi, shiny (≥ 1.7.0), tcltk, testthat (≥ 3.0.0) |
| Published: | 2026-11-07 |
| DOI: | 10.32614/CRAN.package.FishDiveR |
| Author: | Calvin Beale 
[aut, cre, cph] |
| Maintainer: | Calvin Beale <calvin.beale.8 at gmail.com> |
| BugReports: | https://github.com/calvinsbeale/FishDiveR/issues |
| License: | GPL (≥ 3) |
| URL: | https://calvinsbeale.github.io/FishDiveR/, https://github.com/calvinsbeale/FishDiveR, https://calvinbeale.co.uk/fishdiver/ |
| NeedsCompilation: | no |
| Citation: | FishDiveR citation info |
| Materials: | README, NEWS |
| CRAN checks: | FishDiveR results |
Documentation:
| Reference manual: | FishDiveR.html , FishDiveR.pdf |
| Vignettes: |
Getting started with FishDiveR (source, R code) Using the FishDiveR app (source, R code) Large, high-frequency records (source, R code) |
Downloads:
| Package source: | FishDiveR_1.3.0.tar.gz |
| Windows binaries: | r-devel: FishDiveR_1.1.0.zip, r-release: FishDiveR_1.1.0.zip, r-oldrel: FishDiveR_1.1.0.zip |
| macOS binaries: | r-release (arm64): FishDiveR_1.1.0.tgz, r-oldrel (arm64): FishDiveR_1.1.0.tgz, r-release (x86_64): FishDiveR_1.1.0.tgz, r-oldrel (x86_64): FishDiveR_1.1.0.tgz |
| Old sources: | FishDiveR archive |
Linking:
Please use the canonical form https://CRAN.R-project.org/package=FishDiveR to link to this page.