gnr_simple: checks species names against a variety of online databases...

View source: R/gnr_simple.r

gnr_simpleR Documentation

checks species names against a variety of online databases supports fuzzy partial matching, using the Global Names Resolver (https://resolver.globalnames.org/). Modified on 11/18/2025 by Vijay Patil (vpatil@usgs.gov) for algaeClassify v2.0.5 (pending approval on CRAN).

Description

checks species names against a variety of online databases supports fuzzy partial matching, using the Global Names Resolver (https://resolver.globalnames.org/). Modified on 11/18/2025 by Vijay Patil (vpatil@usgs.gov) for algaeClassify v2.0.5 (pending approval on CRAN).

Usage

gnr_simple(
  name,
  sourceid = NULL,
  best_match = TRUE,
  fuzzy_uninomial = TRUE,
  name_type = "canonical_full",
  higher = FALSE
)

Arguments

name

character string binomial scientific name to resolve

sourceid

integer vector with data source ids. see https://resolver.globalnames.org/sources/

best_match

boolean. Should the best match be returned based on score?

fuzzy_uninomial

boolean. Use fuzzy matching for uninomial names?

name_type

Specify format of matched names. Options are 'canonical_simple' (canonical binomial name), 'canonical_full' (with subspecies or subgenera), or 'with_context' (with author and year appended).

higher

boolean: Return higher taxonomic classifications?

Value

new data.frame with name matches, column indicating match type and scores from Global Names Resolver (https://resolver.globalnames.org/). Will contain a row of NAs if no matches found

Examples

#Visit https://resolver.globalnames.org/data_sources to see all possible
#data sources for name checking.
name<-"Aphanazomenon flos-aquae"
#sourceid=3 for ITIS database
gnr_simple(name,sourceid=3) #search for best match from ITIS
gnr_simple(name,sourceid=NULL,best_match=FALSE) #search for all matches from any source

algaeClassify documentation built on Dec. 2, 2025, 1:06 a.m.