decimal App Documentation

This page is read only. You can view the source, but not change it. Ask your administrator if you think this is wrong.
====== Uploading DICOM Patient Files ======

The Astroid Planning App stores a list of DICOM files (only CT Image Set and Structure Set files are supported at this time) that are available and ready for Import. There are several approaches that can be used to upload DICOM files into this list.

===== DICOM Receiver Service =====

For clinical users, a DICOM receiver is generally installed, allowing for direct exporting from contouring software or other planning systems for use within Astroid. In such cases, this DICOM receiver service will be pre-configured to upload the incoming files directly to Thinknode and will also create the records necessary for the DICOM files to be populated into the Astroid Planning App list of available Imports.

===== Uploading using the Planning App =====

DICOM files can also be uploaded directly from the Astroid Planning App. The steps below describe the process in detail.

  - Open the Launcher and choose the appropriate realm and application to work in {{ :planning:userguide:tutorials:opening_launcher.png?400 |}}
  - Choose the //Imports// block and click the blue Browse button in the //Upload Files// sub-block{{ :planning:userguide:tutorials:upload_import.png?400 |}}
  - Navigate to the directory where the DICOM image and structure set files are stored and click Ok {{ :planning:userguide:tutorials:upload_navigate.png?400 |}}
    - All DICOM files found in the selected directory will populate in the list field
  - If the file list appears correct, click the blue Upload button in the bottom right corner to start the Upload
    - This may take a couple of minutes to complete {{ :planning:userguide:tutorials:upload_images.png?400 |}}
  - Once the file(s) finished uploading they will appear in the list of available files, click back on the //Search Files// sub-block to return to the list of available files 

===== Bulk Importing using Python ====

**Note:** This section requires the user to be familiar with python and the existing [[dicom:userguide:thinknode#python|.decimal python libraries]].

Importing a new patient into the Planning App requires taking a local DICOM directory and posting each of the files through the [[dicom:dicom|Dicom App]] utilizing Thinknode. Each DICOM patient is posted to the Thinknode ISS and an entry is then added to the thinknode RKS that allows the Planning App to see that a new patient has been added. The steps below explain how to upload patient DICOM files using the open source python Astroid Script Library.

  - From the [[https://github.com/dotdecimal/astroid-script-library|.decimal GitHub repository]] open and edit the post_dicom_patient_rks.py python file.
  - Ensure the thinknode.cfg file is set appropriately for your user, account, and realm.
  - Edit the following line to point to the directory in which the DICOM patient files are located (note: all DICOM files in this directory will be uploaded): <code python># Post patient data into ISS 
obj_list_id = dicom.make_dicom_object_from_dir(iam, 'F:/Datasets/demo-patient/prostate') </code>
  - Run the script and allow the patient to upload to thinknode ISS. After the DICOM patient files are uploaded to ISS, an RKS entry will be created for the Planning App to recognize it as a DICOM file that is available for import.