etn is an R package to access data from the European Tracking Network (ETN). With etn you can query metadata (animals, tags, deployments, receivers, projects) and data (acoustic detections, sensor data) from the ETN database and use these in your analyses. Data access requires user credentials and is subject to a data policy.
To get started, see:
- Configure credentials.
- Function reference: overview of all functions.
- Explore acoustic telemetry data.
Installation
You can install the development version of etn from GitHub with:
# install.packages("pak")
pak::pak("inbo/etn")Usage
Before you can access data from the European Tracking Network, you need to register for a MarinePass account at the Flanders Marine Institute (VLIZ). See authentication for instructions.
With etn you can query ETN (meta)data:
library(etn)
# Get animal metadata for a project
get_animals(animal_project_code = "2014_demer")
#> # A tibble: 16 × 66
#> animal_id animal_project_code tag_serial_number tag_type tag_subtype
#> <int> <chr> <chr> <chr> <chr>
#> 1 304 2014_demer 1187449 acoustic animal
#> 2 384 2014_demer 1157781 acoustic animal
#> 3 385 2014_demer 1157782 acoustic animal
#> 4 386 2014_demer 1157783 acoustic animal
#> 5 305 2014_demer 1187450 acoustic animal
#> 6 383 2014_demer 1157780 acoustic animal
#> 7 369 2014_demer 1171781 acoustic animal
#> 8 370 2014_demer 1171782 acoustic animal
#> 9 365 2014_demer 1171775 acoustic animal
#> 10 366 2014_demer 1171776 acoustic animal
#> 11 368 2014_demer 1171780 acoustic animal
#> 12 382 2014_demer 1157779 acoustic animal
#> 13 371 2014_demer 1171783 acoustic animal
#> 14 372 2014_demer 1171784 acoustic animal
#> 15 367 2014_demer 1171777 acoustic animal
#> 16 306 2014_demer 1187468 acoustic animal
#> # ℹ 61 more variables: acoustic_tag_id <chr>,
#> # acoustic_tag_id_alternative <chr>, scientific_name <chr>,
#> # common_name <chr>, aphia_id <int>, animal_label <chr>,
#> # animal_nickname <chr>, tagger <chr>, capture_date_time <dttm>,
#> # capture_location <chr>, capture_latitude <dbl>, capture_longitude <dbl>,
#> # capture_method <chr>, capture_depth <chr>,
#> # capture_temperature_change <chr>, release_date_time <dttm>, …
# Get acoustic detections for a tag and time period
get_acoustic_detections(
tag_serial_number = "1171781",
start_date = "2014-06-01",
end_date = "2014-06-15"
)
#> ℹ Preparing
#> ✔ Preparing : will fetch 323 detections [1.8s]
#>
#> ℹ Wrapping up
#> ✔ Wrapping up [129ms]
#>
#> # A tibble: 323 × 20
#> detection_id date_time tag_serial_number acoustic_tag_id
#> <int> <dttm> <chr> <chr>
#> 1 20584649 2014-06-11 21:37:55 1171781 A69-1601-26535
#> 2 20586150 2014-06-10 21:38:39 1171781 A69-1601-26535
#> 3 20586258 2014-06-12 22:10:13 1171781 A69-1601-26535
#> 4 20593508 2014-06-10 21:57:52 1171781 A69-1601-26535
#> 5 20594981 2014-06-11 00:04:02 1171781 A69-1601-26535
#> 6 20618890 2014-06-11 00:23:07 1171781 A69-1601-26535
#> 7 20623541 2014-06-04 21:43:22 1171781 A69-1601-26535
#> 8 20628279 2014-06-11 23:44:24 1171781 A69-1601-26535
#> 9 20633201 2014-06-14 22:04:51 1171781 A69-1601-26535
#> 10 20638052 2014-06-14 23:43:10 1171781 A69-1601-26535
#> # ℹ 313 more rows
#> # ℹ 16 more variables: animal_project_code <chr>, animal_id <int>,
#> # scientific_name <chr>, acoustic_project_code <chr>, receiver_id <chr>,
#> # station_name <chr>, deploy_latitude <dbl>, deploy_longitude <dbl>,
#> # sensor_value <dbl>, sensor_unit <chr>, sensor2_value <dbl>,
#> # sensor2_unit <chr>, signal_to_noise_ratio <int>, source_file <chr>,
#> # qc_flag <lgl>, deployment_id <int>Meta
- We welcome contributions including bug reports.
- License: MIT
- Get citation information for etn in R doing
citation("etn"). - Please note that this project is released with a Contributor Code of Conduct. By participating in this project you agree to abide by its terms.
