Skip to contents

Add IUCN Red List conservation status

Source: R/add-iucn.R
add_iucn.Rd

Joins IUCN Red List conservation status to a taxify() result by looking up accepted_name. This is the source-named door for the IUCN Red List; for conservation status reconciled across sources, use add_trait() once more than one source is registered for it.

Usage

add_iucn(x, cols = NULL, verbose = TRUE)

Arguments

x

A data.frame returned by taxify().

cols

Which columns to attach: NULL (default) the curated set, "all" every column the source carries, or a character vector of names. See enrichment_cols.

verbose

Logical. Show download progress if enrichment data needs to be fetched. Default TRUE.

Value

The same data.frame with an additional column:

conservation_status

IUCN category: "LC" (Least Concern), "NT" (Near Threatened), "VU" (Vulnerable), "EN" (Endangered), "CR" (Critically Endangered), "EW" (Extinct in the Wild), "EX" (Extinct), or NA if not assessed.

Details

Conservation status values are compiled from publicly available sources including GBIF and the IUCN Red List API. Coverage is global across all taxonomic groups (~166k species).

Examples

# Runs offline against the bundled example database.
old <- options(taxify.data_dir = taxify_example_data())

taxify("Panthera tigris", backbone = "gbif") |>
  add_iucn()

options(old)