NIH | National Cancer Institute | NCI Wiki  

Error rendering macro 'rw-search'

null

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

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

Tip

You can print and export this user guide.

Topics in this chapter include:

Table of Contents

Introduction to the NBIA Data Portal

NBIA Data Portal enables you to search for images in the local NBIA in vivo image repository. If available, you can also search remote imaging archives.

NBIA 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 NBIA 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

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

Return to top of page

Searching for Image Studies

You can search and download public data without logging in to the NBIA Data Portal. To access restricted data, however, you must log in first to see that data in your search results.

NBIA provides two ways to search for image studies:

When you first open NBIA Data Portal, the Summary tab displays filters for a simple search and pie charts.

Summary page that displays after logging inImage Added

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 NBIA Data Portal User Guide-deleteNBIA Data Portal User Guide-delete.

You can filter (narrow) your search by Collections, Image Modality, Anatomical Site, Species, Phantoms, 3rd-Party Analysis Results, 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 Magnifying glassImage Added to enter it instead of finding and clicking the collection's box.

The Simple Search page shows a summary of image studies that match your search criteria. Your selections appear in the following ways:

  • Boxes you selected are checked.
  • Pie charts update to show the exact search results.
  • Breadcrumb-style labels at the top of the page show the applied search filters (not all may display due to space constraints).
  • Count of search results appears.

Simple Search page with filters, Collections, and Image ModalitiesImage Added

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.

Count by Collections pie chart with Selected filter and Filter NameImage Added

The Search Results tab shows the same results as the pie charts but in tabular form.

Search results in tabular formatImage Added

Text searches involve entering any text that might appear in any search filter.

Text SearchImage Added

Results are displayed in pie charts and a table, just as with the simple search.

Accessing Limited-Access Collections

You can search and download public data without logging in to the NBIA 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 buttonImage Added.
    The Login window appears.
    Login windowImage Added
  2. Enter your user name and password, then click Log In.

Performing a Simple Search

Include Page
Performing a Simple Search 7.1
Performing a Simple Search 7.1

Performing a Text Search

Include Page
Performing a Text Search 7.0
Performing a Text Search 7.0

Return to top of page

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.
    Search results tableImage Added

    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.

  3. Click a Subject ID link.
    A list of 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.
    Subject details for selected subject, showing four studiesImage Added

    Tip

    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 arrow to the left of the cart icon to view details about the selected study.
    All of the image series associated with that study appear.
    Details about selected seriesImage Added

    You can now

Viewing Thumbnails of the Image Series

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

  1. View the details for a subject.
  2. Select a study and view its details.
  3. In the row for an image series, click Thumbnail iconImage Added.
    Access thumbnails with Thumbnail iconImage Added
    Thumbnails of all of the images in the selected image series appear.
    Thumbnails of all images in a selected image seriesImage Added
  4. Click any image to download it to your computer. 
    Follow your browser's instructions to open or save the file.
    File downloaded to Chrome, Show All buttonImage Added

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 Image Added.
    The DICOM tags associated with the image series appear.
    DICOM Tags for ImageImage Added

Return to top of page

Downloading NBIA Images

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 NBIA and then adding them to your cart.

The following topics are in this section:

Table of Content Zone
locationtop

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 image series associated with a subject to the cart

  1. Search for the subject.
  2. Click the Search Results tab.
  3. Click the cart icon in the row of one or more subjects.
    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.

    Info

    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 selectedImage Added

To add all image series associated with a study to the cart

  1. Search for the subject.
  2. Click the Search Results tab.
  3. Click a Subject ID link.
    All of the studies associated with this subject appear.
  4. Click the cart icon next to one or more studies.
    All of the image series in the selected studies are added to the cart.

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

      Info

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

      Search results tab showing two studies selectedImage Added


To add one or more image series to the cart

  1. Search for the subject.
  2. Click the Search Results tab.
  3. Click a Subject ID link to open all series associated with that subject.
  4. Click the cart icon for one or more series.
    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.
    Search results tab showing one image series selectedImage Added

Include Page
Downloading NBIA Images 7.1
Downloading NBIA Images 7.1


Return to top of page

Exporting Data to a Spreadsheet

Include Page
Exporting Data to a Spreadsheet 7.1
Exporting Data to a Spreadsheet 7.1

Return to top of page

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 buttonImage Added 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 queryImage Added
  2. Click Copy URL.
    The URL copies into your Clipboard.
  3. Paste the URL into an email or a document.

    Note

    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, NBIA opens to the cart page. 

In the legacy NBIA data portal, this was called a shared list. 

To share data in your cart

  1. Add data to your cart.
  2. In the top menu bar, click Share buttonImage Added 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 dataImage Added
  3. Click Copy URL.
    The URL copies into your Clipboard.
  4. Paste the URL into an email or a document.
Info

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