logo img

Simplifying acoustic telemetry data analysis

Designed for studies where animals tagged with acoustic tags are expected to move through receiver arrays. Combines the advantages of automatic sorting and checking of animal movements with the possibility for user intervention on tags that deviate from expected behaviour.

[package version] [cranlogs is down] [cranlogs is down] [code coverage]

USER GUIDE

What is the R package actel?

If you are using acoustic telemetry to track animals as they move inside a study area or as they migrate somewhere, actel is the R package for you. By bringing together the study area configuration and the recorded detections, actel provides a systematic way of analysing animal migration and residency data.

drawing

Choose the analysis that fits your study

logo img

Explore

explore() allows you to quickly get a summary of your data. You can use explore() to get a general feel for the study results, and check if the input files are behaving as expected. It is also a good candidate if you just want to validate your detections for later use in other analyses.

logo img

Migration

The migration() analysis runs the same initial checks as explore(), but on top of it, it analyses the animal behaviour. By selecting the arrays that lead to success, you can define whether or not your animals survived the migration. Additional plots help you find out if some animal/tag has been acting odd. Multiple options allow you to tweak the analysis to fit your study perfectly.

logo img

Residency

The residency() analysis runs the same initial checks as explore(), but, similarly to migration, explores particular points of the animal behaviour. If you want to know where your animals were in each day of the study, how many animals were in each section each day, and other residency-focused variables, this is the analysis you are looking for!

A variety of outputs

To truly learn how to operate actel, you must read the manual carefully. The manual has been arranged so that you can prepare your analysis as you learn; quite soon you will get your first results! Here are some examples:

Movement tables:

ArrayDetectionsFirst stationLast stationFirst timeLast timeTime travellingTime on array
River114St.1St.22019-05-15 10:30:002019-05-15 13:00:0025:20:142:30:00
River23St.4St.42019-05-15 13:50:002019-05-15 14:40:000:50:000:50:00
River38St.5St.62019-05-15 16:00:002019-05-15 16:20:001:20:000:20:00
Fjord221St.10St.112019-05-16 15:10:002019-05-16 18:00:0022:50:002:50:00
Sea11St.18St.182019-05-18 09:45:002019-05-18 09:45:0015:45:000:00:00

Detection graphics

drawing drawing

Times of arrival and summary information

drawing drawing

Array efficiency and tag progression

drawing

Individual residency

drawing

Global residency

drawing