Skip to contents

Perform IUCN species matching at genus and species levels

Source: R/iucn_match.R
iucn_match.Rd

[Experimental]

This function matches a list of species against the IUCN database using genus filtering, exact species matching, and fuzzy species matching. The output includes matched species along with their IUCN Red List category and criteria.

Usage

iucn_match(splist)

Arguments

splist

A dataframe or character vector containing species names to be matched.

Value

A dataframe with the following columns:

  • id: Row number identifier.

  • submitted_name: Original species names from the input.

  • matched_species: Matched species name from the IUCN database (or --- if not matched).

  • redlist_category: Red List category of the matched species (or --- if not available).

  • redlist_criteria: Red List criteria of the matched species (or --- if not available).

  • internal_taxon_id: IUCN taxon identifier (or NA).

Examples

iucn_match(c("Panthera uncia", "Cedrela odorata"))
#> 
#> ── Matching names to IUCN genus list ───────────────────────────────────────────
#> ✔ All input genera were matched successfully (2 exact, 0 fuzzy).
#> 
#> ── Matching names to IUCN species list ─────────────────────────────────────────
#> ✔ All species were matched successfully (2 exact, 0 fuzzy).
#> # A tibble: 2 × 6
#>      id submitted_name  matched_species redlist_category redlist_criteria
#>   <int> <chr>           <chr>           <chr>            <chr>           
#> 1     1 Panthera uncia  Panthera uncia  Vulnerable       ---             
#> 2     2 Cedrela odorata Cedrela odorata Vulnerable       ---             
#> # ℹ 1 more variable: internal_taxon_id <chr>