get_ids {taxalight}

Return the accepted taxonomic identifier, acceptedNameUsageID given a scientific name

Description

Return the accepted taxonomic identifier, acceptedNameUsageID given a scientific name

Usage

get_ids(
  name,
  provider = getOption("tl_default_provider", "itis"),
  version = tl_latest_version(),
  dir = tl_dir()
)

Arguments

name

character vector of scientific names

provider

Abbreviation for a known naming provider. Provider data should first be imported with ⁠[tl_create]⁠. Note: setting provider to "itis_test" is for testing purposes only, use "itis" for the full ITIS data. See details

version

version of the authority to use (e.g. four-digit year)

dir

storage location for the LMDB databases

Value

a vector of matching accepted identifiers. Note that if the name provided is considered to be a synonym by the provider, then the ID corresponds to the accepted name and not the synonym. (i.e. get_names(get_ids(synonym))) will return the accepted name and not the synonym name.

Examples

 # slow initial import
sp <- c("Dendrocygna autumnalis", "Dendrocygna bicolor")
get_ids(sp, "itis_test") # use "itis_test" test data for example only