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.
In this package, we put together a pipeline for analyzing fish swimming kinematics based on points digitized from video and calculating key swimming parameters. The package assumes that you have already digitized a set of points along the fish body and are looking to estimate tail beat frequency or amplitude, body excursion, swimming wavelength or wave speed.
The toolbox is decscribed in detail in 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. https://doi.org/10.1016/bs.fp.2025.06.003 and in the vignette.
You can see examples of more complex processing pipelines in the other vignettes:
You can install using
install.packages("fishmechr")
or if you want the latest version
devtools::install_github("tytell/fishmechr")