fishmechr: Computes Kinematic Parameters for Swimming
Processes tracked points on a fish's body and uses them to estimate standard kinematic parameters such as tail beat amplitude and frequency, body wavelength and wavespeed. As part of this, it also estimates the location of the center of mass and the principal swimming axis. The techniques are described in detail in the main vignette and are published in the book chapter Hawkins, O.H., Di Santo, V., Tytell, Eric.D., 2025. "Biomechanics and energetics of swimming", in: Higham, T.E., Lauder, G.V. (Eds.), Integrative Fish Biomechanics, Fish Physiology. Academic Press. <doi:10.1016/bs.fp.2025.06.003>.
| Version: | 1.0.3 |
| Depends: | R (≥ 4.4.0) |
| Imports: | assertthat, cli, dplyr, gsignal, pracma, rlang, tibble, tidyr, tidyselect |
| Suggests: | ggplot2, knitr, patchwork, rmarkdown, testthat (≥ 3.0.0) |
| Published: | 2026-03-29 |
| DOI: | 10.32614/CRAN.package.fishmechr (may not be active yet) |
| Author: | Eric Tytell  [aut,
cre, cph],
Olivia Hawkins
[ctb],
National Science Foundation [fnd] |
| Maintainer: | Eric Tytell <eric.tytell at tufts.edu> |
| BugReports: | https://github.com/tytell/fishmechr/issues |
| License: | CC BY 4.0 |
| URL: | https://tytell.github.io/fishmechr/, https://github.com/tytell/fishmechr |
| NeedsCompilation: | no |
| Materials: | README, NEWS |
| CRAN checks: | fishmechr results |
Documentation:
| Reference manual: | fishmechr.html , fishmechr.pdf |
| Vignettes: |
fishmechr (source, R code) prickleback_swimming (source, R code) process_sleap_data (source, R code) |
Downloads:
| Package source: | fishmechr_1.0.3.tar.gz |
| Windows binaries: | r-devel: not available, r-release: not available, r-oldrel: not available |
| macOS binaries: | r-release (arm64): not available, r-oldrel (arm64): not available, r-release (x86_64): not available, r-oldrel (x86_64): not available |
Linking:
Please use the canonical form https://CRAN.R-project.org/package=fishmechr to link to this page.