decimal App Documentation

User Tools

Site Tools

Trace:
electronrt:userguide:tutorials:organization_configuration

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:organization_configuration [2021/03/30 00:32] – [Dose Colors] dpatenaudeelectronrt:userguide:tutorials:organization_configuration [2022/05/11 16:16] (current) – [Export Logs] dpatenaude
Line 15: Line 15:
 ==== Materials ==== ==== Materials ====
  
-The Materials definitions allow specifying the device materials and CT override materials. These materials will be usable across the entire organization and all sites. The materials are represented as json in the following example format:+The Materials definitions allow specifying the device materials and CT override materials. These materials will be usable across the entire organization and all sites.
  
-<code json Device Material> +The units for the materials are as follows: 
-{ +  * **density**: g/cm3
-   "bolus": { +
-      "density": 0.920, +
-      "name": "BlueWax", +
-      "relative_scattering_power": 0.920, +
-      "relative_stopping_power": 0.920 +
-   } +
-} +
-</code>+
  
-<code json Override Material Example> +<imgcaption site_materials|Materials Configuration>{{ :electronrt:userguide:tutorials:site_materials.png?direct&400 }}</imgcaption>
-{ +
-   "Water": { +
-      "density": 1, +
-      "name": "Water", +
-      "relative_scattering_power": 1.0, +
-      "relative_stopping_power": 1.0 +
-   } +
-} +
-</code>+
  
 ==== Dose Colors ==== ==== Dose Colors ====
Line 43: Line 26:
 The Dose Colors definitions allow users to specify the default dose colors and levels when creating new plans. These values will apply to all plans created within the organization across all sites. The Dose Colors definitions allow users to specify the default dose colors and levels when creating new plans. These values will apply to all plans created within the organization across all sites.
  
