This guide explains how to use the features on the Data Admin tab of the TCIA Radiology Portal. Curators use the Perform Quality Control feature to work with images that are not yet available to the public.

What's New in the Data Administration Tool (August 2021)

Perform Quality Control

Understand QC Search Results

After you search for the series to QC, you can do the following on the search results page.

View Image Series

Your search results appear in a table at the top of the page. You can view a selected image series in thumbnails, in the OHIF viewer, or in cine mode. 

Perform Quality Control page with the first page of series found in the search results

Viewing Thumbnails

In the View column, click the magnifying glass icon to view thumbnails of each image in the series.

23 brain images in thumbnail view.

Viewing in the OHIF Viewer

In the View column, click the movie camera icon OHIF Viewer icon to view the series in the Open Health Imaging Foundation (OHIF) Viewer. 

OHIF Viewer TCIA Alpha showing a toolbar, an overview image, and a large, main image window.

Click Play button from the OHIF Viewerto display the images in the series sequentially.

Note that ultrasound images can only be viewed as thumbnails or in cine mode.

Viewing in Cine Mode

In the view column, click the eye icon Cine mode icon to view the series in cine mode, which provides an animated slideshow of the images in the series. The DICOM tags are unique for each image in the series. Cine mode is available when the series has more than one image and DICOM tags are available for each image.

As soon as one series plays in cine mode, the first image in the next series loads immediately so that you can review series in sequence more easily.

An image series in cine mode showing a single image in the main content area with controls below. The controls include the number of the image and the total number of images in the series (such as 1 of 60), various arrow controls (double and single right and left arrows and a pause button), and the frames per second of the animation, which can be edited.

Below the image are the image controls. You can enter an image number in the first box to view a specific image, or you can view the images in a series by pressing the play button, which is the single right arrow. Use the other arrows as follows.

Animation ControlAction

Vertical line and double arrow left icon

Return to the first image in the series

Vertical line and single arrow left icon

Return to the previous image in the series

Single arrow left icon

Play animation backwards

Pause button with two vertical lines

Pause

Single arrow right icon

Play animation forwards

Single arrow right icon followed by a vertical line icon

Progress forwards to the next image in the series

Double arrow right followed by vertical line icon

Progress forwards to the last image in the series

The box on the right shows the frames per second, which is the speed in which the images progress during the animation. The default is 15 frames per second and you can enter another number in this box to change the speed.

Assign a New QC Status

As a curator, you may need to assign a new QC status of one or more images or image series. You can assign the status of one or more selected images or image series individually or as a batch update. 

  1. Search for the series to QC. For example, search on Not Yet Reviewed to find series without a QC status.
  2. Select the series for which you want to assign the status by clicking the box to the left of its row in the search results. You can select more than one if you want to apply the same change to each series you select. To select all series for the selected collection(s), click the box in the top left.
  3. In the New Status section, select the status options you want to apply to this series. Refer to the descriptions of the search filters
    New Status section of the Perform Quality Control page. Options exist for selecting the specific status, batch number, confirmed as complete, released, and change log. Buttons below include Update, QC Status History Report, and Download.
  4. Enter text into the change log box to track why you made the change.  This text will be part of the QC Status History Report that you can generate to track changes in visibility.
  5. Click Update button.

Change QC Status

You can also change the QC status of one or more images or image series. 

  1. Search for the series to QC
  2. View the series in cine mode.
  3. In the Change QC Status section, select the status options you want to apply to this series. Refer to the descriptions of the search filters
    Change QC Status section of the Perform Quality Control window
  4. Enter text into the change log box to track why you made the change.  This text will be part of the QC Status History Report that you can generate to track changes in visibility.
  5. To save the update and move to the next series, click . Or to skip this series without making an update and move to the next series, click .

Generate a QC Status History Report

To view the status change log, search for the series you want to appear in the report, click the box to the left of that/those series, and then click QC Status History Report button.

The QC Status History report appears, displaying all changes that have been made to the status of the series you selected.

Download QC Data

To download data, search for the series you want to download, click the box(es) to the left of that/those series, and then click Download button.

A file appears in your browser that you can download to your computer.

Approve Deletions

TCIA role required to use this feature: NCIA.SUPER_CURATOR

For more information about roles, see Creating a New NBIA User.

This function is part of a two-tier deletion process. A super-curator can approve the deletion of image series that have been identified as "To be deleted" in the Perform Quality Control tool. After you approve an image series for deletion, you can either wait for the next scheduled system-wide deletion job or you can immediately remove image series that are approved for deletion.

