tag_direction: Movement direction for Oregon RFID antenna data

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

Movement direction for Oregon RFID antenna data

Description

Determines direction of tag movement in systems where multiple antennas are used along a linear migration route.

Usage

tag_direction(x, LOC_vec)

Arguments

x	data frame generated using join_multireader_data.
LOC_vec	vector of antenna locations from first encountered to last encountered.

Details

tag_direction determines the direction of movement for individual detection events in x. Direction is determined based on the order of locations from first encountered to last encountered, as specified in LOC_vec. Note that direction cannot be determined until the tag has been detected at multiple locations. Use site_summary to identify all locations present in the multi-reader data, which must be included in LOC_vec.

Value

Returns a tibble object. The column DIR displays direction, where U is upstream movement, D is downstream movement, and S is no movement, or a consecutive detection at the previous location.

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.

site_summary for identifying all locations present in a multi reader array

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:
tag_direction(PIT_data, c("downstream_A1", "upstream_A1"))

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