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 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>.
| Version: |
1.1.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: |
knitr, rmarkdown, testthat (≥ 3.0.0) |
| Published: |
2026-01-26 |
| DOI: |
10.32614/CRAN.package.FishDiveR (may not be active yet) |
| 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://github.com/calvinsbeale/FishDiveR |
| NeedsCompilation: |
no |
| Citation: |
FishDiveR citation info |
| Materials: |
README, NEWS |
| CRAN checks: |
FishDiveR results |
Documentation:
Downloads:
Linking:
Please use the canonical form
https://CRAN.R-project.org/package=FishDiveR
to link to this page.