To approve series deletions, follow these steps. Prior to approving deletions, you must assign the QC status of "To be deleted" to one or more series in the Perform Quality Control tool.

  1. Click Admin > Approve Deletions.
    The Approve Deletions page appears.
  2. Select filters to help you locate the series you have previously marked for deletion. Options for doing this follow.

    CriteriaDescription
    CollectionYou can only search on one collection (site) at a time.
    Released

    Limit your search to image series that have either been released or not. Click Ignore not to consider Released status at all in your search. 

    Batch NumberIn the Batch Number box, enter the batch number of the images/series you want to find.
    Confirmed as Complete

    Select Yes to search for a set of images/series that has been confirmed as complete, No to search for a set of images/series that is ongoing, or No Change to not consider this field when searching.

    Subject ID

    Separate multiple Subject IDs with commas and then select Apply Subject IDs button to perform the search. 

    Most Recent SubmissionIn the From and To boxes, enter the most recent series submission date range by selecting a date in the calendar or by using the format mm/dd/yyyy.

    Using your filter selections, TCIA searches for image series that you have marked for deletion and refreshes the page to show those series. You may have to scroll both horizontally and vertically to view all series information and options.

    Approve Deletions page with one series available to approve for deletion

    Expand the table to see more rows. To do so, scroll horizontally until you see the two diagonal lines in the lower-right corner. Click and drag that corner until the table expands to your desired height.

    The search results table on the Perform QC page, extended horizontally to show the corner you can click and drag to expand the height of the table.


  3. Select the box in the row of the series you want to delete. You may select more than one.
  4. Optionally, add text to the change log to explain why you are deleting the series. This text appears in your QC Status History Report.
  5. Click Delete buttonto approve the deletion. 

Image series you approve for deletion are still visible in the system and identified as "To Be Deleted". They are removed from the system at a system-configured time, such as at midnight (called an "offline deletion"), unless you perform a manual deletion (called an "online deletion").

  • After an image series is approved for deletion, the action cannot be reversed.
  • Any new image submissions to a series identified "To be deleted" will be successful, but the status of the series does not change.
  • Images submitted to files that are identified as "Deleted" are quarantined.

Perform Online Deletions

TCIA role required to use this feature: NCIA.DELETE_ADMIN

For more information about roles, see Creating a New NBIA User.

This function is part of a two-tier deletion process. Using the Online Deletion feature, an administrator can delete image series that have been approved for deletion. This immediately removes images that are approved for deletion, rather than requiring the administrator to wait for the next scheduled system-wide deletion job.

Before you can use the Online Deletion feature, you must first approve image series for deletion.

To manually delete series, follow these steps:

  1. Click Admin > Perform Online Deletion.
    A list of image series that have been approved for deletion appears.
    Perform Online Deletion page showing one series that has been approved for deletion and a Delete button

  2. Click Delete buttonto delete the series immediately.

    All series listed in this page are deleted. You cannot select one series on the page for online deletion and not the others.


Edit Collection Descriptions

TCIA role required to use this feature: NCIA.MANAGE_COLLECTION_DESCRIPTION

For more information about roles, see Creating a New NBIA User.

Collection descriptions are uploaded along with image data. An administrator can edit these descriptions and change the license applied to the collection. Users view descriptions and license information when they hover over a collection name in the Simple Search area of the TCIA Radiology Portal.

To edit a collection description:

  1. Click Admin > Edit Collection Description.
    The Edit Collection Descriptions page appears.
    Edit Collection Descriptions page showing and editable description in both text and HTML, a license dropdown list, and a Save button.
  2. Select a collection name.
    The current collection description appears on the right in two editor options, text and HTML. 
  3. Edit the collection description. 
    The top editing window allows you to use familiar point-and-click text formatting options, while the bottom editing window allows you to edit using HTML.
  4. Change the license selection if needed.
  5. Click Save button.

Edit Collection License

TCIA role required to use this feature: NCIA.MANAGE_COLLECTION_DESCRIPTION

For more information about roles, see Creating a New NBIA User.

You can add or edit a collection license to your installation of the TCIA Radiology Portal. This license then becomes available to select while editing a collection description. Users view descriptions and license information when they hover over a collection name in the Simple Search area of the TCIA Radiology Portal.

To add a collection license:

  1. Click Admin > Edit Collection License.
    The Edit Collection Descriptions page appears.
  2. Click New button.
  3. Enter the long name, short name, and license URL for the new license.
  4. Select the appropriate button indicating that commercial use is or is not allowed for the new license.
  5. Click Add button.

To edit a collection license:

  1. Click Admin > Edit Collection License.
    The Edit Collection Descriptions page appears.
  2. Click the arrow next to the first license name on the left to open the list of licenses.
  3. Select the license you want to edit. 
    The names, URL, and commercial use selection appear on the right.
  4. Edit the information as needed and click Save button.
    or
    Delete the license from this installation by clicking Delete button.