binomen (version 0.1.2)

span: Parse taxon or taxondf objects by a range of names

Description

Parse taxon or taxondf objects by a range of names

Usage

span(.data, ...)

Arguments

.data

Input, object of class taxon

...

Pass in two unquoted taxonomic rank names, and only two. May make this more flexible in the future.

Value

A single or list of taxon class objects

Examples

# operating on `taxon` objects
out <- make_taxon(genus="Poa", epithet="annua", authority="L.",
   family='Poaceae', clazz='Poales', kingdom='Plantae', variety='annua')
out %>% span(kingdom, genus)

# operating on taxonomic data.frames
df <- data.frame(class=c('Magnoliopsida','Magnoliopsida','Magnoliopsida',
                         'Magnoliopsida','Magnoliopsida','Magnoliopsida'),
         order=c('Asterales','Asterales','Fagales','Poales','Poales','Poales'),
         family=c('Asteraceae','Asteraceae','Fagaceae','Poaceae','Poaceae','Poaceae'),
         genus=c('Helianthus','Helianthus','Quercus','Poa','Festuca','Holodiscus'),
         stringsAsFactors = FALSE)
(df2 <- taxon_df(df))

## filter to get a range of classes
df2 %>% span(order, genus)
df2 %>% span(family, genus)

## from taxa object
df2 %>% scatter %>% span(family, species)