Differences

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

--- electronrt:userguide:tutorials:electron_bolus [2020/12/04 17:16] – [Optimized Thickness Bolus] kerhart
+++ electronrt:userguide:tutorials:electron_bolus [2022/05/05 14:39] (current) – [Intensity Modulator Device] dpatenaude
@@ Line 68: / Line 68: @@
     * The thickness to add to the bolus proximal surface (use a negative value to reduce height)
- Additionally by selecting the "Bolus Design History" you can see a list of every step in the bolus design. The last step is removable individually, and there is also the option to clear all steps and start from scratch.
+Additionally by selecting the "Bolus Design History" you can see a list of every step in the bolus design. The last step is removable individually, and there is also the option to clear all steps and start from scratch.
 <imgcaption beams_24|Bolus design history list>{{ :electronrt:userguide:tutorials:decimal_electronrt_beams_bolus_optimized_thickness_advanced_options_operator_history.png?direct&400 }}</imgcaption>
+When designing an optimized thickness bolus, you also have the option to select the patient external structure. By default, this is set to the external structure defined in the course.
+<imgcaption bolus_external|Bolus external structure selection>{{ :electronrt:userguide:tutorials:decimal_electronrt_beams_bolus_optimized_thickness_external.png?direct&400 }}</imgcaption>
+If you want to make changes to the beam without having the optimized thickness bolus re-calculate, there is a lock button that prevents the optimized bolus from changing during other beam changes (e.g.: changing the block shape will normally cause the bolus to re-compute). This will lock the bolus design and prevent any changes. If anything in the beam is changed after locking the bolus and the bolus is unlocked then the bolus will be re-computed using the new beam parameters.
+<imgcaption bolus_lock_button|Bolus computation lock>{{ :electronrt:userguide:tutorials:bolus_lock_button.png?direct&400 }}</imgcaption>
 ===== Uniform Thickness Bolus =====
-When adding a uniform thickness bolus the user must add the UTB to all the beams in the plan. Once the plan level bolus has been selected the dose will be recalculated to reflect the new bolus.
+Uniform Thickness Bolus devices are designed at the plan level, but they must be added to each intended beam individually to ensure the computed dose accounts for the presence of the bolus in the beam path.
 <imgcaption beams_26|Beams Block>{{ :electronrt:userguide:tutorials:decimal_electronrt_beams_bolus_uniform_thickness.png?direct&400 }}</imgcaption>
-===== Bolus as a Structure =====
+===== Structure as Bolus =====
-The user also has the option to instead include a bolus as a separate structure in the structure list. Once the option is chosen the user will be able to find the bolus structure from the drop down structure list and the app will set it as the bolus for this beam.
+The user also has the option to use existing plan structure as a bolus. Once this option is selected, the user will be able to choose the structure from the drop down list and the app will set it as a bolus for this beam.
 <imgcaption bolus_structure2|selecting from the structure list>{{ :electronrt:userguide:tutorials:decimal_electronrt_beams_bolus_structure_select.png?direct&400 }}</imgcaption>
@@ Line 86: / Line 93: @@
 <imgcaption bolus_structure1|selecting a Bolus as a structure>{{ :electronrt:userguide:tutorials:decimal_electronrt_beams_bolus_structure.png?direct&400 }}</imgcaption>
-Once the structure is selected the bolus will be added to this beam and dose re-calculated as expected.
+Once the structure is selected the bolus will be added to this beam and dose re-calculated.
 **Note:** The bolus is displayed in the BEV for this beam even though the "Electron Bolus" structure is hidden through the right hand side controls. This shows that the displayed bolus is added as a bolus on this beam and not appearing as a structure.
@@ Line 92: / Line 99: @@
 <imgcaption bolus_structure3|Bolus in BEV>{{ :electronrt:userguide:tutorials:decimal_electronrt_beams_bolus_structure_full_UI.png?direct&800 }}</imgcaption>
-If you with to import a bolus that is not currently in your structure list please refer to the [[electronrt:userguide:tutorials:dicom_import|DICOM Patient Import]] section of the user guide for how to re-import a structure set.
+If you wish to import a bolus that is not currently in your structure list please refer to the [[electronrt:userguide:tutorials:dicom_import|DICOM Patient Import]] section of the user guide for how to re-import a structure set.
 ===== Intensity Modulator Device =====
-Additionally if any type of bolus is added to a beam the user is able to also include an intensity Modulator by selecting the option below any bolus type. The application with calculate the device and display it in the beams UI.
+Additionally if any type of bolus is added to a beam the user is able to also include an Intensity Modulator by selecting the option below any bolus type. The user will then have the option of modifying the dose scaling value applied when calculating the positions and diameters of the intensity modulation pins. The application with calculate the device and display it in the beams UI.
 **NOTE:** In order to add an IMET device the selected beam MUST have a valid bolus.
+<WRAP center round important 60%>
+Circular applicator shapes (e.g.: Siemens 4x4) are not supported for intensity modulators.
+</WRAP>
+<imgcaption bolus_IMET1|IM Dose Scaling control>{{ :electronrt:userguide:tutorials:bolus_im_dose_scaling.png?direct&400 }}</imgcaption>
 <imgcaption bolus_IMET1|BEV IMET >{{ :electronrt:userguide:tutorials:decimal_electronrt_beams_bolus_imet.png?direct&400 }}</imgcaption>
-FIXME get a better IM image once that actually works...
-And as with a bolus the device can be hidden and un-hidden from the display using the beam controls on the right hand size.
+As with a bolus, the IM device can be hidden and un-hidden from the display using the beam controls on the right hand size.
 <imgcaption bolus_IMET22|RHS options to hide/show devices>{{ :electronrt:userguide:tutorials:decimal_electronrt_beams_bolus_rhs.png?direct&400 }}</imgcaption>
+Users with [[electronrt:instructions_for_use:instructions_for_use#account_permissions|Elevated Physics level]] permissions are able to import a user-defined intensity modulation device. The imported device file must be a .csv file with the format: X,Y,Diameter for each pin on a new line. The values must be at the physical block/tray position and the pin diameters must match the supported modulator diameter list.
+An example file is:
+<code csv im_file_example.csv>
+.3,-1.55885,0.352
+-0.3,1.55885,0.158
+</code>
+<imgcaption user_im|Option to import user defined intensity modulator file>{{ :electronrt:userguide:tutorials:user_defined_intensity_modulation.png?direct&400 }}</imgcaption>