NIH | National Cancer Institute | NCI Wiki  

Versions Compared

Key

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

Topics on this page describe how to use the National Biomedical Imaging Archive (NBIA) Data Radiology Portal to search local and remote image databases for radiologic images.

Tip

You can print and export this user guide.

Introduction to the NBIA

...

Radiology Portal

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

...

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 Radiology Portal. To access restricted data, however, you must log in first to see that data in your search results.

TCIA provides two ways to search for image studies:

When you first open the NBIA Data Radiology Portal, the Summary tab displays filters for a simple search and pie charts showing counts of collections, image modalities, and anatomical sites in the database. Each pie "slice" is a filter you can use to narrow the data in the portal. Hover over a pie chart slice to view the name of each filter. The size of each pie slice is relative to the size of that filter's representation in the database. 

TCIA Simple Search page with Simple Search options and Summary tab visible

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 and NBIA Data Portal User Guide Sharing a Query and Sharing Data in Your Cart.

You can narrow your search by the following filters:

...

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

...

Creating a

...

TCIA Account

To create a new account, do the following.

  1. Go to the Legal Framework and Ethical Use of This Resource page to accept the terms. 
  2. Read all of the content on the page and then click the CLICKING HERE link at the bottom.
    Image Added
    The New User Registration page appears. 
    Image Added
  3. Complete the form and click Create.

For username and password help, go to TCIA Account Help.

Note

Sometimes, if you emailed the helpdesk before you create your TCIA account, you won’t be able to create a new TCIA account using that same email on your own. Often the solution is to use the “forgot password” link and then you can proceed.

If that does not work, contact help@cancerimagingarchive.net with the subject line Account Creation - email taken.

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, Phantoms, Third-Party Analysis Results, Date released on TCIA, and Subject IDs. The more criteria you select, the fewer results you receive. 

To perform a simple search

  1. On the TCIA home page, click the Simple Search tab.
    The Simple Search page appears.
    TCIA Simple Search page with Simple Search options and Summary tab visibleImage Added
  2. Select filters to narrow down the available image series.

    To SelectDo This

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, Phantoms, Third-Party Analysis Results, Date released on TCIA, and Subject IDs. The more criteria you select, the fewer results you receive. 

