actel: actel: Acoustic Telemetry Data Analysis

actelR Documentation

actel: Acoustic Telemetry Data Analysis


actel is designed for studies where animals tagged with acoustic tags are expected to move through receiver arrays. actel combines the advantages of automatic sorting and checking of animal movements with the possibility for user intervention on tags that deviate from expected behaviour. The three analysis functions: explore, migration and residency, allow the users to analyse their data in a systematic way, making it easy to compare results from different studies.

Input structure

To be able to work with actel, you must prepare your data in a specific format. To learn more about this, you need to have a look at the package vignettes, which can be found by running browseVignettes('actel'). If this function returns "No vignettes found", you can alternatively find the vignettes online:

Example dataset

If this is the first time you are using actel, you can try running it on an example dataset using the exampleWorkspace function. This function deploys a set of example files following the structure described in the package vignettes. Namely:

  • biometrics.csv

  • deployments.csv

  • spatial.csv

  • detections/ (a folder with .csv files)

Once the example dataset is created, exampleWorkspace also provides you with example code to run an explore analysis.

Note that you can also run the migration and residency analyses on the example dataset, e.g.:

results <- migration(tz = 'Europe/Copenhagen', report = TRUE)


results <- residency(tz = 'Europe/Copenhagen', report = TRUE)

Note: Running these lines with report = TRUE will open an analysis report on your web browser.

Main functions

The actel package provides three main analyses: explore, migration and residency


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.


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 animals/tags has been acting odd. Multiple options allow you to tweak the analysis to fit your study perfectly.


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!


Maintainer: Hugo Flávio (ORCID)

See Also

explore, migration, residency, exampleWorkspace, blankWorkspace

actel documentation built on Oct. 19, 2023, 9:08 a.m.