Skip to contents

Welcome to the iucnr package, a comprehensive tool designed for researchers and conservationists to access and analyze data from the IUCN Red List of Threatened Species. This package allows users to retrieve and integrate taxonomic and vernacular name data, empowering them to conduct thorough assessments of species status and threats. With a strong emphasis on enhancing biodiversity research, iucnr offers a user-friendly interface for navigating the extensive datasets available through the Global Biodiversity Information Facility (GBIF).

The iucnr package enables access to Red List data on threatened species without the need for an internet connection, making it a valuable resource for evaluating the conservation status of various species. The information is sourced from the GBIF repository (https://www.gbif.org/dataset/19491596-35ae-4a91-9a98-85cf505f1bd3).

While there are other packages available for similar purposes, they typically require an API key to access the IUCN API, which can be a barrier for some users.

Spanish Version

Bienvenido al paquete iucnr, una herramienta integral diseñada para investigadores y conservacionistas que desean acceder y analizar datos de la Lista Roja de Especies Amenazadas de la IUCN. Este paquete permite a los usuarios recuperar e integrar datos taxonómicos y nombres vernáculos, empoderándolos para realizar evaluaciones exhaustivas sobre el estado y las amenazas a las especies. iucnr ofrece una interfaz amigable para navegar a través de los extensos conjuntos de datos disponibles a través de la Global Biodiversity Information Facility (GBIF) de la Lista Roja de Especies Amenazadas sin necesidad de estar conectado a internet, lo que lo convierte en un recurso valioso para evaluar el estado de conservación de diversas especies. La información se obtiene del repositorio de GBIF (https://www.gbif.org/dataset/19491596-35ae-4a91-9a98-85cf505f1bd3).

Si bien existen otros paquetes disponibles para objetivos similares, estos generalmente requieren una clave de API para acceder al API de la IUCN, lo que puede ser un obstáculo para algunos usuarios.

Installation

install.packages("iucnr")
# or
pak::pak("iucnr")

Also you can install the iucnr package from GitHub using the following command:

pak::pak("PaulESantos/iucnr")

Example

  • Define a vector of species names
species_names <- c("Panthera uncia", "Lynx lynx", "Ara militaris", "Zonotrichia capencis")
  • Example usage of the get_conservation_status function This retrieves the conservation status for the specified species
library(iucnr)
#> This is iucnr 0.0.0.1
#> The iucnr package is compatible with IUCN Red List version 2024-1,
#> providing tools to access and analyze the latest conservation status data.

conservation_status <- get_conservation_status(species_names = species_names)
conservation_status
#> [1] "Vulnerable"     "Least Concern"  "Vulnerable"     "no match found"
  • Example usage of the get_conservation_status function within a tibble This creates a tibble and adds a new column with the conservation status of each species
species_data <- tibble::tibble(species = species_names) |> 
  dplyr::mutate(iucn = get_conservation_status(species))
species_data
#> # A tibble: 4 × 2
#>   species              iucn          
#>   <chr>                <chr>         
#> 1 Panthera uncia       Vulnerable    
#> 2 Lynx lynx            Least Concern 
#> 3 Ara militaris        Vulnerable    
#> 4 Zonotrichia capencis no match found
  • Example usage of the get_iucn_data function This retrieves detailed IUCN data for the specified species names
iucn_data_result <- get_iucn_data(species_names)
iucn_data_result
#>         submitted_name  core_id                 scientific_name  kingdom
#> 1        Ara militaris 22685548  Ara militaris (Linnaeus, 1766) ANIMALIA
#> 2            Lynx lynx    12519      Lynx lynx (Linnaeus, 1758) ANIMALIA
#> 3       Panthera uncia    22732 Panthera uncia (Schreber, 1775) ANIMALIA
#> 4 Zonotrichia capencis     <NA>                            <NA>     <NA>
#>     phylum    class          order      family    genus specific_epithet
#> 1 CHORDATA     AVES PSITTACIFORMES PSITTACIDAE      Ara        militaris
#> 2 CHORDATA MAMMALIA      CARNIVORA     FELIDAE     Lynx             lynx
#> 3 CHORDATA MAMMALIA      CARNIVORA     FELIDAE Panthera            uncia
#> 4     <NA>     <NA>           <NA>        <NA>     <NA>             <NA>
#>   scientific_name_authorship taxon_rank infraspecific_epithet taxonomic_status
#> 1           (Linnaeus, 1766)    species                  <NA>         accepted
#> 2           (Linnaeus, 1758)    species                  <NA>         accepted
#> 3           (Schreber, 1775)    species                  <NA>         accepted
#> 4                       <NA>       <NA>                  <NA>             <NA>
#>   accepted_name_usage_id
#> 1               22685548
#> 2                  12519
#> 3                  22732
#> 4                     NA
#>                                                                                                                                                                                                 bibliographic_citation
#> 1                                        BirdLife International 2020. Ara militaris (Linnaeus, 1766). The IUCN Red List of Threatened Species 2020: https://doi.org/10.2305/IUCN.UK.2020-3.RLTS.T22685548A179407584.en
#> 2                               Breitenmoser, U., Breitenmoser-Würsten, C., Lanz, T., von Arx, M., Antonevich, A., Bao, W. & Avgan, B. 2015. Lynx lynx (Linnaeus, 1758). The IUCN Red List of Threatened Species 2015:
#> 3 McCarthy, T., Mallon, D., Jackson, R., Zahler, P. & McCarthy, K. 2017. Panthera uncia (Schreber, 1775). The IUCN Red List of Threatened Species 2017: https://doi.org/10.2305/IUCN.UK.2017-2.RLTS.T22732A50664030.en
#> 4                                                                                                                                                                                                                 <NA>
#>                                                    references
#> 1 https://apiv3.iucnredlist.org/api/v3/taxonredirect/22685548
#> 2    https://apiv3.iucnredlist.org/api/v3/taxonredirect/12519
#> 3    https://apiv3.iucnredlist.org/api/v3/taxonredirect/22732
#> 4                                                        <NA>
#>                                                                                                                                                                                                                 source
#> 1                                        BirdLife International 2020. Ara militaris (Linnaeus, 1766). The IUCN Red List of Threatened Species 2020: https://doi.org/10.2305/IUCN.UK.2020-3.RLTS.T22685548A179407584.en
#> 2                               Breitenmoser, U., Breitenmoser-Würsten, C., Lanz, T., von Arx, M., Antonevich, A., Bao, W. & Avgan, B. 2015. Lynx lynx (Linnaeus, 1758). The IUCN Red List of Threatened Species 2015:
#> 3 McCarthy, T., Mallon, D., Jackson, R., Zahler, P. & McCarthy, K. 2017. Panthera uncia (Schreber, 1775). The IUCN Red List of Threatened Species 2017: https://doi.org/10.2305/IUCN.UK.2017-2.RLTS.T22732A50664030.en
#> 4                                                                                                                                                                                                                 <NA>
#>   threat_status occurrence_status infrasp_tag
#> 1    Vulnerable           Present        <NA>
#> 2 Least concern           Present        <NA>
#> 3    Vulnerable           Present        <NA>
#> 4          <NA>              <NA>        <NA>
  • Example usage of the get_vernacular_name function This retrieves the vernacular names for the specified species
vernacular_names_result <- get_vernacular_name(species = species_names)
vernacular_names_result
#>         submitted_name
#> 1            Lynx lynx
#> 2        Ara militaris
#> 3       Panthera uncia
#> 4 Zonotrichia capencis
#>                                                                                                                                                                                                                   vernacular_name
#> 1                                                                                                                                           Lynx, Evroasiin Shiluus, Eurasian Lynx, Lince, Shiluus Mii, Lince Boreal, Lynx Boréal
#> 2                                                                                                                                                             Guacamaya Verde, Guacamayo Militar, Military Macaw, Guacamayo Verde
#> 3 Léopard des neiges, Irvis, Ilbirs, Snow Leopard, Hiun chituwa, Pantera de la Nieves, Akilbirs, Sah, Babri barfi, Baral he, Snezhniy bars, Xue bào, Barfani chita, Schneeleopard, Ounce, Irbis, Irbis, Once, Panthère des neiges
#> 4                                                                                                                                                                                                                            <NA>

Citation