iucn_summary: Get a summary from the IUCN Red List

Description

Get a summary from the IUCN Red List (http://www.iucnredlist.org/).

Usage

iucn_summary(sciname, silent = TRUE, parallel = FALSE,
  distr_detail = FALSE, ...)
iucn_summary_id(species_id, silent = TRUE, parallel = FALSE,
  distr_detail = FALSE, ...)
## S3 method for class 'iucn':
iucn_status(x, ...)

Arguments

sciname

character; Scientific name. Should be cleaned and in the format .

silent

logical; Make errors silent or not (when species not found).

parallel

logical; Search in parallel to speed up search. You have to register a parallel backend if TRUE. See e.g., doMC, doSNOW, etc.

distr_detail

logical; If TRUE, the geographic distribution is returned as a list of vectors corresponding to the different range types: native, introduced, etc.

...

Currently not used.

species_id

an IUCN ID

an iucn object as returned by iucn_summary.

Value

A list (for every species one entry) of lists with the following items:
statusRed List Category.
historyHistory of status, if available.
distrGeographic distribution, if available.
trendTrend of population size, if available.

Details

Beware: IUCN functions can give back incorrect data. This isn't our fault. We do our best to get you the correct data quickly, but sometimes IUCN gives back the wrong data, and sometimes Global Names gives back the wrong data. We will fix these as soon as possible. In the meantime, just make sure that the data you get back is correct.

Examples

Run this code

ia <- iucn_summary(c("Panthera uncia", "Lynx lynx"))
ia <- iucn_summary(c("Panthera uncia", "Lynx lynx", "aaa"))
# get summary from IUCN ID
ia <- iucn_summary_id(c(22732, 12519))
# extract status
iucn_status(ia)
# extract other available information
ia[['Lynx lynx']]$history
ia[['Panthera uncia']]$distr
ia[[2]]$trend
# get detailed distribution
iac <- iucn_summary("Ara chloropterus", distr_detail = TRUE)
iac[[1]]$distr