Get plant taxonomical and distribution data

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

1
2
3
4
5
get.taxa(taxa, replace.synonyms = TRUE, suggest.names = TRUE,
  life.form = FALSE, habitat = FALSE, vernacular = FALSE,
  states = FALSE, establishment = 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?

vernacular

include vernacular names and localities?

states

include occurrence data?

establishment

include the establishment type (native, cultivated or naturalized)?

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

1
2
3
4
5
6
## Not run: 
data(plants)
get.taxa(plants)
get.taxa(plants, life.form = TRUE, establishment = TRUE)

## End(Not run)