archive-taxonomy
Quick Start
- Command:
archive-taxonomy [daily|-index] - Local executable:
/home/vimalinx/miniforge3/envs/bio/bin/archive-taxonomy - Full reference: See references/help.md for detailed usage
When To Use This Tool
- Build a local NCBI Taxonomy archive for offline taxon, lineage, and rank lookups.
- Refresh taxonomy records after the upstream taxdump changes.
- Rebuild postings so local EDirect searches can query taxonomy fields without going back to NCBI.
- Use this when you want taxonomy data to live inside the same EDirect local-archive structure as other databases.
Common Patterns
# 1) Refresh the local taxonomy archive
export EDIRECT_LOCAL_ARCHIVE=/data/edirect
archive-taxonomy
# 2) Rebuild only the incremental index and invert layers
archive-taxonomy daily
# 3) Rebuild the full local taxonomy postings set
archive-taxonomy -index
Recommended Workflow
- Set
EDIRECT_LOCAL_ARCHIVEand confirm the archive root is writable. - Make sure the required EDirect helpers and local Go toolchain are available.
- Run
archive-taxonomyto download the taxdump and populate the local archive. - Follow with
dailyor-indexas a separate command when you need refreshed search/posting layers. - Check the
DAT,DWN,POP,IDX,INV,COL,MRG, andPSTtiming blocks before relying on the rebuilt archive.
Guardrails
--helpand--versionare not metadata-only; they still run real archive setup logic.- The script depends on
EDIRECT_LOCAL_ARCHIVE,pm-setup,pm-prepare, and a working localgocompiler. - Cleaning and indexing must be run as separate invocations.
- The cleanup ladder (
-clean,-scrub,-scour,-erase,-zap) is destructive and removes progressively more of the local taxonomy archive. - Default FTP mode may try Aspera-backed transfer; pick
-httpsor-ftpexplicitly if transport behavior matters.