To perform a simple search

  1. On the TCIA home page, click the Simple Search tab.
    The Simple Search page appears.
    TCIA Simple Search page with Simple Search options and Summary tab visibleImage Removed
  2. Select filters to narrow down the available image series.

    Option 1: Click the box next to each collection name you want to select.

    4D-Lung Collection selected


    To SelectDo This

    Collections

    Anchor
    Collections
    Collections

    Collections

    Anchor
    CollectionsCollections
    Tip

    Hovering over a collection name opens a window with information about the collection in it. Quickly move your mouse to this window, where you can select text and click links. The window stays open until you move your mouse away from it. 

    4D-Lung This data collection consists of images acquired during chemoradiotherapy of 20 locally-advanced, non-small cell lung cancer patients. The images include four-dimensional (4D) fan beam (4D-FBCT) and 4D cone beam CT (4D-CBCT). All patients underwent concurrent radiochemotherapy to a total dose of 64.8-70 Gy using daily 1.8 or 2 Gy fractions.  A single Radiation Oncologist delineated targets and organs at risk in all 4D-FBCT and a limited number of 4D-CBCT images. All patients underwent concurrent radiochemotherapy to a total dose of 64.8-70 Gy using daily 1.8 or 2 Gy fractions.  Please see the 4D-Lung wiki page to learn more about the images and to obtain any supporting metadata for this collection.


    Option 2: Click the magnifying glass to enter a name.
    Collections filter highlighting the search box and magnifying glass

    Image Modality 

    Anchor
    imagemodality
    imagemodality

    Click the box next to one or more image modalities.

    If you select more than one image modality, clicking ANY 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.

    Note

    When you select the ANY search modifier here, only the studies that match your search criteria are returned. Be aware that these may be only be a subset of the studies belonging to a single subject (patient). The potential difference between total studies available and the number of studies returned by your search  becomes clearer when you select the Total Studies and Total Series columns to appear in your search results. To do so, click at the top of the Search Results tab. Select Total Studies and Total Series in the Pick Columns list.

    Pick columns list of choices, which includes Cart, Collection ID, Subject ID, Studies, Total Studies, Series, and Total Series.

    Checklist of image modalities with CT selected

    Anatomical Site

    Anchor
    Anatomical Site
    Anatomical Site

     Click the box next to each anatomical site you want to select. Click alpha or num to sort the list alphabetically or numerically. Select Not Specified to find data for which the BodyPartExamined field is empty. 

    Checklist of anatomical sites, highlighting Brain

    Species

    Anchor
    species
    species

    Click the box next to the species you want your search results to represent, either human or Mus musculus (mouse).

    Phantoms

    Anchor
    phantoms
    phantoms

    Click the box next to the phantom option you want to select.

    Phantoms search filter. Options are Only Phantoms, Exclude Phantoms, and Include Phantoms.

    3rd-Party Analysis Results

    Anchor
    3rdparty
    3rdparty

    Third-party analysis results are derived data (e.g. segmentations) that were contributed by researchers who were not part of the group that originally submitted a collection to TCIA. To enhance the value of TCIA collections, TCIA encourages the research community to publish their analyses of existing TCIA image collections. Examples of this kind of data includes radiologist or pathologist annotations, image classifications, segmentations, radiomics features, or derived/reprocessed images.

    Click the box next to each third-party analysis results option you want to select. Only DICOM data from third-party analysis results appear when using this search filter. A full listing of all third-party analysis data inclusive of non-DICOM formats appears in the Analysis Results Directory

    Clinical Time Points

    Anchor
    Clinical Time Points
    Clinical Time Points

    Some datasets encode Clinical Time Point information in the image metadata. This filter allows you to refine search results based on how many days have passed since a particular clinical event occurred when these metadata are included by the data submitter (e.g. "Days since diagnosis"). Click select to view the types that are available in the database, plus their available date range. In the from and to boxes, enter numbers that correspond to the range of days from and to that time point.

    Exclude collections with commercial use restrictions

    Anchor
    Commercial Use Restrictions
    Commercial Use Restrictions

    TCIA supports collections with different types of licenses. Some licenses prohibit the commercial use of the collection. You can filter your search results to exclude those collections that have commercial use restrictions.

    At least X time point (DICOM studies)

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

    At least X (number) time point (DICOM studies) field

    Date Released


    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 Arrow turning in a counter-clockwise direction button to return the dates to the default date range.

    Date Released search filter

    Subject IDs

    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.

    Subject IDs text box

  • Select which columns you want to have appear in the detailed search results on the Search Results tab by clicking at the top of the Search Results tab. The Pick Columns panel appears. 

    Pick columns list of choices, which includes Cart, Collection ID, Subject ID, Studies, Total Studies, Series, and Total Series.

    Search results are shown in two different ways, as a summary and as detailed search results, and which one appears first matches your last choice. The Summary tab shows updated pie charts and the number of image series in the search results.
    Summary tab showing pie charts
    Click the Search Results tab for more detailed results.
  • 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.

    ...

    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

      Info
      titleNavigation 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. See Search Results (Studies for Subject).

      Hit

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

    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.

    ...

    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.

      Note

      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.

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

    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 Removed.
      Access thumbnails with Thumbnail iconImage Removed
      Thumbnails of all of the images in the selected image series appear.
      Thumbnails of all images in a selected image seriesImage Removed
    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 Removed

    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. 

    1. sorted by Subject ID.

      Note

      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.

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

      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.

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

    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 thumbnailsTo 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.Image Removed
    3. Select a study and view its details.
    4. In the row for an image series, clickOHIF Viewer tool buttonImage Removed.
      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.Image RemovedClick Play button from the OHIF ViewerImage Removedto display click Thumbnail iconImage Added.
      Access thumbnails with Thumbnail iconImage Added
      Thumbnails of all of the images in the selected image series sequentiallyappear.

    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.

    1. Thumbnails of all images in a selected image seriesImage Added
    2. 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 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 collectionTo view DICOM data

    1. View the details for a subject.Select a study and view its details..
    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.Image Added
    3. In the row for an image series, click Image RemovedclickOHIF Viewer tool buttonImage Added.
      The DICOM tags associated with the image series appear.
      DICOM Tags for ImageImage Removed

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

    The following topics are in this section:

    ...

    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. 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.Image Added
    2. Click Play button from the OHIF ViewerImage Addedto display the images in the series sequentially.

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

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

    Adding Data to the Cart

    ...

    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 Modified

    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 Modified


    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 Modified

    Include Page
    Downloading NBIA Images

    ...

    8.

    ...

    0
    Downloading NBIA Images

    ...

    8.0

    The following topics are in this section:


    Return to top of page

    Exporting Data to a Spreadsheet

    Once data is in your cart, you can export it to a Comma-Delimited Values (CSV)-format spreadsheet for analysis or sharing with others.

    ...

    • Add data to your cart.
    • Click Cart button with 25GB label.
      The cart appears.
      TCIA cart page showing 1-10 of 740 series in the cart.
    • Click Export Spreadsheet button.
      A CSV file called "metadata" opens in your browser. This file provides an overview of the downloaded files. 
      Manifest folder tree, which includes two folders called 4D-Lung and LCTSC and an Excel file called metadata.
      Metadata file in the manifest folder

      This file includes the following columns: 
      • Series Instance UID
      • Collection
      • 3rd Party Analysis
      • Data Description URI
      • Subject ID
      • Study UID
      • Study Description
      • Study Date
      • Series Description
      • Modality
      • Manufacturer
      • SOP Class Name
      • SOP Class UID
      • Number of Images
      • File size
      • File Location
      • Download Time Stamp

        Metadata file for selected images in the 4D-Lung collection
        Metadata file opened in Microsoft Excel

    Return to top of page

    Sharing a Query

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

    ...

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

    ...

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