The function takes complete capture histories downloaded from PTAGIS and extracts all the detection sites from them. It matches those sites with information from PTAGIS metadata, being sure to pull the metadata from the correct configuration file.
extractSites(
cth_file = NULL,
file_type = c("PTAGIS", "Biologic_csv", "raw"),
as_sf = F,
crs = 5070,
min_date = NULL,
max_date = NULL,
configuration = NULL
)
is the path to the complete tag history file
describes the source of the complete tag history file.
If PTAGIS
, then cth_file
should be a PTAGIS observation file downloaded as a csv from PTAGIS.
This must be the output from a Complete Tag History query (part of the Advanced Reporting).
This query should contain: Tag, Mark Species, Mark Rear Type, Event Type, Event Site Type,
Event Site Code, Event Date Time, Antenna, Antenna Group Configuration,
Event Release Site Code, and Event Release Date Time.
If Biologic_csv
, that implies the data was downloaded from Biologic software in a .csv format.
If raw
, that implies the data was downloaded directly from the reader, in either a .log or .xlsx format. In this case, the largest string containing alphabetic characters in the file name will be assigned as the site code.
Should the results be returned as an `sf` object (`TRUE`), or a tibble (`FALSE`, and the default)?
if `as_sf = TRUE`, what CRS should the resulting `sf` object be transformed to? Default is 5070.
character in the format `YYYYMMDD` that describes a minimum detection date. If supplied, sites with detections prior to this date will be excluded from the results.
character in the format `YYYYMMDD` that describes a maximum detection date. If supplied, sites with detections after this date will be excluded from the results.
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`.
a tibble
ptagis_file = system.file("extdata", "TUM_Chinook_2015.csv", package = "PITcleanr", mustWork = TRUE)
#> Error in system.file("extdata", "TUM_Chinook_2015.csv", package = "PITcleanr", mustWork = TRUE): no file found
ptagis_cth = readCTH(ptagis_file)
#> Error: object 'ptagis_file' not found
extractSites(ptagis_cth)
#> Error: object 'ptagis_cth' not found