 |
Page History
...
The NBIA Data Retriever is a software product you can download and install so that you can download radiology images from from the TCIA Radiology Portal. This guide documents the command-line interface (CLI) of the NBIA Data Retriever. See the Cancer Imaging Archive User's Guide to learn how to use the Graphical User Interface (GUI) of the TCIA Radiology Portal.
Installing the NBIA Data Retriever on Linux
...
To run the NBIA Data Retriever on CentOS, run the following sample command.
Code Block /opt/NBIADataRetriever/NBIADataRetriever --cli <location>/<manifest file name>.tcia -d <parent location>/<download directory> -l <location>/<credential file> -v –f
To run the NBIA Data Retriever on Ubuntu, run the following sample command.
Code Block /opt/nbia-data-retriever/nbia-data-retriever --cli <location>/<manifest file name>.tcia -d <parent location>/<download directory> -l <location>/<credential file> -v –f
Tip A credential file is a text file that passes the user's credentials in the following format:
Code Block userName=YourUserName passWord=YourPassword
The parameters "userName" and "passWord" are case-sensitive.
...
CLI Parameters
The options available for the command line interface are described in the following table.
if If you use the NBIA Data Retriever CLI with option the -v, -f, or -q options, and want to access restricted collection(s), put these options after the user credential parameters.
| Option | Description |
|---|---|
| -c, -C, --cli, --CLI | Indicates running as a CLI app |
| -d, -D <download directory> | Required. The user must have write permission for the directory specified with this option. |
| -f, -F | Skip the series the user does not have access to. Force the user to download the series if the user has access. Default is false. |
| -l <credential file> | Required when the manifest file has series from restricted collections. Optional when the manifest file has series from public collections only. |
| -m, -M, --md5, –MD5 | Enable validation of the checksums of the downloaded files. Default is that checksums will not be validated. |
| -p, -P <password> | Optional |
| -q, -Q | Quiet. Default is false |
| -u, -U <user name> | Optional |
| -v, -V | Verbose. Default is false. |
Resuming an Interrupted Download Using the CLI
If your download is interrupted due to errors or any other reason, you can resume the download using the CLI.
To resume the interrupted download, do the following.
- At the command line, use the same command from the same directory that you originally used to start the CLI. Note that if the -d option is used to define the download directory, you must provide the same directory after "d."" (this is a temporary workaround).
The NBIA Data Retriever reviews what has already been downloaded, then asks “Do you want to download all or download only missing series?" - Enter A to download all, M to download missing series, or E to exit the program.
