ORFID (version 1.0.3)

ant_efficiency: Detection efficiency for directional Oregon RFID antenna data

Description

Determines detection efficiency for each antenna in systems where multiple antennas are used along a linear migration route.

Usage

ant_efficiency(x, LOC_vec)

Value

Returns a tibble object.

Arguments

x

data frame generated using join_multireader_data.

LOC_vec

vector of antenna locations from first encountered to last encountered.

Author

Annika Putt <[e-mail]>

Details

ant_efficiency determines the detection efficiency of each antenna in a linear migration route. Direction is determined based on the order of locations from first encountered to last encountered, as specified in LOC_vec. Use site_summary to identify all locations present in the multi reader data, which must be included in LOC_vec.

Antenna efficiency is determined by identifying which tags were detected at antenna x and which tags were detected anywhere after/above antenna x. The efficiency of antenna x is then the number of shared tag detections divided by the total number of detections after x. Note that efficiency and shared detections cannot be determined for the final antenna as there are no subsequent detections. Reversing the order of LOC_vec can inform efficiency in systems with movement in multiple directions.

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 antenna efficiency for animals moving from downstream to upstream:
ant_efficiency(PIT_data, c("downstream_A1", "upstream_A1"))

# Determine antenna efficiency for animals moving from upstream to downstream:
ant_efficiency(PIT_data, c("upstream_A1", "downstream_A1"))