decimal App Documentation

User Tools

Site Tools

Trace:
electronrt:userguide:tutorials:dicom_import

Differences

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

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision		Previous revision
electronrt:userguide:tutorials:dicom_import [2020/12/04 14:48] – [DICOM Patient Import] kerhartelectronrt:userguide:tutorials:dicom_import [2022/03/08 15:49] (current) – [Importing DICOM Plans] anegron
Line 9: Line 9:
  
 ===== Importing a New Patient ===== ===== Importing a New Patient =====
 +
 +The ElectronRT application has two methods for importing new DICOM patients: 1) Manually browsing for local files and 2) setting up a DICOM receiver to accept and import DICOM patients. Refer to the sections below for details on each option.
 +==== Local File Import ====
  
 If you have a set of Ct Images and structures you can import them directly into a new patient through the "Import Patients" menu. If you have a set of Ct Images and structures you can import them directly into a new patient through the "Import Patients" menu.
  
 <imgcaption import_1|Import in the Main App Page>{{ :electronrt:userguide:tutorials:decimal_electronrt_import_new.png?direct&400 |}}</imgcaption> <imgcaption import_1|Import in the Main App Page>{{ :electronrt:userguide:tutorials:decimal_electronrt_import_new.png?direct&400 |}}</imgcaption>
- 
-Selecting the "Import New Patient" option will open the Importing UI. 
  
 <imgcaption import_2|Import Directory Input>{{ :electronrt:userguide:tutorials:decimal_electronrt_import_browse.png?direct&400 |}}</imgcaption> <imgcaption import_2|Import Directory Input>{{ :electronrt:userguide:tutorials:decimal_electronrt_import_browse.png?direct&400 |}}</imgcaption>
  
-Here you may either browse your computer or copy the path to the folder that contains the CT images and structures you wish to import.+The Import DICOM Files option allows you to either browse your computer or copy the path to the folder that contains the CT images and structures you wish to import. The following options are available for browsing for local files: 
 +  * **Add Folder:** Browse for an entire folder of DICOM files to import into a patient 
 +    * Use recursive folder search: This option can be selected prior to adding a folder to reclusively search and add all DICOM files within the selected folder and all sub-folders. 
 +  * **Add Files:** Browse for individual DICOM file(s) to import into a patient. Note: this option does not make use of the recursive folder search option.
  
