taxize (version 0.7.9)

tp_search: Search Tropicos by scientific name, common name, or Tropicos ID.

Description

Search Tropicos by scientific name, common name, or Tropicos ID.

Usage

tp_search(name = NULL, commonname = NULL, nameid = NULL, orderby = NULL, sortorder = NULL, pagesize = NULL, startrow = NULL, type = NULL, key = NULL, ...)

Arguments

name

Your search string. For instance "poa annua". See Details.

commonname

Your search string. For instance "annual blue grass"

nameid

Your search string. For instance "25509881"

orderby

Your search string. For instance "1"

sortorder

Your search string. For instance "ascending"

pagesize

Your search string. For instance "100"

startrow

Your search string. For instance "1"

type

Type of search, "wildcard" (default) will add a wildcard to the end of your search string. "exact" will use your search string exactly.

key

Your Tropicos API key; loads from .Rprofile.

...

Further args passed on to GET

Value

List or dataframe.

Details

More details on the name parameter: Tropicos will fail if you include a period (.) in your name string, e.g., var., so we replace periods before the request is made to the Tropicos web service. In addition, Tropicos for some reason doesn't want to see sub-specific rank names like var/subsp, so remove those from your query.

References

http://services.tropicos.org/help?method=SearchNameXml

Examples

## Not run: 
# tp_search(name = 'Poa annua')
# tp_search(name = 'Poa annua subsp. annua')
# tp_search(name = 'Poa annua var. annua')
# tp_search(name = 'Poa annua var annua')
# tp_search(name = 'Poa annua annua')
# ## End(Not run)