italic_match {ritalic} | R 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)