Child pages
  • Quick Start Guide: Using CTP and FileSender Software to Send Images to TCIA

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Panel
titleContents of this Page

Table of Contents

This guide is a quick start companion to the Image Submitter Site User's Guide.

...

title
Info

Although the examples in this guide are from a Windows computer, the steps are similar for other operating systems.

Panel

Contents of this Page

Table of Contents

Step 1 – Install CTP and FileSender

...

  1. You will receive an email inviting you to download a zip file

...

  1. . An example of the email

...

  1. follows.
    email to download zipped filesImage Added
  2. Click the link to start the download process.

...

 

-        Click the zip file name to begin the download.

 

 

...

  1. The page may read " We're sorry, we can't preview .zip files" that's fine, click the download button  as shown:
    zipfile download screen shotImage Added
  2. What you download is compressed. Right click (or apple-click) to choose “Extract” or “Unzip” the downloaded file to a folder where you have write access.

...

  1.  You might want to create a folder

...

  1. in the root directory, i.e. ‘C:\CTP’.

 

 

...

  1. Image Added
    Two folders are created. FileSender contains a way to

...

  1. queue DICOM files internally to CTP. CTP

...

  1. contains the anonymization and transmit-to-TCIA software.
    Image Added

 

 

 

Step 2 – Create a mapping table between your patient IDs (probably MRN numbers) and the TCIA IDs

 

...

Note

For TCGA cases, it is EXTREMELY important that the mapping is done correctly as these TCGA IDs will be the only link between imaging and tissue samples in the NCI Genomic Data Commons portal.

Other Collections with supporting information will also need someone to confirm that dates, File IDs, and PatIDs will be resolved across information types (for example, segmentations, xml, clinical spreadsheets, protein data, histopathology).

  1. Navigate to the …/CTP/scripts folder and open the file XXX.ID-LOOKUP.properties file (where XXX represents a name unique to your site) using a plain text editor such as NotePad or WordPad. Please do not use Microsoft Word as that will put in special characters. Example shown below has a lookup table file named TCGA-KIRC-BWH.ID-LOOKUP.properties.

 

 

 

...

  1. Image Added
  2. Complete the Mapping by editing the file you just opened.

...

  1. Replace the “Your Patient ID” with the MRN that was assigned to the TCIA ID shown on the right side of the equal sign. An example is shown on the top line. In this fictional case we assigned MRN “01” to TCGA ID TCGA-CZ-9999. If this is not a TCGA collection, then there may be no assigned IDs on the right and you would create your own using the agreed upon naming convention. It is important to use the ptid/ as that is the key to the lookup table.
  2. For TCGA collections, the pre-populated TCGA IDs represent the possible cases to send. You may not have imaging for all of them.

...

...

  1. Once the mapping is completed, save the file.

 

-        Note: For TCGA cases, it is EXTREMELY important that the mapping is done correctly as these TCGA IDs will be the only link between imaging and tissue samples in the TCGA portal.

 

 

...

  1. Image Added

Step 3 – Launch CTP

  1. Double-

...

  1. click the Launcher.jar file in the CTP folder.

...

  1. Image Added

 

...

  1. A window opens.  Click Start and then click the CTP Home Page button when it becomes active.  (Note that the Stop button shuts down CTP.)

-         

 

 

...

  1. Image Added
  2. Log into CTP (not always necessary but opens up more views) with

...

  1. Username admin and Password password.

...

  1. Image Added

 

...

  1. Logging in enables Admin functions.

 

...

  1. Image Added

Step 4 – Sending Images

-        If your images are accessible from the computer where CTP is installed, then you can use FileSender to send the images to CTP which will de-identify them and route them to TCIA for curation. (Note:

Note

You can also send directly from a PACS. CTP is configured to accept any AET. Most sites use CTP as the AET name if sending from PACS.

...

...

  1. To use FileSender, open the FileSender folder and double-click FileSender.jar

...

 

 

 

 

...

  1. .
    A window appears.
    Image Added
  2. Click the radio button in the destination panel. The line shown is configured to send to CTP on the local computer through port 11112.

...


...

  1. A check box at the bottom left can be selected if the DICOM data is in a folder hierarchy

...

...

  1. At the lower right of the Source panel is a box that has an *.  That just means send

...

  1. any files. If your images all have extensions of .dcm, you could click the * and change it to .dcm.  Only DICOM files will be transmitted, other files will throw an exception.

...

...

  1. Select the directory to the left that has the files you want to send and then click Send.

...

  1. Image Added

...

  1. Monitor the submission process from the Status link on the RSNA CTP homepage.

...

  1. Image Added

 

...

  1. Make sure the last stage “HTTP Export”

...

  1. queue is empty before stopping CTP.

...

  1. Info

    Although the import

...

  1. queue will be empty much sooner,

...

  1. keep CTP running

...

  1. .

    Image Added

     

Step 5 – Checking for Sending Errors

...

  1. After the images have been sent, check the quarantines page to see if any images went to quarantine.

...

  1. Image Added

...

  1. You can also click on the database verifier link to compare what is in the database compared to what you sent.

...

  1. Image Added

...

  1. At the end of your submission, we will provide you with a list of subjects received along with the number of images for each. We will ask you to confirm that is the number sent.

...

 

Complete User Guide may be found at:

...