====== DICOM Patient Import ======

In order to begin planning in the decimal ElectronRT App you must first have patient imaging captured and structure geometries defined. This information is brought in the ElectronRT App by importing DICOM CT and Structure Set files.

**Note: DICOM patient import will be disabled until the organization configuration has been completed.**
===== Default Import Directory =====

The default import directory can be set in the app settings by navigating to View -> Settings. This directory will always be the default directory when importing a patient. Users can then further refine the import folder as needed starting from this default level.

===== 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.

<imgcaption import_1|Import in the Main App Page>{{ :electronrt:userguide:tutorials:decimal_electronrt_import_new.png?direct&400 |}}</imgcaption>

<imgcaption import_2|Import Directory Input>{{ :electronrt:userguide:tutorials:decimal_electronrt_import_browse.png?direct&400 |}}</imgcaption>

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.

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>

If there are no Errors while importing you will be taken to a confirmation page for your import.

<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 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 =====

==== Missing/Undefined External 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. 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> 

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>

==== Structures Skipped During Import ====

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 fully closed)

Structures that are skipped will be denoted at the end of the DICOM import as shown in <imgref import_skipped_structures>.

<imgcaption import_skipped_structures|Import Finalized>{{ :electronrt:userguide:tutorials:decimal_electronrt_import_complete.png?direct&400 |}}</imgcaption>

==== Importing an Existing Patient ====

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>

You have three options provided to resolve the error:
  * **Import to a New Course** 
  * **Re-Import Structures**
  * **Do Nothing**

=== Import to a New Course ===
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>

=== Re-import Structures===

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>

After selecting this option, you will be presented with a list of the structures in the import.

For each you may select one of three options:
  * **Do not Re-import**: Skips this structure for the re import.
  * **Replace existing geometry**: Replaces the existing structure in the current Course with the imported one.
  * **Import as new structure**: Imports the structure to the Course as a new structure while not affecting the existing one and allows the user to specify a new name for the new structure. If the structure does not exist currently it creates it as normal.

<imgcaption errors_4|Re-Importing Structure List>{{ :electronrt:userguide:tutorials:decimal_electronrt_import_error_existing_patient_reimport_2.png?direct&400 |}}</imgcaption>

Once you have made your decision for each structure you must select "Re-Import Structures" to finalize your changes.

<imgcaption errors_5|Finalize Re-Import>{{ :electronrt:userguide:tutorials:decimal_electronrt_import_error_existing_patient_reimport_3.png?direct&400 |}}</imgcaption>


=== Do Nothing===
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>