{"id":16704101,"url":"https://github.com/rekyt/taxo_harmonization","last_synced_at":"2025-04-10T05:03:52.271Z","repository":{"id":51048884,"uuid":"334105644","full_name":"Rekyt/taxo_harmonization","owner":"Rekyt","description":":notebook: Companion code for Grenié et al. 2022 MEE \"Harmonizing taxon names in biodiversity data: a review of tools, databases, and best practices\" preprint: 10.32942/osf.io/e3qnz","archived":false,"fork":false,"pushed_at":"2023-06-28T14:08:20.000Z","size":26541,"stargazers_count":12,"open_issues_count":2,"forks_count":1,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-03-24T06:11:59.489Z","etag":null,"topics":["biodiversity-database","taxonomic-classification","taxonomic-databases","taxonomy","taxonomy-database"],"latest_commit_sha":null,"homepage":"https://doi.org/10.1111/2041-210X.13802","language":"R","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Rekyt.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2021-01-29T10:05:02.000Z","updated_at":"2024-08-05T04:13:58.000Z","dependencies_parsed_at":"2025-02-16T14:38:19.125Z","dependency_job_id":"07ca1433-b014-465b-a118-99b82fb52e05","html_url":"https://github.com/Rekyt/taxo_harmonization","commit_stats":null,"previous_names":[],"tags_count":3,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Rekyt%2Ftaxo_harmonization","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Rekyt%2Ftaxo_harmonization/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Rekyt%2Ftaxo_harmonization/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Rekyt%2Ftaxo_harmonization/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Rekyt","download_url":"https://codeload.github.com/Rekyt/taxo_harmonization/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248161281,"owners_count":21057554,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["biodiversity-database","taxonomic-classification","taxonomic-databases","taxonomy","taxonomy-database"],"created_at":"2024-10-12T19:11:07.788Z","updated_at":"2025-04-10T05:03:52.252Z","avatar_url":"https://github.com/Rekyt.png","language":"R","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Taxonomic Harmonization\n\n\u003c!--Badges: starts--\u003e\n[![Code DOI](https://zenodo.org/badge/DOI/10.5281/zenodo.5121244.svg)](https://doi.org/10.5281/zenodo.5121244)\n[![MEE Paper DOI](https://img.shields.io/badge/MEE%20Paper%20DOI-10.1111%2F2041--210X.13802-red)](https://doi.org/10.1111/2041-210X.13802)\n[![EcoevoRxiv Preprint](https://img.shields.io/badge/EcoEvoRxiv%20preprint-10.32942%2Fosf.io%2Fe3qnz-brightgreen)](https://doi.org/10.32942/osf.io/e3qnz)\n\u003c!--Badges: end--\u003e\n\n## Description\n\nThis repository contains the companion code and the associated shiny app `taxharmonizexplorer` of Grenié et al. (2022, MEE). It contains the associated figures of the paper, the code to generate the ones made from code, as well as the code to run the taxonomic harmonization workflows used in the paper.\n\n\n## Citation\n\nThis repository accompanies the following article:\n\n\u003e Grenié, M., Berti, E., Carvajal-Quintero, J., Dädlow, G.M.L., Sagouis, A. and Winter, M. (2022), Harmonizing taxon names in biodiversity data: a review of tools, databases, and best practices. Methods in Ecology and Evolution. Accepted Author Manuscript. https://doi.org/10.1111/2041-210X.13802\n\nVersion of the code available in this repository have been archived on Zenodo: \n\n[![DOI](https://zenodo.org/badge/DOI/10.5281/zenodo.5121244.svg)](https://doi.org/10.5281/zenodo.5121244)\n\nRefer to the above mentioned DOI to get the last up-to-date version or use the following citation:\n\n\u003e Matthias Grenié, Alban Sagouis, \u0026 Emilio Berti. (2021, July 22). Rekyt/taxo_harmonization: Submitted version (Version submitted). Zenodo. https://doi.org/10.5281/zenodo.5380285.\n\n\n## Running `taxharmonizexplorer` (companion shiny app)\n\nThe shiny app is available at https://mgrenie.shinyapps.io/taxharmonizexplorer/\n\nThe development version of the shiny app can be run with the following command in RStudio:\n\n```r\nshiny::runGitHub(\"Rekyt/taxo_harmonization\", subdir = \"taxharmonizexplorer\")\n```\n\nIf you have a **local copy** of the repository you can run the app with:\n\n```r\nshiny::runApp(\"taxharmonizexplorer\")\n```\n\n\n### Scripts used to build the network of tools\n\nThe scrips used to build the networks of tools are available in the `scripts` folder. They are numbered from `01` to `03` to be run sequentially. They all used the raw data available in the Excel sheet available in `data/data_raw/Table comparing taxonomic tools.xlsx`.\n\n\n## Example harmonization workflows (BioTIME species data)\n\nThis repository also contains scripts to harmonize the taxonomy of [the BioTIME database](https://biotime.st-andrews.ac.uk/). We here present four different workflows on the raw taxonomy from BioTIME (available at `data/data_raw/biotime.txt`):\n\n1. Workflow 1 (**Torino**): working with higher taxonomic groups (standardize species names through higher taxonomic group assignation).\n1. Workflow 2 (**Bogota**): matching the entire list of species on different taxon-specific databases.\n1. Workflow 3 (**GBIF only with pre-processed**): pre-process the species names and then match the obtained list against GBIF.\n1. Wrofklow 4 (**GBIF only no pre-processing**): match raw species list on GBIF.\n\nResults from cleaning are saved in the folder `data/data_cleaned/biotime_results/` as csv files. Two columns are present in the csv, `parsed` is the input name as obtained using `rgnparser` on BioTIME species names; the second column is the named matched in a specific database.\n`biotime_common.csv` is the original BioTIME names with the parsed version from `rgnparser` and the class and phylum to which they belong obtained using `rgbif`. The last column `common` refer to how the high taxonomies are referred (e.g. \"vascular plants\" for \"Trachephyta\").\n\n\n### Running the workflow\n\nYou can run the entire workflow thanks to the `harmonize.R` script available in the *scripts* folder.\nTo run the workflow run the following code:\n\n```{r}\nsource(\"scripts/harmonize.R\")\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frekyt%2Ftaxo_harmonization","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Frekyt%2Ftaxo_harmonization","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frekyt%2Ftaxo_harmonization/lists"}