README.md

In Nature40/tRackIT: Process data recorded with automatic radio-tracking stations

The tRackIT R-package

The tRackIT R-Package provides functionalities for the processing of data recorded in local automatic radio-tracking studies. It is specifically tailored to data recorded with one of the sensors from the tRackIT ecosystem (tRackIT-Stations, BatRack), but can also be used for other systems. The functionalities provided in the package cover project and individual management, raw signal data processing and the generation of high-level information such as the calculation of locations and the classification of behavioral states based on pattern in the recorded vhf-signals. It provides a default data structure to guarantee easy exchangeability of data and analysis scripts between scientists. For a detailed guide please go to the package github-page. The latest release can be found here .

Getting startet

The package uses functionalities from the telemetr R-Package developed by Barry Rowlingson. It provides all methods for the localization of a transmitter described in this article using fortran in the background. To make use of the dependencies however, some adjustments to the package had to be conducted, which is why the version used in the tRackIT R-package is hostet under the Nature40 github account. Before the tRackIT package can be installed, please install the telemtr package as follows:

library(remotes)

Sys.setenv("R_REMOTES_NO_ERRORS_FROM_WARNINGS" = "true")

remotes::install_github("Nature40/telemetr")

We also make use of very fast c++ based rolling windows which are not hostet on cran, yet. Please install the package as follows:

devtools::install_github("andrewuhl/RollingWindow")

Now you can install the tRackIT R-package

devtools::install_github("Nature40/tRackIT")

Test data, models and tutorials

To check out the functionalities of the package using the package vignette, we recommend to download the test data and trained models for activity classification. Models need to be unzipped and stored in the extdata folder of the installed tRackIT-package. We also we provide the following tutorials describing the workflow for model tuning and evaluation for activity classification. You can also check the reproducible script for the case study analysis shown in the paper.

Nature40/tRackIT documentation built on Nov. 21, 2023, 3:43 a.m.