Differences

This shows you the differences between two versions of the page.

--- planning:userguide:tutorials:patient_import [2017/01/06 21:19] – [Uploading a DICOM Patient] kerhart
+++ planning:userguide:tutorials:patient_import [2021/07/29 18:28] (current) – external edit 127.0.0.1
@@ Line 1: / Line 1: @@
-====== Uploading a DICOM Patient ======
+====== Uploading DICOM Patient Files ======
-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 added to the thinknode RKS that allows Planning to see a new patient has been added.
+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.
-<WRAP center round box 75%>
+===== DICOM Receiver Service =====
-For clinical users, a DICOM receiver is generally installed, allowing for direct exporting from contouring software or other planning systems into Thinknode for use within Astroid. In such cases, you can proceed directly to the [[planning:userguide:tutorials:importing|Importing Patient Data]] section below.
-</WRAP>
+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.
-In the absence of such a receiver, importing a DICOM directory to Thinknode is accomplished using a python script as described below.
+===== Uploading using the Planning App =====
-===== Importing using Python =====
+DICOM files can also be uploaded directly from the Astroid Planning App. The steps below describe the process in detail.
-**Note:** This guide requires the user to be familiar with python and the existing [[dicom:userguide:thinknode#python|.decimal python libraries]].
+  - 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.
@@ Line 18: / Line 29: @@
   - 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 is uploaded to ISS, an RKS entry will be created for the patient for the Planning App to recognize it as a newly imported patient.
+  - 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.