build_col: Rebuild the Catalogue of Life snapshot

In taxadb: A High-Performance Taxonomic Database Interface

Rebuild the Catalogue of Life snapshot

Description

Rebuild the Catalogue of Life snapshot

Usage

build_col(
  version = format(Sys.Date(), "%Y"),
  archive = NULL,
  dir = build_dir(),
  db = td_connect()
)

Arguments

version	snapshot version to write, e.g. "2026"
archive	path to the COL Darwin Core Archive; downloaded if missing
dir	directory for build inputs and outputs
db	a duckdb connection

Details

COL publishes a Darwin Core Archive whose scientificName carries the authorship – ⁠Acanthocerataceae Crawford & Round⁠. taxadb wants the canonical name, since authorship abbreviations vary too much between providers to match on. COL also supplies scientificNameAuthorship separately, so the canonical name is the one with that suffix removed.

COL marks accepted names by leaving acceptedNameUsageID empty, and distinguishes accepted from ⁠provisionally accepted⁠; both are accepted in the sense that matters here, that they are not a synonym of anything else, so both get acceptedNameUsageID set to their own taxonID.

Value

the paths written, invisibly

See Also

Other build: build_fishbase(), build_gbif(), build_itis(), build_ncbi(), build_ott()

Examples

## Not run: 
build_col("2026")

## End(Not run)

taxadb documentation built on Aug. 31, 2026, 5:07 p.m.