You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 48 Next »

Topics on this page describe how to search the local and remote image databases for images.

You can print and export wiki pages.

Topics in this chapter include:

What's New in the TCIA Data Portal

Unable to render {include} The included page could not be found.

Introduction to the TCIA Data Portal

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.

Return to top of page

Browser Support

TCIA supports the latest versions of Google Chrome and Mozilla Firefox browsers.

Return to top of page

Searching for Image Studies

Unable to render {include} The included page could not be found.

Return to top of page

Accessing Limited-Access Collections

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.

  1. In the top menu bar, click Login Button.
    The Login window appears.
    Login window
  2. Enter your user name and password, then click Log In.

Performing a Simple Search

Unable to render {include} The included page could not be found.

Return to top of page

Performing a Text Search

A text search allows you to query many of the database fields, DICOM image tag data and their values, and annotation files that are not available in the Simple search. You can also use the text search to query for content of DICOM Structured Reports (DICOM SR) and strains from mouse and rat collections. Refer to the DICOM Data Dictionary for tags or field names you can use in a text search and Structure of DICOM SR Documents for a description of the fields in a DICOM SR.

DICOM Examples

  • Enter pancreas in the Text Search box and find all subjects associated with the value pancreas.
  • Query using the attribute:searchTerm technique: for example, Body Part Examined:pancreas. In this example, the colon interprets the DICOM field from the value.
  • Query by DICOM codes, such as 0018,0015:pancreas. 0018,0015 is the DICOM code for Body Part Examined.
  • Query by DICOM SR attributes, such as 0008,0104 for Code Meaning. Entering 0008,0104:tonsil, returns all subjects with a Code Meaning that includes the word "tonsil," and 0008,0104:tonsil adenoid returns all subjects with a Code Meaning that includes both "tonsil" and "adenoid." 
  • 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.

Examples for Strains

  • Query for the strain name or parts of the strain name or use a value name pair to construct the query. You can query by the Mouse Genome Informatics (MGI) number or query for MGI in the coding scheme designator field. Examples follow.
  • Strain Description (0010,0212) = "NOD.Cg-Prkdc<scid> Il2rg<tm1Wjl>/SzJ"
  • Strain Nomenclature (0010,0213) = "MGI_2013"
  • Strain Code Sequence (0010,0219):
    •  Code Value (0008,0100) = "3577020"
    •  Coding Scheme Designator (0008,0102) = "MGI"
    •  Code Meaning I0008,0103) = "NOD.Cg-Prkdc<scid> Il2rg<tm1Wjl>/SzJ"

The text search does have some restrictions. These are:

  • The text string you use must have more than one character. The search won't return any values if the text string has only one character.
  • Do not use a forward slash (/) in your text string.
  • Do not use complex searches with AND or OR statements (text search supports Lucene syntax but only a single field can be searched at a time).

To perform a text search

  1. On the TCIA home page, click Text Search or Search Images > Text Search.
    The Text Search page appears.

    Text Search tab with an empty text box, Clear button, and Search button

  2. In the Text Search box, enter a text string of two characters or more.
  3. Click Search button.
    The search results appear.
    TCIA text search results on the term glioma

    Navigation Tips

    • Click the down arrow next to the Subject ID column header to sort the results alphabetically (A to Z or Z to A) by Subject ID.
    • Click the arrows at the bottom of the table to display the first, previous, next, or last page of results.
    • Click the page number links to move to a specific page of results.
    • In the Show (10) entries box in the bottom left, edit the default 10 to the number of entries you want to see on a search results page.

    The following table describes each item in the search results table.

    Search ResultDescription

    Caret symbol and cart symbol

    Click the caret to view the subject details. Click the cart symbol to add image series to your cart.
    Collection IDCollection identifier
    Subject ID

    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. 

    Hit

    The field in the study where the text string you entered as your search criteria appears.

Viewing Subject Details

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

  1. Search for studies that match criteria that interest you.
    The Summary tab refreshes to show your search results in pie chart form.
  2. Click the Search Results tab.
    The search results that match your criteria appear sorted by Subject ID.

    You can 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.

  3. Click a Subject ID link.
    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.

    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.

  4. Click the date or the arrow to the left of the study cart icon to view details about the selected study.
    All of the image series associated with that study appear.

    You can now:

