download-flatfile
Quick Start
- Command:
download-flatfile [-ftp|-https] [-verify] division... - Local executable:
/home/vimalinx/miniforge3/envs/bio/bin/download-flatfile - Full reference: See
references/help.md
When To Use This Tool
- Download one or more GenBank flatfile divisions as
.seq.gzarchives. - Re-check previously downloaded GenBank flatfiles and remove corrupt or empty files with
-verify. - Build a local flatfile mirror for downstream XML conversion or archive indexing.
Common Patterns
# 1) Download bacterial and viral GenBank flatfiles via the default FTP mode
download-flatfile BCT VRL
# 2) Use HTTPS explicitly if FTP routing is unreliable
download-flatfile -https PLN INV
# 3) Validate existing flatfiles and delete broken or empty downloads
download-flatfile -verify BCT VRL
Recommended Workflow
- Start in a dedicated download directory because all
.seq.gzfiles are written to the current working directory. - Download the divisions you need, choosing
-httpsif FTP is flaky in your environment. - Re-run with
-verifybefore downstream processing when download integrity matters. - Convert or inspect the flatfiles only after the validation pass is clean.
Guardrails
-verifyis destructive by design: it removes empty or invalid.seq.gzfiles so they can be re-downloaded.- The local wrapper validates content by decompressing and checking parsed records, so verification can be expensive on large downloads.
- Output is written into the current directory, and large GenBank divisions consume substantial disk space.
- The wrapper retries failed downloads, but persistent network or content failures still leave you with deleted files that must be fetched again later.