| ant_efficiency {ORFID} | R Documentation |
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)
Arguments
x |
data frame generated using |
LOC_vec |
vector of antenna locations from first encountered to last encountered. |
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.
Value
Returns a tibble object.
Author(s)
Annika Putt <annika@instream.net>
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"))