taxa (version 0.1.0)

map_data: Create a mapping between two variables

Description

Creates a named vector that maps the values of two variables associated with taxa in a taxonomy() or taxmap() object. Both values must be named by taxon ids.

obj$map_data(from, to, warn = TRUE)
map_data(obj, from, to, warn = TRUE)

Arguments

obj

The taxonomy() or taxmap() object.

from

The value used to name the output. There will be one output value for each value in from. Any variable that appears in all_names() can be used as if it was a variable on its own.

to

The value returned in the output. Any variable that appears in all_names() can be used as if it was a variable on its own.

warn

If TRUE, issue a warning if there are multiple unique values of to for each value of from.

Value

A vector of to values named by values in from.

See Also

Other taxonomy data functions: id_classifications, is_branch, is_leaf, is_root, is_stem, n_subtaxa_1, n_subtaxa, n_supertaxa, name_classifications, taxon_ids, taxon_indexes, taxon_names, taxon_ranks

Examples

# NOT RUN {
# Mapping between two variables in `all_names(ex_taxmap)`
map_data(ex_taxmap, from = taxon_names, to = n_legs > 0)

# Mapping with external variables
x = c("d" = "looks like a cat", "h" = "big scary cats",
      "i" = "smaller cats", "m" = "might eat you", "n" = "Meow! (Feed me!)")
map_data(ex_taxmap, from = taxon_names, to = x)
# }

Run the code above in your browser using DataCamp Workspace