NIH | National Cancer Institute | NCI Wiki  

Versions Compared

Key

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

The purpose of this page is to serve as a beginner's guide to Clinical Trials Processor (CTP) with particular emphasis on internal de-identification of DICOM images and submission of this data to an instance of NBIA or XNAT. If you are already familiar with how CTP works and just want help with configuring it please proceed to the Example CTP use cases and configuration files page.

 Note: It This page is currently a work in progress.  This note will be removed once documentation is considered mostly complete.   Considering breaking up the "Getting started" page from the "Examples" page so that there's not as much information to absorb on a single page.

Overview

The basic outline of steps required to utilize CTP include:

...

  1. Java 1.5 (or better) JRE must be present on the system. Java 1.6 is recommended.  Note that only the JRE is required, not the JDK, and therefore this is already installed on most typical computers.
  2. If you wish to utilize some of CTP's advanced functionality you must also install the Java Advanced Imaging ImageIO Tools.
    1. Note that this is not required if all you wish to do is use CTP to de-identify DICOM images or submit de-identified images to NBIA. These tools are required if you want to use CTP to view images, or to create JPG thumbnails during the processing pipeline.
    2. Installation of the ImageIO tools in Linux requires some additional steps not outlined in Sun's installation instructions. See this page insert link for more information.

2. Installing CTP

Downloading CTP

...

Full details relating to how each of these can be customized along with the other export methods can be found on the RSNA wiki in the Export Services section and the Storage Service section respectively.

Example use cases and configuration files

The goal of this section is to provide the necessary configuration file, de-identification scripts, and filters that a user would need for common use cases.

De-identification scripts

The first decision you must make is how aggressively to de-identify your images. Supplement 142 has recently been approved by the DICOM Standards Committee as the standard for safely de-identifying DICOM image data while providing flexibility for scenarios which necessitate preservation of certain information needed for quality control and analysis. This is achieved by providing a number of Application Level Confidentiality Profiles which includes a Basic Profile along with a number of Option Profiles. These profiles provide the necessary instructions for how to safely clean DICOM elements which may contain PHI.

Since the early draft stages of Supplement 142's development there has been an effort to integrate its guidance into CTP. Below you will find a list of common de-identification scripts based on Supplement 142 which are ready to use in CTP. The full document as generated by DICOM Working Group 18 can be obtained here: ftp://medical.nema.org/medical/dicom/Final/sup142_ft.pdf

  1. Basic Application Confidentiality Profile - INSERT SCRIPT LINK - This is the most aggressive de-identification settings from S142 and is intended to remove any potential PHI from DICOM headers.
  2. Basic Profile + Retain Longitudinal Temporal Information with Modified Dates - INSERT SCRIPT LINK - Implements everything that is in the Basic Profile, except instead of removing the date related elements completely they are modified by some user selected number of days to provide protection against identifying patients, yet retaining the relative time between image studies to allow for research that requires this longitudinal information.

Using CTP for local de-identification

  • running the jar file
  • sending your source data to CTP
    • Archive Import
    • File Sender
    • PACS
  • going to the browser
  • viewing status page
  • troubleshooting
    • quarantines
    • log files

Sample config.xml: LocalDeId-config.xml

Using CTP to submit to NBIA

There are two common ways which you may wish to configure CTP to send data to NBIA.

  1. De-identification with local QC review - This is useful if the submitter wishes to do their own review of the de-identified data prior to providing it to the NBIA host. The NBIA host can subsequently choose to perform additional quality control reviews when the data reaches their server.
  2. De-identification with central NBIA QC review - This is useful if the group performing the submission is the same as the people managing the NBIA server. In this scenario the users can leverage NBIA's built in quality control tools to review the data before making it "visible" to end users of the NBIA site.

Sample configurations for both scenarios are described below, along with pointers to which information will need to be filled in based on your particular use case.

De-identification with local QC review

Sample config.xml: LocalDeId-NBIA-config.xml

Customizations required for use:

De-identification with central NBIA QC review

Sample config.xml: LocalDeId-Automated-NBIA-config.xml

    • follow CTP installation steps above
    • utilize/tweak NBIA centric config.xml (provide link)
  • Submitting to NBIA after local de-identification
    • editing your existing config.xml to add an NBIA export service
    • sending your de-identified data to the export service

Using CTP to submit to XNAT

Sample config.xml: (still needs to be written)

...

  • follow CTP installation steps above
  • utilize/tweak XNAT centric config.xml (provide link)

...