The work is split between two packages:
Neither package is on CRAN. To align and update names, install taxonAlign:
# install.packages("pak")
# pak::pak("traitecoevo/taxonAlign")
install.packages("taxonAlign", repos = c('https://traitecoevo.r-universe.dev', 'https://cloud.r-project.org'))
To build your own reference lists as well, install taxonAlign.dataprep, which installs taxonAlign along with it:
pak::pak("traitecoevo/taxonAlign.dataprep")
taxonAlign helps you:
genus sp.), to maximise how many of
your names align successfully.The reference can be one or more of the dated reference lists taxonAlign publishes – the Australian National Species List lists (animals from the Australian Faunal Directory, algae, bryophytes, fungi, lichens) and a GBIF list of Australian animals – your own table, or any mix of these.
It’s inspired by APCalign’s approach to aligning taxon names to the Australian Plant Census, generalised so the reference doesn’t have to be APC/APNI and the taxa don’t have to be plants and names of any taxonomic rank present in your reference (species, genus, family, or anything else) can be matched.
| Function | What it does |
|---|---|
load_taxonomic_resources() |
Load one or more released reference lists – "NSL_animals" (the Australian Faunal Directory), "NSL_algae", "NSL_bryophytes", "NSL_fungi", "NSL_lichens", "GBIF_AU" – from a dated data release (downloaded once, then kept on your computer). |
data_release_versions(), data_release_datasets()
|
List the available data releases, and the datasets in one; name a release with version = to make an alignment reproducible. |
taxonomic_reference_schema(), check_taxonomic_reference()
|
The format a reference table needs to be in, and a check that a table is in it. |
prepare_taxonomic_resources() |
Combine one or more reference tables (released, your own, or any mix) into the structure the matching functions work on. |
align_taxa() |
Match a list of raw taxon names against a reference, via exact and fuzzy matching. |
update_taxa() |
Resolve a matched (possibly synonymous) name forward to its current accepted name. |
create_taxonomic_update_lookup() |
Run align_taxa() and update_taxa() together in one call – the easiest way to go from raw names to a lookup table of accepted names. |
For Australian taxa, load one or more of the released reference lists.
Each is downloaded the first time and stored on your computer, so after
that it works offline; naming the release (version) makes an alignment
reproducible. When a name appears in more than one list, the first
listed wins:
library(taxonAlign)
animals <- load_taxonomic_resources(c("NSL_animals", "GBIF_AU"), version = "2026-10-07")
create_taxonomic_update_lookup(c("Pardalotus striatus", "Cynthia cardui"), animals)
Any table in taxonAlign’s reference format works the same way. Here’s a tiny one for the painted lady butterfly, Vanessa cardui: its current accepted name, plus the name it was long known by, in the genus Cynthia:
library(taxonAlign)
my_reference <- tibble::tibble(
canonical_name = c("Vanessa cardui", "Cynthia cardui"),
scientific_name = c("Vanessa cardui (Linnaeus, 1758)", "Cynthia cardui (Linnaeus, 1758)"),
taxon_rank = "species", taxonomic_status = c("accepted", "synonym"),
taxonomic_dataset = "MY_LIST", genus = c("Vanessa", "Cynthia"),
taxon_ID = c("1", "2"), accepted_name_usage_ID = c("1", "1")
)
create_taxonomic_update_lookup() then matches a list of raw names – an
already-correct name, a historical synonym, and a misspelling – and
resolves each to its current accepted name in one call:
create_taxonomic_update_lookup(
c("Vanessa cardui", "Cynthia cardui", "Vanessa carduii"),
my_reference
) |>
dplyr::select(original_name, aligned_name, accepted_name, taxonomic_status_aligned)
#> # A tibble: 3 × 4
#> original_name aligned_name accepted_name taxonomic_status_aligned
#> <chr> <chr> <chr> <chr>
#> 1 Vanessa cardui Vanessa cardui Vanessa cardui accepted
#> 2 Cynthia cardui Cynthia cardui Vanessa cardui synonym
#> 3 Vanessa carduii Vanessa cardui Vanessa cardui accepted
Cynthia cardui updates to the current accepted name,
taxonomic_status_aligned records that it was a synonym, and the
misspelling (carduii, one letter off) is corrected via fuzzy matching.
See Get started for a full walkthrough of every function, including building your own reference table by hand, combining several sources, matching names of every rank (not just species), and an end-to-end “update a list of raw field names” workflow. See Development history for why this package exists and the real, messy invertebrate names that shaped its design.