nextstrain remote download

usage: nextstrain remote download <remote-url> [<local-path>]
       nextstrain remote download --recursively <remote-url> [<local-directory>]
       nextstrain remote download --help

Download datasets and narratives from a remote source.

A remote source URL specifies what to download, e.g. to download one of the seasonal influenza datasets:

nextstrain remote download nextstrain.org/flu/seasonal/h3n2/ha/2y

which creates three files in the current directory:

flu_seasonal_h3n2_ha_2y.json
flu_seasonal_h3n2_ha_2y_root-sequence.json
flu_seasonal_h3n2_ha_2y_tip-frequencies.json

The –recursively option allows for downloading multiple datasets or narratives at once, e.g. to download all the datasets under “ncov/open/…” into an existing directory named “sars-cov-2”:

nextstrain remote download --recursively nextstrain.org/ncov/open sars-cov-2/

which creates files for each dataset:

sars-cov-2/ncov_open_global.json
sars-cov-2/ncov_open_global_root-sequence.json
sars-cov-2/ncov_open_global_tip-frequencies.json
sars-cov-2/ncov_open_africa.json
sars-cov-2/ncov_open_africa_root-sequence.json
sars-cov-2/ncov_open_africa_tip-frequencies.json
…

See nextstrain remote for more information on remote sources.

positional arguments

<remote-url>

Remote source URL for a dataset or narrative. A path prefix to scope/filter by if using --recursively.

<local-path>

Local directory to save files in. May be a local filename to use if not using --recursively. Defaults to current directory (“.”).

options

-h, --help

show this help message and exit

--recursively, -r

Download everything under the given remote URL path prefix

--dry-run

Don’t actually download anything, just show what would be downloaded