Return to top of page

Viewing Thumbnails of the Image Series

Unable to render {include} The included page could not be found.

Return to top of page

Viewing DICOM Data

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

  1. View the details for a subject.
  2. Select a study and view its details.
  3. In the row for an image series, click DICOM button.
    The DICOM tags associated with the image series appear.
    DICOM Tags for Image

Return to top of page

Viewing TCIA Collections

You can visualize TCIA collections before you download them by launching an image animation when there are more than two images in the series. 

To view a TCIA collection

  1. View the details for a subject.
  2. Click the study date link for the collection you want to view.
    The image series associated with this study appear.
    Series detail for one study, showing the thumbnails, image animation, and DICOM buttons.
  3. In the row for an image series, clickOHIF Viewer tool button.
    The images in the series open in the Open Health Imaging Foundation (OHIF) Viewer.
    OHIF Viewer TCIA Alpha showing a toolbar, an overview image, and a large, main image window.
  4. Click Play button from the OHIF Viewerto display the images in the series sequentially.

Return to top of page

Downloading Study 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.

You can also export data in your cart to a spreadsheet.

Adding Data to the 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 subjects to the cart

  1. Search for the subject.
  2. Click the Search Results tab.
  3. Click the subject cart icon in the row of one or more subjects. This selects all studies associated with each subject.
    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 large the download will be.

    To remove all of the data associated with this subject from the cart, click the cart icon again.


    Search results tab showing all image series associated with the subject selected. One subject is selected and so has a green icon.

To add selected studies to the cart

  1. Search for the subject.
  2. Click the Search Results tab.
  3. Click a Subject ID link or click the arrow to the left of the subject cart to open all series associated with that subject.
  4. Click the cart icon for one or more series.
    • The study cart icons you select turn green.
    • The subject cart icon for the subject turns yellow, indicating that you have not selected all available studies for this subject.

      Search results screen showing what has been put into the cart. Two studies from one subject have been selected. Partial selections are yellow and full selections are green.

To add selected series to the cart

  1. Search for the subject.
  2. Click the Search Results tab.
  3. Click a Subject ID link or click the arrow to the left of the subject cart to open all series associated with that subject.
  4. Click a study date link or click the arrow to the left of the study cart to open all the series associated with that study.
  5. Click the cart icon for one or more series.
    • The series cart icons you select turn green.
    • The study cart icon for the subject turns yellow, indicating that you have not selected all available series for this study.
    • The subject cart icon for the subject turns yellow, indicating that you have not selected all available studies and series for this subject.

      Search results screen showing what has been put into the cart. Two series from one study have been selected. Partial selections are yellow and full selections are green.

Return to top of page

Downloading the NBIA Data Retriever

Unable to render {include} The included page could not be found.

Installing the NBIA Data Retriever

To install the NBIA Data Retriever on Windows

  1. Download the installer package for Windows using the Windows 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

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.

  1. 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.

  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 Ubuntu)

You must have the sudo privilege on your computer and a sudo password to install 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.

Downloading Images Using the NBIA Data Retriever

Unable to render {include} The included page could not be found.

Exporting the Cart to a Spreadsheet

Unable to render {include} The included page could not be found.

Sharing a Query

You can save your query for later use or share it with a colleague by email.

To share a query

  1. In the top menu bar, click Share button and then select Share my query.
    The Query URL box appears.

    Query URL message box that provides the URL you can share with others that contains your query
  2. Click Copy URL.
    The URL copies into your Clipboard.
  3. 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.

Return to top of page

Sharing Data in Your Cart

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

  1. Add data to your cart.
  2. In the top menu bar, click Share button and then select Share My Cart.
    The Retrieve Cart Data URL box appears.

    Cart Data URL message box showing the URL where you can access or share your cart data
  3. Click Copy URL.
    The URL copies into your Clipboard.
  4. Paste the URL into an email or other document.

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.

Return to top of page

  • No labels