pick: Pick names

In ropensci/binomen: 'Taxonomic' Specification and Parsing Methods

Pick names

Description

Pick names

Usage

pick(.data, ...)

Arguments

.data	Input, object of class taxon
...	Further unnamed args, see examples

Value

For taxon inputs, gives back a taxonref object. For taxondf inputs, gives back taxondf.

Examples

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

# 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))

## select single or many taxonomic classes
df2 %>% pick(order)
df2 %>% pick(family, genus)

# From taxa object
df2 %>% scatter %>% pick(family)
df2 %>% scatter %>% pick(family, species)
df2 %>% scatter %>% pick(family, species, genus)

ropensci/binomen documentation built on May 18, 2022, 9:47 a.m.