-<imgcaption organization_dose_colors|Dose Color configuration>{{ :electronrt:userguide:tutorials:organization_dose_colors.png?direct&400 |}}</imgcaption>+<imgcaption organization_dose_colors|Dose Colors Configuration>{{ :electronrt:userguide:tutorials:organization_dose_colors.png?direct&400 |}}</imgcaption>
  
 Note: The dose color options set will only be applied to newly created plans. For existing plans select the 'reset to defaults' link within the Dose Controls right hand side user interface to revert to the site level defaults. Note: The dose color options set will only be applied to newly created plans. For existing plans select the 'reset to defaults' link within the Dose Controls right hand side user interface to revert to the site level defaults.
 +
 +==== Organization Import/Export ====
 +
 +The organization import and export user interface allows users to backup, copy, or give their organization data to other individuals as needed. The following details are worth noting about this feature:
 +  * The organization data will not be readable as plain text.
 +  * If applicable, when importing an organization file the organization data will be upgraded to the latest version of the data model and automatic upgrades added where appropriate. Refer to the release notes for previous versions of the organization since it was last exported for the values of these upgrades.
 +  * The application will need to be restarted after successfully importing a new organization.
 +
 ===== Export Logs ===== ===== Export Logs =====
 The Export Logs block allows the user to export a file containing logs of user activity within the app. This .csv file contains data exported from the app database that keeps track of critical user activity, including (but not limited to): opening of patients and plans, plan approvals, report/DICOM exports, and hardware ordering. The Export Logs block allows the user to export a file containing logs of user activity within the app. This .csv file contains data exported from the app database that keeps track of critical user activity, including (but not limited to): opening of patients and plans, plan approvals, report/DICOM exports, and hardware ordering.
 +
 +Refer to the [[support:user_logging#decimal_ert|decimal eRT User Logging]] guide for details on what actions are logged.
  
 <imgcaption export_logs|Export Logs UI>{{ :electronrt:userguide:tutorials:export_logs.png?direct&400 }}</imgcaption> <imgcaption export_logs|Export Logs UI>{{ :electronrt:userguide:tutorials:export_logs.png?direct&400 }}</imgcaption>
Line 57: Line 50:
  
 ==== Site Settings ==== ==== Site Settings ====
-The Site Settings block allows for the viewing and editing of miscellaneous site level settings including the site address, physicians, and treatment sites. In order to edit physicians, the user must first click on the physician name on the list of physicians on left side UI and then click on "Edit Physician" on the right side UI (this is also the case with treatment sites). Users can add or remove physicians and treatment sites using the left side UI.+The Site Settings block allows for the viewing and editing of miscellaneous site level settings including the site address, physicians, and treatment sites. When editing the site address, the UI has an option to set the address to the one assigned to the site in decimal Direct. In order to edit physicians, the user must first click on the physician name on the list of physicians on left side UI and then click on "Edit Physician" on the right side UI (this is also the case with treatment sites). Users can add or remove physicians and treatment sites using the left side UI.
  
 <imgcaption site_settings|Site Settings UI>{{ :electronrt:userguide:tutorials:site_settings.png?direct&400 }}</imgcaption> <imgcaption site_settings|Site Settings UI>{{ :electronrt:userguide:tutorials:site_settings.png?direct&400 }}</imgcaption>
  
 +==== Plan Defaults / Templates ====
 +
 +=== Beam Normalization ===
 +
 +The user can assign a beam normalization template when editing a treatment site. This template will be used to set the normalization during automatic beam calculations for plans in the courses that are assigned to that treatment site.
 +
 +Note: Refer to [[electronrt:userguide:tutorials:all_tutorials#electron_beam_normalization|Electron Beam Normalization]] for using and the requirements of the beam normalization template within treatment plans.
 +
 +<imgcaption treatment_site_settings|Treatment Site Settings UI>{{ :electronrt:userguide:tutorials:treatment_site_settings.png?direct&400 }}</imgcaption>
 ==== DICOM Settings ==== ==== DICOM Settings ====
-The DICOM Settings block allows the user to view and edit settings related to the export of DICOM files. These settings include the default DICOM export directory, list of DICOM export server AE titles, and the monitoring directory for DICOM Receiver imports. +The DICOM Settings block allows the user to view and edit settings related to the export & import of DICOM files. These settings include the default DICOM export directory, a list of DICOM export server AE titles, and the monitoring directory for DICOM Receiver imports. 
  
 These settings are applied and available to all users of the selected Site ID for which the settings are present. These settings are applied and available to all users of the selected Site ID for which the settings are present.
Line 73: Line 75:
 | Export Export Servers           | A list of DICOM AE titles (DICOM Receivers from another system) that the ElectronRT app can export to.  || | Export Export Servers           | A list of DICOM AE titles (DICOM Receivers from another system) that the ElectronRT app can export to.  ||
 | :::                             | Server Name:  | The name of the DICOM server that will displayed to the user when exporting within the eRT app. | | :::                             | Server Name:  | The name of the DICOM server that will displayed to the user when exporting within the eRT app. |
-| :::                             | IP Address:   | The local network IP address from which to send DICOM files to the DICOM receiver. | +| :::                             | IP Address:   | The local network IP address to which DICOM files will be sent by the eRT DICOM sender. | 
-| :::                             | Port:         | The local network port being monitored by the specified DICOM receiver. |+| :::                             | Port:         | The local network port on which the DICOM sender should transmit the DICOM files. |
 ^ DICOM Import Server Settings   ^^^ ^ DICOM Import Server Settings   ^^^
 | DICOM Import Monitoring Directory     | Sets the monitoring directory for [[electronrt:userguide:tutorials:dicom_import#dicom_receiver_imports|importing patients]] received from the [[electronrt:userguide:dicom_receiver|ElectronRT DICOM Receiver]].  || | DICOM Import Monitoring Directory     | Sets the monitoring directory for [[electronrt:userguide:tutorials:dicom_import#dicom_receiver_imports|importing patients]] received from the [[electronrt:userguide:dicom_receiver|ElectronRT DICOM Receiver]].  ||
Line 80: Line 82:
  
 ==== CT Curves ==== ==== CT Curves ====
-The CT Curves block allows for the viewing and editing of CT conversion curves. These curves must contain data for both relative stopping and scattering power. The relative stopping power data for the selected curve is displayed on a graph on the right side UI.+The CT Curves block allows for the viewing and editing of CT conversion curves. These curves must contain data for both relative stopping and scattering power. The relative stopping power data for the selected curve is displayed on a graph on the right side UI. When adding a new CT conversion curve, the user can select and import a CSV file that fully defines the curve values. If there are no curves present, the user is able to obtain a sample CT curve file to have an example of the CSV formatting and values. Additionally, each CT conversion curve in the site can be exported as a CSV file.
  
 <imgcaption ct_curves|CT Curves UI>{{ :electronrt:userguide:tutorials:ct_curves.png?direct&400 }}</imgcaption> <imgcaption ct_curves|CT Curves UI>{{ :electronrt:userguide:tutorials:ct_curves.png?direct&400 }}</imgcaption>
Line 116: Line 118:
 } }
 </code> </code>
 +
 +=== CT Image Window and Level Presets ===
 +The CT Curves block allows for the viewing and editing of CT image window and level value presets. These presets will appear as options in the right side CT Controls for electron plans in the selected site.
 +
 +<imgcaption ct_window_level_preset|CT Window and Level Preset>{{ :electronrt:userguide:tutorials:ct_window_level_preset.png?direct&400 }}</imgcaption>
 +
 ==== QA Options ==== ==== QA Options ====
-The QA Options block allows the user to view and edit settings related to Dose QA. These settings include the dimensions of the water phantom, dose grid spacing, and the default measurement plane depth.+The QA Options block allows the user to view and edit settings related to Dose QA. The UI allows the import of a CT image set that defines a custom water phantom. The user must define a surface entry point and select a CT curve when importing a custom phantom. Settings used for the default water phantom include the dimensions of the phantom, dose grid spacing, and the default measurement plane depth.
  
 <imgcaption qa_options|QA Options UI>{{ :electronrt:userguide:tutorials:qa_options.png?direct&400 }}</imgcaption> <imgcaption qa_options|QA Options UI>{{ :electronrt:userguide:tutorials:qa_options.png?direct&400 }}</imgcaption>
  
 ==== Machine Settings ==== ==== Machine Settings ====
-The Machine Settings block allows the user to view and edit machines for the selected site. The machine settings are divided into five tabs: General, Geometry, Applicators, Commissioning, and Advanced.+The Machine Settings block allows the user to view, add, clone, and edit machines for the selected site. The machine settings are divided into five tabs: General, Geometry, Applicators, Commissioning, and Advanced.
  
 === General Machine Settings === === General Machine Settings ===
Line 143: Line 151:
 === Commissioning Data Settings === === Commissioning Data Settings ===
 The Commissioning tab of the Machine Settings block allows the user to view and edit commissioning data by energy. The user can view the nominal energy and R90 values of the current commissioning data or import new commissioning data from a local file. The ElectronRT App currently only has support for commissioning data import from the Pinnacle treatment planning system. The Commissioning tab of the Machine Settings block allows the user to view and edit commissioning data by energy. The user can view the nominal energy and R90 values of the current commissioning data or import new commissioning data from a local file. The ElectronRT App currently only has support for commissioning data import from the Pinnacle treatment planning system.
 +
 +The Commissioning tab also allows the user to import MU dose conversion data tables and display them in the UI. Each MU data file must contain the Output Factor and Air Gap Factor value tables for a given beam energy. The user is able to obtain a sample MU conversion table file to have an example of the CSV formatting and values.
  
 <imgcaption machine_settings_commissioning|Commissioning Data Settings UI>{{ :electronrt:userguide:tutorials:machine_settings_commissioning.png?direct&400 }}</imgcaption> <imgcaption machine_settings_commissioning|Commissioning Data Settings UI>{{ :electronrt:userguide:tutorials:machine_settings_commissioning.png?direct&400 }}</imgcaption>
electronrt/userguide/tutorials/organization_configuration.1617064329.txt.gz · Last modified: (external edit)