italic_match: Match scientific names of lichens against the database of...

View source: R/italic_match.R

italic_matchR Documentation

Match scientific names of lichens against the database of ITALIC

Description

Aligns scientific names of lichens against the Checklist of the Lichens of Italy available in ITALIC database. The function handles infraspecific ranks (subspecies, varieties, forms) and returns detailed matching information including nomenclatural status and matching scores.

Usage

italic_match(sp_names, subsp_marks = c(), var_marks = c(), form_marks = c())

Arguments

sp_names

A character vector of scientific names to match

subsp_marks

Character vector of markers used to indicate uncommon subspecies rank in the input names (different from "subsp.", "ssp."). For example, to match "Pseudevernia furfuracea b) ceratea", you need to pass "b)" as subsp_mark

var_marks

Character vector of markers used to indicate uncommon variety rank in the input names (different from "var.", "v."). For example, to match "Acarospora sulphurata varietas rubescens", you need to pass "varietas" as var_mark

form_marks

Character vector of markers used to indicate uncommon form rank in the input names (different from "f.", "form"). For example, to match "Verrucaria nigrescens fo. tectorum", you need to pass "fo." as form_mark

Value

A data frame with the following columns:

input_name

Original scientific name provided

matched_name

Name matched in ITALIC database

status

Nomenclatural status ("accepted" or "synonym")

accepted_name

Currently accepted name in ITALIC

name_score

Matching score for the name part (0-100)

auth_score

Matching score for the authority part (0-100)

Examples

## Not run: 
# Simple name match
italic_match("Cetraria islandica")

# Name match where the name contains spelling mistakes
italic_match("Xantoria parietina")

# Match where the name contains uncommon marker
italic_match("Acarospora sulphurata varietas rubescens",
                      var_marks = "varietas")

# Match multiple names
italic_match(c("Cetraria islandica", "Xanthoria parietina"))

## End(Not run)

ritalic documentation built on April 3, 2025, 10:27 p.m.