subtaxa_apply
Apply function to subtaxa of each taxon
Apply a function to the subtaxa for each taxon. This is similar
to using subtaxa() with lapply() or sapply().
obj$subtaxa_apply(func, subset = NULL, recursive = TRUE, simplify = FALSE, include_input = FALSE, value = NULL, ...) subtaxa_apply(obj, func, subset = NULL, recursive = TRUE, simplify = FALSE, include_input = FALSE, value = NULL, ...)
Arguments
- obj
The
taxonomy()ortaxmap()object containing taxon information to be queried.- func
(
function) The function to apply.- subset
(
character)taxon_idsor indexes oftaxon_datafor which supertaxa will be returned. Default: All taxa inobjwill be used.- recursive
(
logicalornumeric) IfFALSE, only return the supertaxa one rank above the target taxa. IfTRUE, return all the supertaxa of every supertaxa, etc. Positive numbers indicate the number of recursions (i.e. number of ranks above the target taxon to return).1is equivalent toFALSE. Negative numbers are equivalent toTRUE.- simplify
(
logical) IfTRUE, then combine all the results into a single vector of unique values.- include_input
(
logical) IfTRUE, the input taxa are included in the output- value
What data to give to the function. Any result of
all_names(obj)can be used, but it usually only makes sense to use data that has an associated taxon id.- ...
Extra arguments are passed to the function.
Examples
# NOT RUN {
# Count number of subtaxa in each taxon
subtaxa_apply(ex_taxmap, length)
# }