direction_summary: Summary of movement direction for Oregon RFID antenna data

In hugo-marques/ORFID: Manage and Summarize Data from Oregon RFID ORMR and ORSR Antenna Readers

Summary of movement direction for Oregon RFID antenna data

Description

Summarizes the time difference between the first and last movement directions for each unique tag ID. Input data are created by tag_direction, which determines the direction of movement for each detection event in join_multireader_data.

Usage

direction_summary(dir_df, include_stationary = FALSE)

Arguments

dir_df	output from tag_direction.
include_stationary	if TRUE, all detections are summarized. If FALSE, only detections with a known movement direction (up or down) are included in the summary.

Details

direction_summary isolates the first and last direction of movement from tag_direction and determines the time difference in seconds and days. Directions are U for upstream movement, D for downstream movement, and S for no movement, or consecutive detection at the same location.

It is common for a tag to be detected multiple times at the same antenna, which will result in a movement direction of S, or stationary. The user is encouraged to examine direction summaries for include_stationary = TRUE and include_stationary = FALSE to become familiar with their data. When include_stationary = FALSE, there may be fewer tag ids in the direction summary than in the full data set.

Value

Returns a tibble object.

Author(s)

Annika Putt <[e-mail]>

See Also

import_ORFID for importing data files from Oregon RFID ORMR and ORSR antenna readers.

join_multireader_data for combining data from Oregon RFID ORMR and ORSR antenna readers into a multi-reader array.

tag_direction for determining movement direction of detections in systems with a linear migration route.

Examples

# Create a list containing compiled reader data:
readers <- list(reader_us, reader_ds)

# Join data into a multi-reader array:
PIT_data <- join_multireader_data(readers)

# List readers:
unique(PIT_data$LOC)

# Determine tag direction for animals moving from downstream to upstream:
dir <- tag_direction(PIT_data, c("downstream_A1", "upstream_A1"))
 
# Determine the time difference between first and last detections:
dir_summary <- direction_summary(dir)

hugo-marques/ORFID documentation built on Jan. 10, 2023, 6:26 a.m.