get.taxa: Get plant taxonomical and distribution data

In flora: Tools for Interacting with the Brazilian Flora 2020

Description

This function collects taxonomic information and distribution from the Brazilian Flora Checklist. Synonyms and misspelled names are resolved automatically. Results can be combined with life form, habitat, vernacular name, and occurrence data.

Usage

get.taxa(taxa, replace.synonyms = TRUE, suggest.names = TRUE,
  life.form = FALSE, habitat = FALSE, vegetation.type = FALSE,
  vernacular = FALSE, states = FALSE, establishment = FALSE,
  domain = FALSE, endemism = FALSE, drop = c("authorship", "genus",
  "specific.epiteth", "infra.epiteth", "name.status"),
  suggestion.distance = 0.9, parse = FALSE)

Arguments

taxa	a character vector containing one or more taxa, without authors see remove.authors if you have a list with authorities
replace.synonyms	should the function automatically replace synonyms?
suggest.names	should the function try to correct misspelled names?
life.form	include the life form of the taxon?
habitat	include the habitat of the taxon?
vegetation.type	include the listed vegetation types?
vernacular	include vernacular names and localities?
states	include occurrence data?
establishment	include the establishment type (native, cultivated or naturalized)?
domain	return phytogeographyc domains?
endemism	is the taxon endemic to Brazil?
drop	NULL or character vector with names of columns with taxonomic information to be removed from the returned data frame. Available names: "id", "scientific.name", "accepted.name", "family", "genus", "specific.epiteth", "infra.epiteth", "taxon.rank", "authorship", "taxon.status", "name.status", "threat.status", and "search.str".
suggestion.distance	a value between 0 and 1 indicanting how conservative the name suggestion algorithm should be. Values closer to 1 are very conservative. Be very careful, lower values can give wrong suggestions.
parse	Parse names through the GBIF parser to remove authors?

Details

The returned data frame will contain a variable number of rows and columns depending on how the function was called. For instance, since there might be more than one vernacular name for each taxon, some rows will be duplicated if vernacular is set to TRUE. All misspelled taxa are automatically corrected if the function can come up with a reasonable guess for the name. Conservation status follows the IUCN nomenclature.

Value

a data frame

Examples

## Not run: 
data(plants)
get.taxa(plants)
get.taxa(plants, life.form = TRUE, establishment = TRUE)

## End(Not run)

flora documentation built on April 28, 2020, 9:05 a.m.