Beginning Tutorials

Welcome to the beginning tutorials section! On behalf of the team behind the biologging tools project, thanks for taking some time to get to know this package. We hope it is useful to you.

These practicals all assume that you have MATLAB, some basic experience working with it, and can execute provided code, making some user-specific changes along the way (e.g. to help MATLAB find a file you downloaded). We will provide you with quite a few lines. Additionally, be careful when copy-pasting special characters such as underscores and ‘quotes’. If you get an error, one thing to check is that you have just a single, simple underscore, and ‘straight quotes’, whether ‘single’ or “double” (rather than “smart quotes”).

Dominant stride, flap & fluke stroke frequency

In this vignette, you will learn how to estimate the dominant stride, flap or fluke stroke frequency using the dsf function, for a time interval focused on propulsion.

Complementary filter

In this vignette, you will learn what are and how to use complementary filters using comp_filt function, to separate intervals of movements into distinct frequency bands.

Depth checks and corrections

In this vignette you will learn how to check depth data and correct it using the functions fix_pressure and fix_offset_pressure. You will also learn how to remove off-animal tag data.

Vertical vs. forward speed

In this vignette you will learn to use deph_rate and ocdr to gain insight about how to estimate vertical and forward speed respectively.

Dead-Reckoned track

In this vignette you will learn how to estimate 3D dive or flight paths by updating the estimated position of the animal using estimates of its current speed and direction of travel using ptrack.

Remove high frequency noise

In this vignette you will learn how to identify and to remove high frequency noise due to tag vibration using a low pass-filter.

Find dives and summarize them

In this vignette you will learn how to use the function find_dives to gain insight about a depth profile, calculate the mean dive/flight duration and mean dive/flight depth/attitude.

Jerk: emphasize rapid changes in acceleration

In this vignette you will learn how to estimate jerk using njerk to identify prey capture attempts.

Convert .mat files into .nc files

In this vignette you will learn how to convert existing .mat file tag data matrices into NetDCF files sensor structures, so as to provide a standard sensor data archive and exchange format that is independent of tag type and software platform.

Working with sound

In this vignette you will learn how to unpack, post-process, and analyze audio data collected by microphones and hydrophones.