motus.org

matchTags

R Documentation

find which tags match registered tags

Description

A set of user tags is looked up in a set of motus-registered tags. The user tag set is divided into three subsets: tags with unique, multiple, or no matches in the motus set, respectively.

Usage

matchTags(u, m, id, bi, yr, bi.digits = 0, id.digits = 0)

Arguments

`u:`	user tags; a dplyr::tbl_df object, having at least the columns representing manufacturer tag ID, burst interval, and registration year
`m:`	motus tags; a dplyr::tbl_df object with one motus-registered tag per row. Typically, this will be the result of calling. `getProjectTags()`
`id:`	name of column in `u` representing the tags' manufacturer ID.
`bi:`	name of column in `u` representing burst interval, in seconds.
`yr:`	name of column in `u` representing tag registration year.
`bi.digits:`	number of digits after the decimal point to use in matching burst interval. Burst intervals are rounded to this number of digits before matching. Defaults to 0, meaning integer values are used.
`id.digits:`	number of digits after the decimal point to use in matching manufacturer tag ID. Tags might have been registered with digits after the decimal point to represent duplicate IDs distinguished by burst interval in the same year and project. IDs are rounded to this number of digits before matching. Defaults to 0, meaning integer values are used.

Value

a list with four items:

unique: the join of rows from u with their unique match in m, for those user tags with a unique match in the motus tag list
multi: the join of rows from u with each of their matchs in m, for those user tags having multiple matches in the motus tag list
collide: the join of rows from u with each of their matchs in m, for those motus tags having multiple matches in the user tag list; these are collisions in the user tag list.
none: the rows from u having no match in m