name_search: Search plant name against GBIF, KNMS and POWO names backbone.

Description Usage Arguments Value Examples

View source: R/name_search.R

Description

Perform a fuzzy search against three names lists to get best match and POWO taxonomic status.

Usage

1
name_search(name, homosyn_replace = F)

Arguments

name

A scientific plant species name. Better results can be obtained when author is included e.g. Poa annua L.

homosyn_replace

If matched name is classified as a homotypic synonym, the accepted name is returned

Value

Returns a data frame with ...

Examples

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
# single name search
name_search("Poa annua L.")

# Or, search multiple names using purrr::map_dfr
names <- c("Poa annua L.", "Welwitschia mirabilis Hook.f.", "Acacia torrei")

if (requireNamespace("purrr", quietly = TRUE)) {
names_out <- purrr::map_dfr(names, name_search)
}

# if your matched name is a homotypic synonym, you can replace it with the WCVP accepted name
# Results retain the original search name, and all other fields are replaced with the accepted name
name_search("Acacia torrei", homosyn_replace = TRUE)

# and same for multiple species
if (requireNamespace("purrr", quietly = TRUE)) {
names_out <- purrr::map_dfr(names, name_search, homosyn_replace = TRUE)
}

stevenpbachman/LCRapid documentation built on Jan. 24, 2022, 5:16 a.m.