NIH | National Cancer Institute | NCI Wiki  

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Panel
titleTopics on this page

Table of Contents

Downloading the

...

NBIA Data Retriever

Panel
borderColorred
borderStylesolid
titleGet the Downloader appNBIA Data Retriever

Click one of the following links to download the Downloader NBIA Data Retriever for that operating system.

  • Windows
  • Mac: NBIA Data Retriever in the Mac App Store
  • RPM (tested on CentOS)
    To run this file, type the following at the command prompt:
    sudo yum install TCIADownloader-v -y remove TCIADownloader.x86_64;sudo yum -y install NBIADataRetriever -3.02-1.x86_64.rpm
  • DEB (tested on Ubuntu)
    To run this file, type the following at the command prompt:
    sudo -S dpkg -i tciadownloader_3.0-2_amd64r tciadownloader;sudo -S dpkg -i nbia-data-retriever-3.2.deb

After you search for images of interest and add them to your data basket, you can download them.

The most convenient method of downloading is by using the Downloaderthe NBIA Data Retriever. You must install the Downloader before the NBIA Data Retriever before you begin downloading. You only have to install it once to use it in future downloading sessions.

Info

Consult the Downloader NBIA Data Retriever FAQ for more information about Downloader NBIA Data Retriever versions and usage.

Info

If you cannot install the Downloader NBIA Data Retriever for any reason, you can run the Temporary Downloader TCIA Download Manager (JNLP) instead.

Installing

...

the NBIA Data Retriever

To install the Downloader on Windows or Macthe NBIA Data Retriever on Windows

  1. Download the installer package for Windows or Mac using the links link above.
  2. Save the installer package file to your computer.
  3. Install the app by double-clicking the installer package file.
  4. Agree to the terms in the License Agreement and click Install.
  5. When the Setup Wizard ends, click Finish.

To install the NBIA Data Retriever on Mac

Note

The Mac version of the NBIA Data Retriever is only available through the iOS App Store. It requires a manifest file to work. You can download the app first or create a manifest file first. If you download the app first, right-click the manifest file and select Open With NBIA Data Retriever. If you create a manifest file first, right-click it and select Open With App Store. This installs the app and then opens the manifest file in the app.

  1. On your Mac, find the NBIA Data Retriever on the Mac App Store.

    Tip

    The NBIA Data Retriever is free but still requires you to log in to download it. Consider changing your iOS Password Settings so that you can download free software without having to log in separately for it.

  2. Click Get, then click Install App. The NBIA Data Retriever is free.
    The app starts downloading to your Mac. When the download is complete, you can open a manifest file with the NBIA Data Retriever.

To install the NBIA Data Retriever on Linux (centOS or Downloader on Linux (centOS or Ubuntu)

You must have the sudo privilege the sudo privilege on your computer and a sudo password a sudo password to install the TCIA Downloader app on the NBIA Data Retriever on CentOS and Ubuntu.

  1. Download the installer package for centOS or Ubuntu using the links above.
  2. Save the installer package file to your computer.
  3. Open a command window and go to the location where you saved the installer.
    • For a centOS system, enter the following at the command prompt:
      sudo yum -v -y remove TCIADownloader.x86_64;sudo yum -y install TCIADownloaderNBIADataRetriever -3.2.0-1.x86_64.rpm
    • For an Ubuntu system, enter the following at the command prompt:
      sudo -S dpkg -r TCIADownloader.x86_64tciadownloader;sudo -S dpkg -i TCIADownloader-2.0-2.x86_64nbia-data-retriever-3.2.deb
      Enter the sudo password the sudo password when prompted.

Downloading Images Using

...

the NBIA Data Retriever

When you start downloading the images you have added to the data basket, NBIA provides a list of those images in a manifest file (manifest-xxx.tcia). You must have already installed the Downloader to the NBIA Data Retriever to open this manifest file and download the images.

Info
  1. Search for images of interest.
  2. Add those images to your data basket.
  3. Open the My Data Basket page and click Start Download.
  4. Click the Click the manifest-xxx.tcia file.
    If you are only downloading public images, the Downloader appearsthe NBIA Data Retriever appears, listing the items in your data basket. If you are downloading any private images, see the section about downloading private data.
    TCIA Downloader with a collection in it to downloadImage RemovedNBIA Data Retriever in the process of downloading dataImage Added

    Info

    The Downloader app NBIA Data Retriever lists all items you selected in the data basket. You can hover your mouse over the Patient ID, Study Instance, and Series Instance columns to reveal the complete corresponding IDs. You can also resize a column by selecting and dragging the column border.

    If you do not want to download any of those items, select them in the Downloads table and then click Delete. When you remove an item from the Downloads table, it stays in your data basket.

  5. Click Browse to navigate to the destination where you want the images/annotations to be downloaded.

  6. Click Start to begin the download. You can monitor the download in the Progress column. The Status column indicates when the download for each item is complete.

    At any point in the process, you can click the Pause and Resume buttons to temporarily stop and restart the process.

    Note that files downloaded this way are not compressed. The downloaded files are stored in a child folder under the destination folder such as such as Collection Name > Patient ID > part of Study Date + part of Study ID + part of Study Description + last 5 digits of Study Instance UID > part of Series Number + part of Series Description + last 5 digits of Series Instance UID.

    Info
    titleNetwork Error?

    If network errors occur during large downloads, the Downloader app NBIA Data Retriever retries the files the number of times that your administrator has configured.

Downloading Private Data

If you are downloading any private data, you are prompted to log in.
TCIA Downloader log in windowImage RemovedImage Added

 Once Once you log in, the Downloader appearsthe NBIA Data Retriever appears.

If you do not have permission to access even one of the collections/sites to which the images you have in your manifest file, you are prompted to contact the help desk to request permission to access all of the images.
TCIA Downloader contact the help desk to request permission to access all of the imagesImage RemovedImage Added