update_taxonomy {APCalign}R Documentation

Use APC and APNI to update taxonomy, replacing synonyms to current taxa where relevant


This function uses the Australia's Virtual Herbarium's taxonomic resources, specifically the Australian Plant Census (APC) and the Australian Plant Name Index (APNI), to update taxonomy of plant species, replacing any synonyms to their current accepted name.


  taxonomic_splits = "most_likely_species",
  output = NULL,
  resources = load_taxonomic_resources()



A tibble of plant names to update. This table must include 5 columns, original_name, aligned_name, taxon_rank, taxonomic_dataset, and aligned_reason. These columns are created by the function align_taxa. The columns original_name and aligned_name must be in the format of the scientific name, with genus and species, and may contain additional qualifiers such as subspecies or varieties. The names are case insensitive.


Variable that determines what protocol to use to update taxon names that are ambiguous due to taxonomic splits. The three options are: most_likely_species, which returns the species name in use before the split; alternative names are returned in a separate column return_all, which returns all possible names collapse_to_higher_taxon, which declares that an ambiguous name cannot be aligned to an accepted species/infraspecific name and the name is demoted to genus rank


(optional) Name of the file where results are saved. The default is NULL and no file is created. If specified, the output will be saved in a CSV file with the given name.


the taxonomic resources required to make the summary statistics. Loading this can be slow, so call load_taxonomic_resources separately to greatly speed this function up and pass the resources in.


A tibble with updated taxonomy for the specified plant names. The tibble contains the following columns:

See Also


Other taxonomic alignment functions: align_taxa(), create_taxonomic_update_lookup()


# Update taxonomy for two plant names and print the result
   original_name = c("Dryandra preissii", "Banksia acuminata"),
   aligned_name = c("Dryandra preissii", "Banksia acuminata"),
   taxon_rank = c("species", "species"),
   taxonomic_dataset = c("APC", "APC"),
   aligned_reason = NA_character_

[Package APCalign version 0.1.3 Index]