The Taxonomic Name Resolution Service (TNRS) is a tool for automated standardization of plant scientific names.
The TNRS corrects spelling errors and alternative spellings to a standard list of names, and converts out of date names (synonyms) to the current accepted name. The TNRS can process many names at once, saving hours of tedious and error-prone manual name correction. For names that cannot be resolved automatically, the TNRS present a list of possibilities and provides tools for researching and selecting the preferred name.
The TNRS takes as input either a vector of scientific names, or a data.frame containing two columns: row number and scientific name.
library(TNRS)
#First, we'll grab an example dataset containing two columns: row number and scientific name.
<- tnrs_testfile
fulldata
head(fulldata,n = 20)
## ID
## 1 1
## 2 2
## 3 3
## 4 4
## 5 5
## 6 6
## 7 7
## 8 8
## 9 9
## 10 10
## 11 11
## 12 12
## 13 13
## 14 14
## 15 15
## 16 16
## 17 17
## 18 18
## 19 19
## 20 20
## taxon
## 1 Arecaceae Mauritia
## 2 Solanaceae Solanum bipatens Dunal
## 3 HYPOPTERYGIACEAE Hypopterygium incrassatolimbatum Ma^sA‰A¬Aºll. Hal.
## 4 Helotiaceae Diplothrix juniperifolia
## 5 Arecaceae Leopoldinia pulchra Mart.
## 6 Melastomataceae Leandra schenckii
## 7 Hydnocarpus macrocarpa
## 8 Campyliaceae Warnstorfia trichophylla (Warnst. ) Tuom. & T. J. Kop.
## 9 Piper arboreum Aubl.
## 10 Poaceae Pseudochaetochloa australiensis Hitchc.
## 11 Juglandaceae Engelhardia spicata var. colebrookeana (Lindl. ex Wall. ) Koord. & Valeton
## 12 Malvaceae Hibiscus 'Old Yella'
## 13 Fabaceae Mimosa vepres Lindm.
## 14 Berberidaceae Epimedium xpurpureum Bailly
## 15 Asteraceae Senecio beguei Humbert
## 16 Coelogyne fragrans
## 17 Cyperaceae Rhynchospora cephalotes (L. ) Vahl
## 18 Pteridophyte Nephrolepis mollis Rosenst.
## 19 Piperaceae Piper crassipeduncullum
## 20 Asteraceae Hieracium billyanum var. parvulum B. de Retz
#Note that there are a variety of formats represented here, sometimes including
# scientific name only
# genus only
# family and genus
# family, scientific name, and author
<- TNRS(taxonomic_names = fulldata)
results
# Inspect the results
head(results, 10)
## ID Name_submitted
## 1 1 Arecaceae Mauritia
## 2 2 Solanaceae Solanum bipatens Dunal
## 3 3 HYPOPTERYGIACEAE Hypopterygium incrassatolimbatum Ma^sA‰A¬Aºll. Hal.
## 4 4 Helotiaceae Diplothrix juniperifolia
## 5 5 Arecaceae Leopoldinia pulchra Mart.
## 6 6 Melastomataceae Leandra schenckii
## 7 7 Hydnocarpus macrocarpa
## 8 8 Campyliaceae Warnstorfia trichophylla (Warnst. ) Tuom. & T. J. Kop.
## 9 9 Piper arboreum Aubl.
## 10 10 Poaceae Pseudochaetochloa australiensis Hitchc.
## Overall_score Name_matched_id Name_matched
## 1 1 661203 Mauritia
## 2 1 511246 Solanum bipatens
## 3 0.9201 567645 Hypopterygium incrassatolimbatum
## 4 0.59957384396743 55495 Diplothrix juniperifolia
## 5 1 37339 Leopoldinia pulchra
## 6 1 305636 Leandra schenckii
## 7 1 1284252 Hydnocarpus macrocarpa
## 8 0.67965907517394 540070 Warnstorfia trichophylla
## 9 1 363781 Piper arboreum
## 10 1 387804 Pseudochaetochloa australiensis
## Name_score Name_matched_rank Author_submitted
## 1 1 genus
## 2 1 species Dunal
## 3 1 species Ma^sA‰A¬Aºll. Hal.
## 4 0.59957384396743 species
## 5 1 species Mart.
## 6 1 species
## 7 1 species
## 8 0.59957384396743 species (Warnst. ) Tuom. & T. J. Kop.
## 9 1 species Aubl.
## 10 1 species Hitchc.
## Author_matched Author_score Canonical_author
## 1 L. f.
## 2 Dunal 1 Dunal
## 3 Müll. Hal. 0.6005 Müll. Hal.
## 4 DC.
## 5 Mart. 1 Mart.
## 6 Cogn.
## 7 Warb.
## 8 (Warnst.) Tuom. & T.J. Kop. 1 (Warnst.) Tuom. & T.J. Kop.
## 9 Aubl. 1 Aubl.
## 10 Hitchc. 1 Hitchc.
## Name_matched_accepted_family Genus_submitted Genus_matched Genus_score
## 1 Arecaceae Mauritia Mauritia 1
## 2 Solanaceae Solanum Solanum 1
## 3 Hypopterygiaceae Hypopterygium Hypopterygium 1
## 4 Asteraceae Diplothrix Diplothrix 1
## 5 Arecaceae Leopoldinia Leopoldinia 1
## 6 Melastomataceae Leandra Leandra 1
## 7 Achariaceae Hydnocarpus Hydnocarpus 1
## 8 Amblystegiaceae Warnstorfia Warnstorfia 1
## 9 Piperaceae Piper Piper 1
## 10 Poaceae Pseudochaetochloa Pseudochaetochloa 1
## Specific_epithet_submitted Specific_epithet_matched Specific_epithet_score
## 1
## 2 bipatens bipatens 1
## 3 incrassatolimbatum incrassatolimbatum 1
## 4 juniperifolia juniperifolia 1
## 5 pulchra pulchra 1
## 6 schenckii schenckii 1
## 7 macrocarpa macrocarpa 1
## 8 trichophylla trichophylla 1
## 9 arboreum arboreum 1
## 10 australiensis australiensis 1
## Family_submitted Family_matched Family_score Infraspecific_rank
## 1 Arecaceae Arecaceae 1
## 2 Solanaceae Solanaceae 1
## 3 Hypopterygiaceae Hypopterygiaceae 1
## 4 Helotiaceae
## 5 Arecaceae Arecaceae 1
## 6 Melastomataceae Melastomataceae 1
## 7
## 8 Campyliaceae
## 9
## 10 Poaceae Poaceae 1
## Infraspecific_epithet_matched Infraspecific_epithet_score
## 1
## 2
## 3
## 4
## 5
## 6
## 7
## 8
## 9
## 10
## Infraspecific_rank_2 Infraspecific_epithet_2_matched
## 1
## 2
## 3
## 4
## 5
## 6
## 7
## 8
## 9
## 10
## Infraspecific_epithet_2_score Annotations Unmatched_terms
## 1
## 2
## 3
## 4 Helotiaceae
## 5
## 6
## 7
## 8 Campyliaceae
## 9
## 10
## Name_matched_url Name_matched_lsid Phonetic
## 1 http://www.tropicos.org/Name/40015082 Y
## 2 https://wcvp.science.kew.org/taxon/818455-1 Y
## 3 http://www.tropicos.org/Name/35129557 Y
## 4 http://www.tropicos.org/Name/2705463 Y
## 5 http://www.tropicos.org/Name/2400575 Y
## 6 http://www.tropicos.org/Name/20300803 Y
## 7 http://www.tropicos.org/Name/100431320 Y
## 8 http://www.tropicos.org/Name/35100291 Y
## 9 http://www.tropicos.org/Name/25002004 Y
## 10 http://www.tropicos.org/Name/25520644 Y
## Taxonomic_status Accepted_name
## 1 Accepted Mauritia
## 2 Synonym Solanum cordifolium
## 3 Synonym Hypopterygium tamarisci
## 4 Synonym Zinnia juniperifolia
## 5 Accepted Leopoldinia pulchra
## 6 No opinion
## 7 Accepted Hydnocarpus macrocarpa
## 8 Synonym Sarmentypnum trichophyllum
## 9 Accepted Piper arboreum
## 10 Accepted Pseudochaetochloa australiensis
## Accepted_species Accepted_name_author Accepted_name_id
## 1 L. f. 661203
## 2 Solanum cordifolium Dunal 511341
## 3 Hypopterygium tamarisci (Sw.) Brid. ex Müll. Hal. 567757
## 4 Zinnia juniperifolia (DC.) A. Gray 91439
## 5 Leopoldinia pulchra Mart. 37339
## 6
## 7 Hydnocarpus macrocarpa Warb. 1284252
## 8 Sarmentypnum trichophyllum (Warnst.) Hedenäs 644908
## 9 Piper arboreum Aubl. 363781
## 10 Pseudochaetochloa australiensis Hitchc. 387804
## Accepted_name_rank Accepted_name_url
## 1 genus http://www.tropicos.org/Name/40015082
## 2 species https://wcvp.science.kew.org/taxon/818796-1
## 3 species http://www.tropicos.org/Name/35129670
## 4 species http://www.tropicos.org/Name/2743155
## 5 species http://www.tropicos.org/Name/2400575
## 6
## 7 species http://www.tropicos.org/Name/100431320
## 8 species http://www.tropicos.org/Name/35216910
## 9 species http://www.tropicos.org/Name/25002004
## 10 species http://www.tropicos.org/Name/25520644
## Accepted_name_lsid Accepted_family Overall_score_order
## 1 Arecaceae 1
## 2 Solanaceae 1
## 3 Hypopterygiaceae 1
## 4 Asteraceae 1
## 5 Arecaceae 1
## 6 1
## 7 Achariaceae 1
## 8 Amblystegiaceae 1
## 9 Piperaceae 1
## 10 Poaceae 1
## Highertaxa_score_order Source Warnings
## 1 1 tropicos 0
## 2 1 wcvp 0
## 3 1 tropicos 0
## 4 6 tropicos 4
## 5 1 tropicos 0
## 6 1 tropicos 0
## 7 1 tropicos 0
## 8 3 tropicos 4
## 9 1 tropicos 0
## 10 1 tropicos 0
# The output includes information on the name submitted, the match score (how close the match is), the name matched, the status of the matched name, and the accepted name.
When using the TNRS, we ask that you cite both the TNRS itself and the data sources that are used by the TNRS. The TNRS couldn’t function without these data sources, and it is important to recognize the work of these data providers by citing their work. Users may also want to report metadata about the version of the TNRS they used in their analyses for the purposes of reproducibility. The function TNRS_metadata
facilitates citations and version reporting by providing this information in an easily-used format. This function returns:
<- TNRS_metadata()
metadata
#If you want to see the TNRS version information (e.g. to report in an manuscript):
$version metadata
## db_version build_date code_version api_version
## 1 4.2 2021-08-02 5.0.3
#To see the sources that are used by the TNRS:
$sources metadata
## sourceID sourceName sourceNameFull
## 1 1 tropicos Missouri Botanical Gardens Tropicos database
## 2 2 wfo World Flora Online
## 3 3 wcvp World Checklist of Vascular Plants
## 4 4 usda USDA Plants
## sourceUrl
## 1 https://www.tropicos.org/
## 2 http://www.worldfloraonline.org/
## 3 https://wcvp.science.kew.org/
## 4 https://plants.sc.egov.usda.gov/java/
## description
## 1 The Missouri Botanical Garden's Tropicos database links over 1.33M scientific names with over 4.87M specimens and over 685K digital images. The data includes over 150K references from over 52.6K publications offered as a free service to the world's scientific community.
## 2 The World Flora Online will be an open-access, Web-based compendium of the worlds plant species. It will be a collaborative, international project, building upon existing knowledge and published floras, checklists and revisions but will also require the collection and generation of new information on poorly know plant groups and plants in unexplored regions. WFO replaces The Plant List
## 3 The World Checklist of Vascular Plants aims to deliver a sustainable and curated resource. It is based on Kew’s names and taxonomic backbone which has been created by reconciling the names from the International Plant Names Index (IPNI) with the taxonomy from the World Checklist of Selected Plant Families (WCSP). This Beta version therefore only displays names that are in both IPNI and WCVP. It contains both families that have been completed and peer reviewed by both external and internal experts on the relevant families as well as families that are in the process of being edited and reviewed. Some of the original data which WCSP built upon came from our generous collaborators listed in the acknowledgements. WCVP aims to represent a global consensus view of current plant taxonomy by reflecting the latest published taxonomies while incorporating the opinions of taxonomists based around the world
## 4 The PLANTS Database provides standardized information about the vascular plants, mosses, liverworts, hornworts, and lichens of the U.S. and its territories.
## dataUrl
## 1 http://services.tropicos.org/
## 2 http://104.198.143.165/files/WFO_Backbone/_WFOCompleteBackbone/
## 3 http://sftp.kew.org/pub/data-repositories/WCVP/
## 4 http://plants.usda.gov/adv_search.html
## logo_path
## 1 https://bien.nceas.ucsb.edu/bien/wp-content/uploads/2020/10/TropicosLogo.gif
## 2 https://bien.nceas.ucsb.edu/bien/wp-content/uploads/2021/07/wfo_logo.jpeg
## 3 https://bien.nceas.ucsb.edu/bien/wp-content/uploads/2021/07/kew_logo.png
## 4 https://bien.nceas.ucsb.edu/bien/wp-content/uploads/2020/10/usda-plants-logo.gif
## version sourceReleaseDate tnrsDateAccessed
## 1 <NA> <NA> 2021-07-17
## 2 v.2019.05 2019-05-17 2021-07-07
## 3 v5 2021-06-01 2021-07-12
## 4 <NA> <NA> 2020-04-25
#To get the citation information to paste into a reference manager (e.g. paperpile, zotero):
# writeLines(text = metadata$citations$citation)