first_last: Summarizes first and last detections on individual antennas

In InStreamFisheries/PITR: Functions to collate, manage and summarize PIT telemetry data

Description

Function summarizes the first and last detections and the difference in time (in minutes and days) between the first and last detections for each fish on each antenna over a user-defined period of time. Data can be summarized by year, month, week, day or hour.

Usage

first_last(data, resolution = NULL, start_date = NULL,
  end_date = NULL)

Arguments

data	telemetry dataset created using old_pit, new_pit or array_config
resolution	summarize data by year, month, week, day or hour (optional)
start_date	start date of period of interest, default is first date in dataset
end_date	end date of period of interest, default is last date in dataset

Details

first_last summarizes first and last detections for each tag on each antenna. In the data output, antennas are organized into arrays. If no array name has been specified first_last defaults the reader name to the array name and summarizes by reader/array. Users can apply the first_last function to the original dataset created by the old_pit or new_pit function, or use an updated dataset created by the array_config function. Arguments start_date and end_date, if specified, must be entered as yyyy-mm-dd hh:mm:ss. Default for the resolution argument will summarize the first and last detections on antennas over the entire time period present in the dataset.

Value

Data frame summarizing the first and last detections on individual antennas.

Examples

# Load test dataset containing detections from a multi reader with two antennas
oregon_rfid <- new_pit(data = "oregon_rfid", test_tags = NULL, print_to_file = FALSE, time_zone = "America/Vancouver")

# Summarize first and last detections by day with a start date of 2015-10-15 08:00:00
first_last(data = oregon_rfid, resolution = "day", start_date = "2015-10-15 08:00:00")

# Summarize first and last detections by month
first_last(data = oregon_rfid, resolution = "month")

InStreamFisheries/PITR documentation built on Jan. 7, 2021, 1:02 p.m.