You can print and export wiki pages. Topics in this chapter include: TCIA Data Portal enables you to search for images in the local TCIA in vivo image repository. If available, you can also search remote imaging archives. TCIA submissions are organized in the following hierarchy, which is important to remember in creating your search query and reviewing search results: Collection > Patient (Subject) > Study > Series > Images In other words, a Collection is the largest organizing concept within TCIA and it includes data about Patients (also called Subjects). As you continue to drill down to more granular concepts, Patients contain Studies, Studies contain (Image) Series, and Series contain individual Images. TCIA supports the latest versions of Google Chrome and Mozilla Firefox browsers. TCIA provides two ways to search for image studies: When you first open TCIA Data Portal, the Summary tab displays filters for a simple search and pie charts. Click one or more boxes next to each search filter to select it. As you select search filters, they move to the top of the list. They also appear in Boolean query format above the pie charts. This query specifies the filters you have applied to your search. Click Clear if you want to remove all of your filters at once and start over. You can save your query as a URL for later use or to put in an email to a colleague. For more information about sharing, go to Sharing a Query. You can filter (narrow) your search by Collections, Image Modality, Anatomical Site, Species, Date released, and Subject IDs. You can also specify the minimum number of image studies you want to match each search filter. For Collections, if you know the name of the collection, click The Simple Search page shows a summary of image studies that match your search criteria. Your selections appear in the following ways: The pie charts show the count of image studies in your search results by Collection, Image Modality, and Anatomical Site. Click a pie slice or hover over it to see the name of the Collection, Image Modality, or Anatomical Site, and number of each, in your search results. The Search Results tab shows the same results as the pie charts but in tabular form. Text searches involve entering any text that might appear in any search filter. Results are displayed in pie charts and a table, just as with the simple search. You can search and download public data without logging in to the TCIA Data Portal. To access restricted data, however, you must log in first to see that data in your search results. Consult the TCIA Collections page to learn which collections have limited access. To perform a simple search Select filters to narrow down the available image series. Option 1: Click the box next to each collection name you want to select. Option 2: Click the magnifying glass to enter a name. Click the box next to one or more image modalities. Click the box next to each anatomical site you want to select. Click the box next to the species you want your search results to represent, either human or Mus musculus (mouse). Enter the minimum number of time points that match the criteria of your search. This filter allows you to see subjects that have more than one DICOM study (that is, the patient was seen at multiple time points). Enter a From and To date to narrow your search results to studies that TCIA first made available during that date range. Alternately, select the Apply "Available" date range box to exclude studies that were unavailable to TCIA during the selected date range. Click the Enter Subject IDs associated with the image series you want to receive in your search results. Separate each Subject ID with a comma and then click Apply Subject IDs. The Summary tab shows updated pie charts and the number of image series in the search results. The text search does have some restrictions. These are: To perform a text search On the TCIA home page, click Text Search or Search Images > Text Search. Click Navigation Tips The following table describes each item in the search results table. Click the Subject ID to view all study images for this subject in a DICOM web viewer, a single series' thumbnails, or the DICOM header for the first image in the series. See Search Results (Studies for Subject). The field in the study where the text string you entered as your search criteria appears The search results from your query are presented both on the Summary tab in pie charts and on the Search Results tab in a table. Each record in the table corresponds to one subject (patient) and displays the collection(s), study(ies), and image series associated with that subject. From the Search Results tab, you can view subject details, view all image series associated with the subject, and add image series to your cart for download. You can also view the DICOM header for a selected image series. In the future, you will be able to view the image. To view subject details Click a Subject ID link. The red asterisk indicates that the date, which is the date that this series was first available at TCIA, has been offset to protect private health information. You can view thumbnails of all images in the selected series and then open selected images for further analysis in another image system. To view thumbnails Digital Imaging and Communications in Medicine (DICOM) is a standard for handling, storing, printing, and transmitting information in medical imaging. You can view the DICOM tags that form the header of the selected image series. To view DICOM data You can download items you add during the current work session. Before you download items you must download and then install the NBIA Data Retriever. You select items to download by first searching for them in TCIA and then adding them to your cart. Your cart is a holding place for data you have selected to download. You can add all image series associated with a subject, all image series associated with a study, or one or more selected image series to your cart. To add all image series associated with a subject to the cart Click the cart icon in the row of one or more subjects. To remove all of the data associated with this subject from the cart, click the cart icon again. To add all image series associated with a study to the cart Click the cart icon next to one or more studies. The cart icon in the study row turns green. If you did not select all of the studies associated with the subject, the cart icon in the subject row turns yellow. The cart itself, in the upper-right of the window, shows how many image series are in it and how large the download will be. To remove all of the data associated with this subject from the cart, click the cart icon again. To add one or more image series to the cart The most convenient method of downloading is by using the NBIA Data Retriever. You must install the NBIA Data Retriever before you begin downloading. You only have to install it once to use it in future downloading sessions. Click one of the following links to download the NBIA Data Retriever for that operating system. Consult the NBIA Data Retriever FAQ for more information about NBIA Data Retriever versions and usage. To install the NBIA Data Retriever on Windows To install the NBIA Data Retriever on Mac 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 Downloader App. 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. On your Mac, find the NBIA Data Retriever on the Mac App Store. 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. To install the NBIA Data Retriever on Linux (centOS or Ubuntu) You must have the sudo privilege on your computer and a sudo password to install the NBIA Data Retriever on CentOS and Ubuntu. You can share the manifest file with collaborators, so that they can download the same images that you have added to your cart. Collaborators must also install the NBIA Data Retriever to open the manifest file. If you want to share a manifest file that includes links to private image collections, you must first manually install the latest NBIA Data Retriever. The latest version of the NBIA Data Retriever controls access to private collections. In addition, your collaborators must have the same access to those private collections as you do. Otherwise, your collaborators will not be able to download images from those collections. To download images using the NBIA Data Retriever Open the The NBIA Data Retriever lists all items you selected in the cart. 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 cart. Click Browse to navigate to the destination where you want the images/annotations to be downloaded. 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 Network Error? If network errors occur during large downloads, the NBIA Data Retriever retries downloading the series in the manifest file the number of times that your administrator has configured. The default is four times. After the automatic retries, you have the option of saving an error report, which you can share with the TCIA help desk, or of retrying just the failed series. You can save your query for later use or share it with a colleague by email. To share a query Paste the URL into an email or other document. Shared queries honor data permissions that may exist. Each person that runs the shared query will only see search results that he or she is allowed to see. Once you have added data to your cart, you can share it as a URL to a static set of data. When you or a colleague opens the URL in a browser window, the new TCIA Graphical User Interface (GUI) opens to the cart page. In the legacy TCIA data portal, this was called a shared list. This is a similar concept in the new TCIA GUI. To share data in your cart The shared cart honors data permissions that may exist. Each person that opens the shared cart will only see data that that person is allowed to see.Topics on this page describe how to search the local and remote image databases for images.Introduction to the TCIA Data Portal
Browser Support
Searching for Image Studies
You can search and download public data without logging in to the TCIA Data Portal. To access restricted data, however, you must log in first to see that data in your search results.
to enter it instead of finding and clicking the collection's box.
Accessing Limited-Access Collections
.
The Login window appears.
Performing a Simple Search
A simple search allows you to search for image studies based on a combination of the following search filters: Collections, Image Modality, Anatomical Site, Species, Date released on TCIA, and Subject IDs. The more criteria you select, the fewer results you receive. After you select your search criteria, you can save your query to use later.
The Simple Search page appears.
To Select Do This Collections 
Image Modality
If you select more than one image modality, clicking ANY will returns any study that is associated with any of the modalities you selected. Clicking ALL returns all studies that are associated with all of the modalities you selected.
Anatomical Site 
Species 
At least X time point (DICOM studies) 
Date released 
button to return the dates to the default date range.
Subject IDs 
Click the Search Results tab for more detailed results.Performing a Text Search
A text search allows for searching of many of the database text fields, DICOM image tag data, and annotation files that are not available in the Simple search. Refer to the DICOM Data Dictionary for tags or field names you can use in a text search. A simple example of a text search is to find all subjects associated with the value pancreas by typing pancreas in the Text Search box. You can also use the field:searchTerm technique; for example, Body Part Examined:pancreas. In this example, the colon interprets the DICOM field from the value. Since text search also recognizes DICOM codes, you can also search on 0018,0015:pancreas, which is the DICOM code for Body Part Examined. Additionally, you can use a wildcard search such as Body Part Examined:panc* to find all subjects associated with values beginning with panc, including pancreas, pancreatic duct, and pancreatic duct and bile duct systems.
The Text Search page appears.
.
The search results appear.
Search Result Description 
Click the caret to view the subject details. Click the cart symbol to add image series to your cart. Collection ID Collection identifier Subject ID Hit Viewing Subject Details
The Summary tab refreshes to show your search results in pie chart form.
The search results that match your criteria appear sorted by Subject ID.
You can now add all studies associated with a subject to your cart at the same time or drill down to an individual study and add it to your cart instead.
All studies associated with this subject appear. In this example, this subject is only associated with one study, and only one image series is associated with that study.
All of the image series associated with that study appear.
You can nowViewing Thumbnails of the Image Series
.
Thumbnails of all of the images in the selected image series appear.
Follow your browser's instructions to open or save the file.
Viewing DICOM Data
.
The DICOM tags associated with the image series appear.
Downloading Study Data
Adding Data to the Cart
The cart icon turns green and the number of image series now in your cart appears next to the cart. The cart itself, in the upper-right of the window, shows how many image series are in it and how large the download will be.
All of the studies associated with this subject appear.
All of the image series in the selected studies are added to the cart.
The cart icon you select turns green.
The cart icon for the subject turns yellow, indicating that you have not selected all available series for this subject.
Downloading the NBIA Data Retriever
After you search for images of interest and add them to your data basket, you can download them.Get the NBIA Data Retriever
To run this file, type the following at the command prompt (assuming you installed TCIADownloader previously):sudo yum -v -y remove TCIADownloader.x86_64;sudo yum -y install NBIADataRetriever-3.4-1.x86_64.rpm
To run this file, type the following at the command prompt (assuming you installed tciadownloader previously):sudo -S dpkg -r tciadownloader;sudo -S dpkg -i nbia-data-retriever-3.4.debInstalling the NBIA Data Retriever
The app starts downloading to your Mac. When the download is complete, you can open a manifest file with the NBIA Data Retriever.sudo yum -v -y remove TCIADownloader.x86_64;sudo yum -y install NBIADataRetriever-3.3-1.x86_64.rpmsudo -S dpkg -r tciadownloader;sudo -S dpkg -i nbia-data-retriever-3.3.deb
Enter the sudo password when prompted.Downloading Images Using the NBIA Data Retriever
When you download images you have added to your cart, TCIA provides a list of these images in a manifest file (manifest-xxx.tcia). You must have already installed the NBIA Data Retriever to open this manifest file and download the images.
.
The cart contents appear.
.
A message appears reminding you to download the NBIA Data Retriever. If you have already downloaded it, click Do not show this message again and click . Otherwise, click 
to go to a page with links for downloads for each operating system.
manifest-xxx.tcia file.
The NBIA Data Retriever appears, with the items you added to your cart in the Downloads table.
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.
Sharing a Query
and then select Share my query.
The Query URL box appears.
The URL copies into your Clipboard.Sharing Data in Your Cart
and then select Share My Cart.
The Retrieve Cart Data URL box appears.
The URL copies into your Clipboard.
Overview
Content Tools