Query and download complete capture history for one tag from PTAGIS (through DART). Due to PTAGIS no longer offering queries for the mark event information for a given tag code, only observations after the mark event are returned.

queryCapHist(
  ptagis_tag_code = NULL,
  configuration = NULL,
  include_mark = FALSE,
  api_key = NULL
)

Arguments

ptagis_tag_code

PTAGIS tag code

configuration

is a data frame which assigns node names to unique site, antenna, and site configuration ID combinations. One example can be built with the function `buildConfig`. If no configuration file is provided, nodes are considered site codes by default. If nodes are assigned, the column name should be `node`.

include_mark

should the mark event information be queried from PTAGIS and added to other detections? If `TRUE`, `api_key` must be supplied for this PTAGIS query.

api_key

PTAGIS API key, given to individual users

Author

Kevin See

Examples

queryCapHist(ptagis_tag_code = '384.3B23A0A6EE')
#> No configuration file supplied; querying PTAGIS
#> # A tibble: 158 × 8
#>    tag_code       event_site_code_value event_date_time_value antenna_id
#>    <chr>          <chr>                 <dttm>                <chr>     
#>  1 384.3B23A0A6EE BO1                   2017-05-21 14:21:04   23        
#>  2 384.3B23A0A6EE BO1                   2017-05-21 14:21:49   21        
#>  3 384.3B23A0A6EE BO1                   2017-05-21 14:21:50   21        
#>  4 384.3B23A0A6EE BO1                   2017-05-21 14:22:08   1F        
#>  5 384.3B23A0A6EE BO1                   2017-05-21 14:25:11   1D        
#>  6 384.3B23A0A6EE BO1                   2017-05-21 14:25:12   1D        
#>  7 384.3B23A0A6EE BO1                   2017-05-21 14:26:09   1B        
#>  8 384.3B23A0A6EE BO1                   2017-05-21 14:27:37   19        
#>  9 384.3B23A0A6EE BO1                   2017-05-21 14:27:38   19        
#> 10 384.3B23A0A6EE BO1                   2017-05-21 14:27:54   17        
#> # ℹ 148 more rows
#> # ℹ 4 more variables: antenna_group_configuration_value <dbl>,
#> #   antenna_group <chr>, site_type <chr>, event_type_name <chr>