Skip to content

CLI Reference

The ddacs command-line interface provides tools for downloading and managing the DDACS dataset.

Commands

ddacs info

Display dataset information and available versions.

ddacs info

ddacs download

Download dataset files from DaRUS.

ddacs download [VERSION] [OPTIONS]

Arguments:

Argument Default Description
VERSION 2.0 Dataset version to download

Options:

Option Description
--small Download small test set (~50GB)
--out PATH Output directory (default: ./data)
--files FILE... Download specific files only
--no-extract Skip extraction of zip files
--keep-zip Keep zip files after extraction
-y, --yes Skip confirmation prompt

Download Size

The displayed download size refers to the compressed zip files. By default, files are extracted after download, resulting in larger disk usage than shown.

Examples:

# Download full dataset
ddacs download

# Download small test set
ddacs download --small

# Download to custom directory
ddacs download --out /path/to/data

# Download specific files
ddacs download --files metadata.csv 403926_406296.zip

Global Options

Option Description
--token TOKEN DaRUS API token (for draft access)
-V, --version Show version and exit