-Then the import will process:+A list of selected DICOM files for import will be displayed and you can choose to add more files for the selected patient or remove any files as desired. 
 + 
 +Refer to the [[electronrt:userguide:tutorials:dicom_import#processing_imports|Processing Imports]] section once files have been selected to import. 
 + 
 +==== DICOM Receiver Imports ==== 
 + 
 +Users can install and configure the [[electronrt:userguide:dicom_receiver|ElectronRT DICOM Receiver]] to receive and save patients for seamless importing into the ElectronRT application. 
 + 
 +Users can then specify a DICOM Import Monitoring Directory within the [[electronrt:userguide:tutorials:all_tutorials#dicom_settings| Site Configuration's DICOM Settings]] block that corresponds to the ''storage_location'' field set for the ElectronRT DICOM Receiver. Once the receiver and monitoring directory have been setup and configured, any DICOM patients sent to the ElectronRT DICOM Receiver will automatically show up within the Import Patients display as shown in <imgref dicom_receiver_patients>. 
 + 
 +<imgcaption dicom_receiver_patients|DICOM Receiver Patients>{{ :electronrt:userguide:tutorials:dicom_import_receiver_patients.png?direct&400 |}}</imgcaption> 
 + 
 +Each patient received from the ElectronRT DICOM Receiver can be imported or removed from within the eRT Import Patient block. 
 + 
 +Refer to the [[electronrt:userguide:tutorials:dicom_import#processing_imports|Processing Imports]] section once a patient has been selected for import. 
 + 
 +==== Processing Imports ==== 
 + 
 + 
 +Clicking the Import button will start processing the selected files.
  
 <imgcaption import_3|Import Loading screen>{{ :electronrt:userguide:tutorials:decimal_electronrt_import_in_process.png?direct&400 |}}</imgcaption> <imgcaption import_3|Import Loading screen>{{ :electronrt:userguide:tutorials:decimal_electronrt_import_in_process.png?direct&400 |}}</imgcaption>
Line 28: Line 51:
 <imgcaption import_4|Import Finalized>{{ :electronrt:userguide:tutorials:decimal_electronrt_import_complete.png?direct&400 |}}</imgcaption> <imgcaption import_4|Import Finalized>{{ :electronrt:userguide:tutorials:decimal_electronrt_import_complete.png?direct&400 |}}</imgcaption>
  
-If there are errors please refer to the [[electronrt:userguide:tutorials:dicom_import|Common Errors]] section below.+If there are errors, please refer to the [[electronrt:userguide:tutorials:dicom_import|Common Errors]] section below for further details. 
 + 
 +==== Importing DICOM Plans ==== 
 + 
 +Users have the option to import DICOM Plan files in addition to CT images and structure sets. For now, only electron plans can be imported into the decimal ElectronRT app. When importing a new patient, the DICOM plan file must have the proper UIDs that reference the structure set in order for the plan to be successfully imported. An imported plan will appear under the course of the new patient and will be marked as imported. 
 + 
 +Refer to the [[electronrt:userguide:tutorials:all_tutorials#imported_plans|Imported Plans]] section for more information on imported plans. 
 ===== Common Errors ===== ===== Common Errors =====
  
Line 34: Line 64:
 If the imported DICOM Structure Set does not have a structure flagged as //RT ROI Interpreted Type (3006,00A4) EXTERNAL// you will be directed to specify the external patient structure before the import resumes. The patient external structure must be set to the defining boundary of the patient's outer surface, and not a rind skin structure. If the imported DICOM Structure Set does not have a structure flagged as //RT ROI Interpreted Type (3006,00A4) EXTERNAL// you will be directed to specify the external patient structure before the import resumes. The patient external structure must be set to the defining boundary of the patient's outer surface, and not a rind skin structure.
  
-Note: You will be warned if the selected external structure is not the structure with the largest volume. This is to prevent incorrect structure selection (e.g.: when a 'External' and 'Skin' structure both exist, and the 'Skin' structure is a rind. If the user selects the 'Skin' structure the warning will state the 'External' structure has a larger volume, since that's the correct representation of the patient structure.+Note: You will be warned if the selected external structure is not the structure with the largest volume. This is to prevent incorrect structure selection. For example, when a 'External' and 'Skin' structure both exist, and the 'Skin' structure is a rind, if the user selects the 'Skin' structure, the warning will state the 'External' structure has a larger volume, since that's the correct representation of the patient structure needed for the ElectronRT App.
  
 <imgcaption errors_missing_1|Missing External Error>{{ :electronrt:userguide:tutorials:decimal_electronrt_import_error_external.png?direct&400 |}}</imgcaption>  <imgcaption errors_missing_1|Missing External Error>{{ :electronrt:userguide:tutorials:decimal_electronrt_import_error_external.png?direct&400 |}}</imgcaption> 
  
-The drop down menu will have a list of the structures in the imported set. You will be able to select one as the external for this course then confirm your choice by pressing "Set External"+The drop down menu will have a list of the structures in the imported set. You will be able to select one as the external for this course then confirm your choice by pressing "Set External".
  
 <imgcaption errors_missing_2|Set External Dialog>{{ :electronrt:userguide:tutorials:decimal_electronrt_import_error_set_external.png?direct&400 |}}</imgcaption> <imgcaption errors_missing_2|Set External Dialog>{{ :electronrt:userguide:tutorials:decimal_electronrt_import_error_set_external.png?direct&400 |}}</imgcaption>
Line 45: Line 75:
  
 Structures can be skipped during Structure Set import if the structures meet the following criteria: Structures can be skipped during Structure Set import if the structures meet the following criteria:
-  * Non closed planar (e.g.: points or structures where slices are not correctly closed)+  * Non closed planar (e.g.: points or structures where slices are not fully closed)
  
 Structures that are skipped will be denoted at the end of the DICOM import as shown in <imgref import_skipped_structures>. Structures that are skipped will be denoted at the end of the DICOM import as shown in <imgref import_skipped_structures>.
Line 53: Line 83:
 ==== Importing an Existing Patient ==== ==== Importing an Existing Patient ====
  
-If the files you have selected to import coincide with the MRN of a patient that already exists in the app you will receive this error.+If the files you have selected to import coincide with the MRN of a patient that already exists in the database you will receive this error.
  
 <imgcaption errors_1|Existing Patient Error>{{ :electronrt:userguide:tutorials:decimal_electronrt_import_error_existing_patient_options.png?direct&400 |}}</imgcaption> <imgcaption errors_1|Existing Patient Error>{{ :electronrt:userguide:tutorials:decimal_electronrt_import_error_existing_patient_options.png?direct&400 |}}</imgcaption>
Line 63: Line 93:
  
 === Import to a New Course === === Import to a New Course ===
-Importing to a new course will simply complete the import but instead of affecting existing courses or plans for the patient the app will create a new course for this patient using the new import.+Importing to a new course will simply complete the import with the app creating a new course for this patient using the new imported files (note this option will not affect any existing courses or plans for the patient).
  
 <imgcaption errors_2|Importing as a New Course>{{ :electronrt:userguide:tutorials:decimal_electronrt_import_error_existing_patient_new_course.png?direct&400 |}}</imgcaption> <imgcaption errors_2|Importing as a New Course>{{ :electronrt:userguide:tutorials:decimal_electronrt_import_error_existing_patient_new_course.png?direct&400 |}}</imgcaption>
Line 69: Line 99:
 === Re-import Structures=== === Re-import Structures===
  
-Re-Importing structures can be used if your goal is to update or add structures to your existing patient.+Re-Importing structures can be used if your goal is to update or add structures to an existing patient Course.
  
 <imgcaption errors_3|Re-Import Structures>{{ :electronrt:userguide:tutorials:decimal_electronrt_import_error_existing_patient_reimport.png?direct&400 |}}</imgcaption> <imgcaption errors_3|Re-Import Structures>{{ :electronrt:userguide:tutorials:decimal_electronrt_import_error_existing_patient_reimport.png?direct&400 |}}</imgcaption>
Line 88: Line 118:
  
 === Do Nothing=== === Do Nothing===
-This is the simplest action, selecting to do nothing will cancel your import and return you to the main menu.+This is the simplest action, selecting "Do Nothing" will cancel your import and return you to the main menu.
  
 <imgcaption errors_6|Do Nothing>{{ :electronrt:userguide:tutorials:decimal_electronrt_import_error_existing_patient_do_nothing.png?direct&400 |}}</imgcaption> <imgcaption errors_6|Do Nothing>{{ :electronrt:userguide:tutorials:decimal_electronrt_import_error_existing_patient_do_nothing.png?direct&400 |}}</imgcaption>
  
electronrt/userguide/tutorials/dicom_import.1607093282.txt.gz · Last modified: 2021/07/29 18:24 (external edit)