freyja update

Update to the most recent barcodes and curated lineage data

freyja update [OPTIONS]

Options

--outdir <outdir>

Output directory to save updated files

--noncl

only include lineages that areconfirmed by cov-lineages

Default:

True

--buildlocal

Perform barcode building locally

Default:

False

---

Example Usage:

By default, this method ships with an existing “data/usher_barcodes.csv” file for the barcodes, and the outbreak.info curated lineage metadata file for summarizing lineages by WHO designation. To update both of these we recommend running the command: freyja update which downloads new versions of the curated lineage file and barcodes (which are now stored on the github repo to save users time). If the –buildlocal flag is used, the barcodes will calculated locally using the UShER global phylogenetic tree and saved in “data/usher_barcodes.csv”. The –outdir option can be used to specify a local directory to store the lineage mapping and barcode files. By default, Freyja now only includes lineages that are present on cov-lineages.org. To include proposed lineages and lineages that haven’t been released via cov-lineages (usually this lag is no more than a few days), the –noncl flag can be used.

NOTE: Due to the large size of the global tree, this step can be somewhat memory intensive. Providing somewhere in the range of 10GB should be sufficient to ensure the update runs to completion.