How do I know which version of the NBIA Data Retriever I am running?

For the NBIA Data Retriever version 3.0 and later, the version information appears in the About menu. The version also appears at the bottom of the login windows when you download a private collection. The following steps for determining your version apply to NBIA Data Retriever version 2.0 and earlier.

On Windows 10:

1. Open the Start menu.
2. Click Settings > System.
3. From the left pane, select Apps & features.
4. Search for NBIA Data Retriever.
5. Click NBIA Data Retriever. The version number appears in the application details.
   
   

On Windows 7:

1. Open the Control Panel.
2. Click Programs and Features. The version number appears in the version column.

On Mac:

1. Go to the Finder.
2. Click an application to select it, then press the spacebar. A window appears, showing the version number, size, and last modification date.
   
   

On CentOS:

• Type the following command at the command prompt of a terminal window: 
  yum list installed | grep "TCIADownloader"

On Ubuntu:

• Type the following command at the command prompt of a terminal window:  
  dpkg -l |grep tciadownloader

Why does nothing happen after I click Remind me later on the New Version Notification window?

As of TCIA/NBIA 6.5.3, manifest files are self-contained and only version 3.0 and later of the NBIA Data Retriever can read it. Please update your app.

Why, after I upgrade the NBIA Data Retriever, do two versions of it appear in Apps & features on Windows 10, and on Programs and Features on Windows 7?

You can ignore the double entries. It is likely that you installed an early version of NBIA Data Retriever 2.0 or NBIA Data Retriever 1.0,  which have different upgrade codes internally. The old software is removed when the new version is installed. If the newly installed application is not functioning as expected, you can manually remove the old one and reinstall the new one. However, it is not required to do so.

I generated a manifest file a while ago. How do I know which version of the NBIA Data Retriever to use with it?

Always use the latest version of the application. The Downloader application is backward-compatible. The following table shows the version compatibility between manifest files and the Downloader.

What is the dependency of the NBIA Data Retriever on Linux and how we can satisfy the dependencies?

On CentOS or Red Hat Linux, use the command sudo yum -v -y remove TCIADownloader.x86_64;sudo yum -y install NBIADataRetriever -3.2-1.x86_64.rpm to install the NBIA Data Retriever. This command pulls and installs all missing dependent libraries when the NBIA Data Retriever is installed. If you install another way, you may not install all of the dependent libraries. Also, note that the NBIA Data Retriever always takes a manifest file as a parameter. In a GUI desktop environment, start the NBIA Data Retriever by clicking a manifest file.

How do I run the NBIA Data Retriever from the command line on RedHat/CentOS Linux?

Assuming the NBIA Data Retriever is installed on /opt/Downloader (this is the location that the NBIA Data Retriever is installed at when it is installed with command sudo yum -v -y remove TCIADownloader.x86_64;sudo yum -y install NBIADataRetriever -3.2-1.x86_64.rpm).  To run the NBIA Data Retriever from the command line, assuming you are running the NBIA Data Retriever 3.2, type the command:

sudo /opt/NBIADataRetriever/NBIADataRetriever  <full path of manifest file including the file name>

The NBIA Data Retriever always needs to run with a manifest file. Although the application can be invoked from command line, it works best in a desktop environment such as Gnome, KDE, and so on. Once the NBIA Data Retriever is installed in the desktop environment, you can click any manifest file with the extension .tcia to invoke the app.

Using the NBIA Data Retriever, I get error messages for “Error invoking method” then “Failed to launch JVM”. How can I fix this problem?

These errors occur because the NBIA Data Retriever cannot work without a manifest file. See Creating Manifest Files for instructions to create a manifest file using NBIA or an API. To avoid this error, download and install the NBIA Data Retriever first, then locate a manifest file on your computer. If you have not installed the Downloader App or TCIA Downloader before, consider removing these applications first before installing the NBIA Data Retriever. This is not mandatory but will prevent you from having to specify which application your computer should use to open the manifest file. To do so, right-click the manifest file and choose to open it with the NBIA Data Retriever. 

I clicked a manifest file and received the error “Failed to find library: jvm.dll” on Windows 10. How can I fix it?

This is a Java bug that displays the following error message:

The workaround is to uninstall the NBIA Data Retriever and download the free community version of Visual Studio 2017. Install Visual Studio 2017 and then reinstall the NBIA Data Retriever.

I want to find and download series with over 500 images (or another specific request). How do I do that?

When you have very specific search needs that the search filters and text search do not satisfy, but the information exists in the TCIA database, you have two options for specific searches. 

Search the data portal

Run a search in the TCIA Radiology Portal. Add all of your search results to the cart. Sort your cart by number of images, or any other field you are interested in that appears in the search result. Remove the series you don't want by clicking the series' cart icon. Download the cart.

Build your own manifest file

Run a search in the TCIA Radiology Portal. When you get to the cart, click Export Spreadsheet. Sort the spreadsheet by number of images, or any other field you are interested in that appears in the spreadsheet. Select only those series IDs that meet your search criteria. Copy those IDs into a manifest file using its standard structure. 

downloadServerUrl=https://public.cancerimagingarchive.net/nbia-download/servlet/DownloadServlet
includeAnnotation=true
noOfrRetry=4
databasketId=manifest-1604674259810.tcia
manifestVersion=3.0
ListOfSeriesToDownload=
1.3.6.1.4.1.14519.5.2.1.5099.8010.427264300850965737262860055580
1.3.6.1.4.1.22213.2.26555.2
1.3.6.1.4.1.14519.5.2.1.5099.8010.279840345131785576013456733353
1.3.6.1.4.1.14519.5.2.1.5099.8010.293653169363509354643731389289
<enter more series IDs here>