Skip to contents

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:

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.