taxa (version 0.1.0)

pop: Pop taxa out

Description

Pop out taxa, that is, drop them

Usage

pop(.data, ...)

Arguments

.data

Input, object of class Hierarchy, or hierarchies

...

quoted rank names (e.g., family) via ranks(), taxon names (e.g., Poa annua) via nms(), or taxonomic IDs (e.g., 93036) via ids(). You can't pass in arbitrary strings or numbers.

Value

an object of the same class as passed in

Details

supports Hierarchy and hierarchies objects

See Also

See filtering-helpers, including for more explanation of how this function works.

Examples

# NOT RUN {
# With Hierarchy class object
ex_hierarchy1
## ranks
pop(ex_hierarchy1, ranks("family"))
ex_hierarchy1 %>% pop(ranks("family"))
ex_hierarchy1 %>% pop(ranks("family", "genus"))
## taxon names
ex_hierarchy1 %>% pop(nms("Poa"))
ex_hierarchy1 %>% pop(nms("Poaceae", "Poa"))
## taxon ids
ex_hierarchy1 %>% pop(ids(4479))
ex_hierarchy1 %>% pop(ids(4479, 4544))
## mixed: ids and names
ex_hierarchy1 %>% pop(ranks("family"), ids(4544))

# With hierarchies class object
# single taxonomic group
invisible(lapply(ex_hierarchies, print))
ex_hierarchies %>% pop(ranks("family")) %>% lapply(., print) %>% invisible
## more than one taxonomic group
invisible(lapply(ex_hierarchies, print))
ex_hierarchies %>% pop(ranks("family", "genus")) %>% lapply(., print) %>%
  invisible
# }

Run the code above in your browser using DataCamp Workspace