Differences

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

--- electronrt:userguide:tutorials:electron_bolus [2020/09/16 19:22] – [Bolus as a Structure] cmontoya
+++ electronrt:userguide:tutorials:electron_bolus [2022/05/05 14:39] (current) – [Intensity Modulator Device] dpatenaude
@@ Line 1: / Line 1: @@
 ====== Electron Bolus Creation ======
-FIXME
-A user is able to add an electron bolus to their beams to aid in proper distribution of dose.
+An electron bolus is an optional device for each electron treatment beam. A user is able to add an electron bolus to their beams to help improve the dose conformality to the distal target surface. The four options for bolus types in the decimal eRT app are fully defined below.
 <imgcaption beams_18|Beams Block>{{ :electronrt:userguide:tutorials:decimal_electronrt_beams_bolus.png?direct&400 }}</imgcaption>
-There are four options for boluses in the electronRT app as defined below:
 ===== Optimized Thickness Bolus =====
+The first option a user has for creating a bolus for the selected beam is an optimized thickness bolus. The goal for an optimized bolus is to best fit the specified Planning Isodose level of the computed beam dose to the distal surface of the target structure. The application provides reasonable default parameters for designing such a bolus, so that in most cases, the user can simply click the "Generate Bolus" button and the application will design a suitable bolus automatically. Once the application has finished calculating, the bolus will get added to the beam.
 <imgcaption beams_19|Beams Block>{{ :electronrt:userguide:tutorials:decimal_electronrt_beams_bolus_optimized_thickness.png?direct&400 }}</imgcaption>
-<imgcaption beams_20|Beams Block>{{ :electronrt:userguide:tutorials:decimal_electronrt_beams_bolus_optimized_thickness_advanced_options.png?direct&400 }}</imgcaption>
+For complex and challenging plans, a user can also access advanced options to modify an existing bolus or create a new one from scratch.
-<imgcaption beams_21|Beams Block>{{ :electronrt:userguide:tutorials:decimal_electronrt_beams_bolus_optimized_thickness_advanced_options_automated_marching.png?direct&400 }}</imgcaption>
+In the advanced options you can view and manage various operators to augment the design of the bolus. The following operators are available:
-<imgcaption beams_22|Beams Block>{{ :electronrt:userguide:tutorials:decimal_electronrt_beams_bolus_optimized_thickness_advanced_options_automated_marching_generate.png?direct&400 }}</imgcaption>
+**Construction Operators (only available when first creating a new bolus):**
+  * **Automated Marching**
+    *  This operator constructs the proximal bolus surface using a series of incremental steps. Each step consists of a small thickness reduction at the optimally selected locations, followed by a hot spot damping step, in which the slopes of the bolus surface are reduced in areas where high dose values are found.
+  * **Geometric Sequence**
+    *  This selection performs the following sequence of operators: Create, Smooth, Truncate.
+  * **Single shift Sequence**
+    * This selection performs the following sequence of operators: Create, Smooth, Isodose Shift, Smooth, Truncate.
+  * **Double Shift Sequence**
+    * This selection performs the following sequence of operators: Create, Smooth, Isodose Shift, Smooth, Isodose Shift, Smooth, Truncate.
+  * **Create**
+    * This operator constructs the proximal bolus surface by computing the difference between the physical depth to the distal PTV surface and the depth of the Planning Isodose level along each ray line of the bolus construction grid (for ray lines not intersecting the PTV, an extension is performed using the heights of the points that do intersect, which helps ensure the PTV edges are adequately covered).
-<imgcaption beams_23|Beams Block>{{ :electronrt:userguide:tutorials:decimal_electronrt_beams_bolus_optimized_thickness_advanced_options_automated_operators.png?direct&400 }}</imgcaption>
+**Modification Operators (only available after a construction operator has been performed):**
+  * **Smooth**
+    * This operator performs a Gaussian type smoothing on the current bolus proximal surface, which uses a distance weighted average of the neighboring point heights to compute a new height for each bolus surface point.
+  * **Isodose shift**
+    * This operator updates the bolus proximal surface by using the dose results with the current bolus in place to adjust the bolus heights by the difference between the position of the Planning Isodose contour and the position of the distal PTV surface.
+  * **Truncate**
+    * This operator updates a bolus proximal surface by reducing the height of the bolus in the region outside the Block Outer Border. The height is reduced to be slightly above the highest point in the modulated region. It should be mentioned that truncating a bolus may limit the ability to shift points upward (increase in thickness) when performing manual isodose shift operators after the truncate.
+  * **Specified Shift**
+    * This operator updates a bolus proximal surface by shifting all points (even the region beyond the Block Outer Border) by the specified distance.
+  * **Intensity Modulation**
+    * This operator manually adds an [[electronrt:userguide:tutorials:all_tutorials#intensity_modulator_device|Intensity Modulator]] device to the beam. If multiple Intensity Modulation operators are added in the operator list, then the results of the multiple iterations of the modulation calculation are combined to produce a single Intensity Modulator device for the beam.
-<imgcaption beams_24|Beams Block>{{ :electronrt:userguide:tutorials:decimal_electronrt_beams_bolus_optimized_thickness_advanced_options_operator_history.png?direct&400 }}</imgcaption>
+If an operator is selected from the list the UI will update to show the options for that operation. Once the options have been finalized the user can add the operator to the list which will re-compute the bolus and IM devices for the beam.
+Below is an example of adding the automated marching to a new bolus:
+<imgcaption beams_21|New bolus operator options>{{ :electronrt:userguide:tutorials:decimal_electronrt_beams_bolus_optimized_thickness_advanced_options_automated_marching.png?direct&400 }}</imgcaption>
+<imgcaption beams_20|Adding an automated marching operator>{{ :electronrt:userguide:tutorials:decimal_electronrt_beams_bolus_optimized_thickness_advanced_options.png?direct&400 }}</imgcaption>
+The advanced optimized thickness bolus design parameters allow the user to fine tune the bolus design for specific operators. These options include:
+  * **Block Outer Border:**
+    * The distance to extend the bolus surface beyond the block/collimator perpendicular to the CAX.
+  * **Target Inner Border:**
+    * Specifies the distance to offset the target projection inward when defining the region over which initial construction and smoothing operators act. This is used to reduce the effects that the rapid PTV height changes near the target edges can have on the construction and smoothing operators.
+  * **Depth Beyond Target:**
+    * The beams-eye-view distance past the selected target (along the CAX direction) at which the patient-side surface will be truncated.
+  * **Minimum Thickness:**
+    * The minimum allowable thickness of the bolus as measured along a beam aligned rayline.
+  * **Distal PTV Smoothing:**
+    * The smoothing ball radius used to smooth the target structure. A larger radius will result in more smoothing but will also cause a greater deviation of the target from the original structure. Note that setting this value to 0 mm will result in no smoothing for the target structure.
+  * **Smoothing Weight:** (Smoothing operator only)
+    * The exponential smoothing weight coefficient (smaller value increases smoothing)
+  * **Smoothing Size:** (Smoothing operator only)
+    * The smoothing distance factor (larger values spread the smoothing range further)
+  * **Additional Thickness:** (Specified Shift operator only)
+    * 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.
+<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 =====
+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 35: / 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 41: / 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.
-===== IMET Device =====
+===== 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 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>
+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>