| Title: | Data from the 'IUCN' Red List of Threatened Species |
|---|---|
| Description: | Provides local access to global species conservation status, taxonomy, and vernacular names from the International Union for Conservation of Nature ('IUCN') Red List of Threatened Species. Integrates open data from the Global Biodiversity Information Facility ('GBIF') Darwin Core Archive into standardized 'R' data structures. Designed as an offline dataset provider for the 'iucnr' package and general biodiversity research. |
| Authors: | Paul Efren Santos Andrade [aut, cre, cph] (ORCID: <https://orcid.org/0000-0002-6635-0375>) |
| Maintainer: | Paul Efren Santos Andrade <[email protected]> |
| License: | MIT + file LICENSE |
| Version: | 0.1.0 |
| Built: | 2026-10-01 12:35:27 UTC |
| Source: | https://github.com/PaulESantos/iucnrdata |
Downloads the latest IUCN Red List dataset hosted on GBIF as a Darwin Core Archive (DwC-A) ZIP file.
download_iucn_gbif( dest_dir = tempdir(), overwrite = FALSE, url = "https://hosted-datasets.gbif.org/datasets/iucn/iucn-latest.zip" )download_iucn_gbif( dest_dir = tempdir(), overwrite = FALSE, url = "https://hosted-datasets.gbif.org/datasets/iucn/iucn-latest.zip" )
dest_dir |
Character. Directory where the ZIP file and extracted contents will be saved. Defaults to a temporary directory |
overwrite |
Logical. Whether to overwrite existing downloaded zip files. Default is |
url |
Character. The download URL for the GBIF IUCN dataset ZIP. Defaults to |
Dataset Citation: IUCN (2026). The IUCN Red List of Threatened Species. Version 2026-1. Hosted by GBIF Secretariat. DOI: 10.15468/0qnb58. URL: https://www.gbif.org/dataset/19491596-35ae-4a91-9a98-85cf505f1bd3
A character string representing the file path of the directory containing the unzipped Darwin Core files.
## Not run: dwc_path <- download_iucn_gbif() datasets <- process_iucn_gbif(dwc_path) head(datasets$iucn_taxon) ## End(Not run)## Not run: dwc_path <- download_iucn_gbif() datasets <- process_iucn_gbif(dwc_path) head(datasets$iucn_taxon) ## End(Not run)
Retrieves the current version of the IUCN Red List from its official citation information webpage.
get_iucn_version()get_iucn_version()
A character string representing the current online version of the IUCN Red List (e.g. "Version 2026-1"),
or "Version not found" if the version cannot be located on the webpage.
## Not run: version <- get_iucn_version() print(version) ## End(Not run)## Not run: version <- get_iucn_version() print(version) ## End(Not run)
Compares the packaged dataset version string against the latest published version on the official IUCN website.
iucn_check_version(silent = FALSE)iucn_check_version(silent = FALSE)
silent |
Logical. If |
Logical TRUE invisibly if up to date, FALSE if out of date.
## Not run: iucn_check_version() ## End(Not run)## Not run: iucn_check_version() ## End(Not run)
Complete taxonomic classification, authorship, rank, taxonomic status
(accepted or synonym), and bibliographic citation for taxa in the IUCN
Red List of Threatened Species, derived from the GBIF Darwin Core Archive
core file (taxon.txt). Column names preserve the Darwin Core terms defined
in meta.xml.
data(iucn_taxon)data(iucn_taxon)
A tibble with 310,544 rows and 16 columns:
Character. Unique taxon identifier.
Character. Full scientific name of the taxon with authorship.
Character. Kingdom classification.
Character. Phylum classification.
Character. Class classification.
Character. Order classification.
Character. Family classification.
Character. Genus name.
Character. Specific epithet of the species.
Character. Taxonomic authority who described the taxon.
Character. Rank of the taxon (e.g., "species", "subspecies").
Character. Infraspecific epithet if applicable.
Character. Status of the taxon name ("accepted" or "synonym").
Character. ID of the accepted name if the row represents a synonym.
Character. Complete bibliographic citation for the individual species assessment.
Character. URL link to the official IUCN Red List species page.
International Union for Conservation of Nature (IUCN) hosted on GBIF.
Dataset Information:
Title: The IUCN Red List of Threatened Species (Taxon Core)
Publisher: International Union for Conservation of Nature (IUCN)
License: Creative Commons Attribution 4.0 International (https://creativecommons.org/licenses/by/4.0/legalcode)
GBIF Dataset URL: https://www.gbif.org/dataset/19491596-35ae-4a91-9a98-85cf505f1bd3
International Union for Conservation of Nature (2026). The IUCN Red List of Threatened Species. Version 2026-1. Hosted by GBIF Secretariat. https://doi.org/10.15468/0qnb58 accessed via GBIF.org.
data(iucn_taxon) head(iucn_taxon)data(iucn_taxon) head(iucn_taxon)
IUCN Red List conservation category (threatStatus), assessment locality
scope, occurrence status, and citation metadata for taxa in the IUCN Red
List of Threatened Species, derived from the GBIF Darwin Core Archive
distribution extension (distribution.txt). Note that specific country-level
spatial distribution data is not present in this GBIF release.
data(iucn_threatstatus)data(iucn_threatstatus)
A tibble with 178,011 rows and 5 columns:
Character. Foreign key linking the assessment record to iucn_taxon$taxonID.
Character. Geographic scope of the assessment (e.g., "Global").
Character. Citation or source reference for the IUCN Red List assessment.
Character. IUCN Red List conservation category (e.g., "Critically Endangered", "Endangered", "Vulnerable", "Near Threatened", "Least Concern", "Data Deficient", "Extinct").
Character. Status of occurrence (e.g., "Present", "Absent").
International Union for Conservation of Nature (IUCN) hosted on GBIF.
Dataset Information:
Title: The IUCN Red List of Threatened Species (Distribution Extension)
Publisher: International Union for Conservation of Nature (IUCN)
License: Creative Commons Attribution 4.0 International (https://creativecommons.org/licenses/by/4.0/legalcode)
GBIF Dataset URL: https://www.gbif.org/dataset/19491596-35ae-4a91-9a98-85cf505f1bd3
International Union for Conservation of Nature (2026). The IUCN Red List of Threatened Species. Version 2026-1. Hosted by GBIF Secretariat. https://doi.org/10.15468/0qnb58 accessed via GBIF.org.
data(iucn_threatstatus) head(iucn_threatstatus)data(iucn_threatstatus) head(iucn_threatstatus)
Vernacular (common) names for taxa in the IUCN Red List of Threatened
Species, derived from the GBIF Darwin Core Archive vernacular names
extension (vernacularname.txt). Column names preserve the Darwin Core and
GBIF terms defined in meta.xml.
data(iucn_vernacularname)data(iucn_vernacularname)
A tibble with 182,200 rows and 4 variables:
character. Foreign key linking the vernacular name to iucn_taxon$taxonID.
character. Language code of the common name (e.g., "eng", "fra", "spa").
character. Vernacular or common name of the taxon.
logical. TRUE if the name is designated as the preferred vernacular name, FALSE otherwise.
International Union for Conservation of Nature (IUCN) hosted on GBIF.
Dataset Information:
Title: The IUCN Red List of Threatened Species (Vernacular Names Extension)
Publisher: International Union for Conservation of Nature (IUCN)
License: Creative Commons Attribution 4.0 International (https://creativecommons.org/licenses/by/4.0/legalcode)
GBIF Dataset URL: https://www.gbif.org/dataset/19491596-35ae-4a91-9a98-85cf505f1bd3
International Union for Conservation of Nature (2026). The IUCN Red List of Threatened Species. Version 2026-1. Hosted by GBIF Secretariat. https://doi.org/10.15468/0qnb58 accessed via GBIF.org.
data(iucn_vernacularname) head(iucn_vernacularname)data(iucn_vernacularname) head(iucn_vernacularname)
Retrieves the package version and publication date for iucnrdata.
iucnrdata_version(long = TRUE)iucnrdata_version(long = TRUE)
long |
Logical. Whether to return the version date alongside the version number. Default is |
A character string representing the package version (e.g. "0.1.0" or "Version 0.1.0 (2026-08-01)").
iucnrdata_version() iucnrdata_version(long = FALSE)iucnrdata_version() iucnrdata_version(long = FALSE)
Reads Darwin Core text files (taxon.txt, distribution.txt,
vernacularname.txt) extracted from the GBIF IUCN archive into three data
frames using the column names defined by the archive meta.xml. Note that
distribution.txt is parsed into iucn_threatstatus, retaining key fields
(threatStatus, source, locality, occurrenceStatus) while dropping empty
country-level distribution columns.
process_iucn_gbif(dwc_dir)process_iucn_gbif(dwc_dir)
dwc_dir |
Character. Path to the directory containing the unzipped GBIF Darwin Core text files ( |
A named list containing three tibbles:
A tibble with taxonomic classification, authorship, taxonomic status, and references.
A tibble with IUCN Red List category (threatStatus), assessment citations, locality, and occurrence status.
A tibble with vernacular names linked to taxonID, languages, and preferred name status.
## Not run: dwc_dir <- download_iucn_gbif() gbif_data <- process_iucn_gbif(dwc_dir) taxon <- gbif_data$iucn_taxon threat_status <- gbif_data$iucn_threatstatus vernacular <- gbif_data$iucn_vernacularname ## End(Not run)## Not run: dwc_dir <- download_iucn_gbif() gbif_data <- process_iucn_gbif(dwc_dir) taxon <- gbif_data$iucn_taxon threat_status <- gbif_data$iucn_threatstatus vernacular <- gbif_data$iucn_vernacularname ## End(Not run)