Package 'iucnr'

Title: IUCN Red List Data
Description: Facilitates access to the International Union for Conservation of Nature (IUCN) Red List of Threatened Species, a comprehensive global inventory of species at risk of extinction. This package streamlines the process of determining conservation status by matching species names with Red List data, providing tools to easily query and retrieve conservation statuses. Designed to support biodiversity research and conservation planning, this package relies on data from the 'iucnrdata' package, available on GitHub <https://github.com/PaulESantos/iucnrdata>. To install the data package, use pak::pak('PaulESantos/iucnrdata').
Authors: Paul Efren Santos Andrade [aut, cre]
Maintainer: Paul Efren Santos Andrade <[email protected]>
License: MIT + file LICENSE
Version: 0.0.0.1
Built: 2025-02-13 05:28:29 UTC
Source: https://github.com/cran/iucnr

Help Index


Retrieve Vernacular Names for a Given Species

Description

This function retrieves vernacular (common) names for a given species using IUCN data. It filters vernacular names based on matching internal_taxon_id and merges them with species metadata.

Usage

get_common_name(splist)

Arguments

splist

A character vector containing the scientific names of species for which vernacular names are to be retrieved.

Details

The function retrieves IUCN data for the input species, extracts the corresponding core_id, filters the vernacular name dataset using the core_id, and concatenates all unique vernacular names for each species.

Value

A data.table or data.frame with columns:

submitted_name

The scientific name of the species as submitted.

vernacular_names

A character string that contains the concatenated vernacular names for each species, separated by " - ".

Examples

species <- c("Panthera uncia", "Cedrela odorata")
result <- get_common_name(splist = species)
print(result)

Get Conservation Status of Species

Description

This function retrieves the conservation status of species from the iucn_data dataset. It is vectorized to handle multiple species names and optimized using data.table for performance.

Usage

get_conservation_status(splist)

Arguments

splist

A character vector of species names to search for in the iucn_data dataset.

Value

A data.table with species names and their corresponding conservation status or "no match found".

Examples

species <- c("Panthera uncia", "Cedrela odorata")
result <- get_conservation_status(splist = species)
print(result)