fws_taxonomy: Retrieve raw USFWS taxonomic information matching scientific...

In adamdsmith/fwspp: Querying Biodiversity Databases on USFWS Properties

Retrieve raw USFWS taxonomic information matching scientific name query

Description

Queries U.S. Fish & Wildlife Service taxonomy records by scientific name, returning all records that match the input sci_name parameter (including partial matches; see Details). Returns basic taxonomic information, if available, including ITIS Taxonomic Serial Number (tsn), the taxon_code assigned by the US Fish & Wildlife Service), common_name(s), a generic taxon group, whether the taxon is valid according to ITIS and, if not, the accepted taxon_code if a match is found.

Usage

fws_taxonomy(sci_name)

Arguments

sci_name

scientific name character scalar (case-insensitive) for which to retrieve basic taxonomic information. Unlike retrieve_taxonomy, matches are not restricted to the species level; that is, subspecies may be returned.

Details

It is somewhat unclear how the USFWS records are filtered. The best guess is that it parses the unique words in the query string (sci_name) and returns all records that match that set of unique words. The order of query words is not strictly enforced. See examples.

Value

a data.frame of basic taxonomic information or NULL if there are no matching records

Examples

## Not run: 
fws_taxonomy("GULo gulo")
fws_taxonomy("Lampropeltis holbrooki")
fws_taxonomy("holBRooki lampropeltis")

## End(Not run)

adamdsmith/fwspp documentation built on Oct. 16, 2023, 3:43 a.m.