readCTH: Read In Complete Tag History

View source: R/readCTH.R

readCTHR Documentation

Read In Complete Tag History

Description

The function reads in complete tag histories from either PTAGIS or Biologic that have been downloaded and coverts the date time values from character vectors into date-time vectors

Usage

readCTH(
  cth_file = NULL,
  file_type = c("PTAGIS", "Biologic_csv", "raw"),
  test_tag_prefix = NULL
)

Arguments

cth_file

is the path to the complete tag history file

file_type

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.

test_tag_prefix

The prefix that designates a tag code as a test tag. These detections are filtered out of the returned tibble

Value

a tibble containing the data downloaded from PTAGIS through a complete capture history query.

Author(s)

Kevin See

Examples

ptagis_file = system.file("extdata", "TUM_Chinook_2015.csv", package = "PITcleanr")
readCTH(ptagis_file)

KevinSee/PITcleanr documentation built on Feb. 27, 2024, 11:03 p.m.