Differences

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

--- electronrt:userguide:tutorials:electron_blocks [2020/09/09 13:18] – [Electron Block Creation] cmontoya
+++ electronrt:userguide:tutorials:electron_blocks [2022/04/18 19:12] (current) – Image size edit anegron
@@ Line 1: / Line 1: @@
 ====== Electron Block Creation ======
-FIXME
 Here the user can create and edit Electron Blocks for the selected beam as well as edit values for an existing block.
-<imgcaption beams_electron_block|Block size selection>{{ :electronrt:userguide:tutorials:decimal_electronrt_beams_block.png?direct&400 }}</imgcaption>
+<imgcaption beams_electron_block|Electron block controls>{{ :electronrt:userguide:tutorials:decimal_electronrt_collimation.png }}</imgcaption>
 ===== Block Size =====
-  * **Size:** Select the block size. The list of available block sizes is derived from the list of cone sizes available for the selected machine. Cone sizes can be enabled and disabled from editing the machine data in the site configuration.
+  * **Size:** Select the block size. The list of available block sizes is derived from the list of applicator (cone) sizes available for the selected machine. Applicator sizes can be enabled and disabled from editing the machine data in the site configuration.
 **Note:** When first creating a beam the eRT app will auto calculate the smallest block that will fit the current aperture shape.
-<imgcaption beams_electron_block_sizes|Block size options>{{ :electronrt:userguide:tutorials:decimal_electronrt_beams_block_sizes.png?direct&400 }}</imgcaption>
+<imgcaption beams_electron_block_sizes|Block size options>{{ :electronrt:userguide:tutorials:decimal_electronrt_beams_block_sizes.png }}</imgcaption>
-**Note** Selecting a block size that is too small for the aperture shape will cause an error that will not allow the creation of the beam.
+**Note** Selecting a block size that is too small for the aperture shape will cause an error that will not allow the creation/saving of the beam until an appropriate size is selected.
 <imgcaption block_size_error_1|Block size too small>{{ :electronrt:userguide:tutorials:decimal_electronrt_beams_block_sizes_error.png?direct&400 }}</imgcaption>
@@ Line 21: / Line 20: @@
 ===== Target Margin =====
-  * **Margin:** The value (in cm) of the margin around the aperture shape. A negative margin can be used to specify a contraction around the beam target while positive values will cause an expansion.
+  * **Margin:** The value (in cm) of the margin around the target structure as projected to isocenter. A negative margin can be used to specify a contraction around the beam target while positive values will cause an expansion. The default block target margin can be configured in the [[:electronrt:userguide:tutorials:all_tutorials#machine_settings|Site Configuration Machine Settings]].
-**Note:** The app will automatically recalculate and display changed to the block based on the set margin.
+**Note:** The app will automatically recalculate and display changes to the block as the margin is edited.
 <imgcaption block_target_margin|Block target margin>{{ :electronrt:userguide:tutorials:decimal_electronrt_beams_block_target_margin.png?direct&400 }}</imgcaption>
+===== Primitive Shape =====
+Instead of using the geometric target, the user may use a primitive shape as the base block opening instead. The user can choose the shape (square, circle, rectangle, or oval) and the dimensions at isocenter.
+<imgcaption primitive_shape|Primitive shape controls>{{ :electronrt:userguide:tutorials:decimal_electronrt_beams_primitive_oval.png?direct&800 }}</imgcaption>
 ===== Avoidance Structures =====
-The user may select a structure in the structure list here to add the as an avoidance structure. The beam and block will recalculate to take into account avoiding the selected structures.
+The user may select one or more structures in the structure list here to add as an avoidance structure. Avoidance structures will decrease the block opening to remove all areas within the projection of the structure.
-<imgcaption block_avoidance|Avoidance structure selection>{{ :electronrt:userguide:tutorials:decimal_electronrt_beams_block_avoidance_structures.png?direct&400 }}</imgcaption>
+<imgcaption block_avoidance|Avoidance structure selection>{{ :electronrt:userguide:tutorials:decimal_electronrt_beams_block_avoidance_structures.png?direct&200 }}</imgcaption>
 Once the structure is selected you will be able to set the values for how it should be avoided. Including:
-  * **Avoidance Margin:** Required, sets the margin of avoidance.
+  * **Avoidance Margin:** required, sets the margin of avoidance around the selected structure's projection to the isocenter plane.
-  * **Force min target margin:** disabled by default, when enabled it will force a minimum margin
 <imgcaption block_avoidance_selected|Selected avoidance structure>{{ :electronrt:userguide:tutorials:decimal_electronrt_beams_block_avoidance_structures_selected.png?direct&400 }}</imgcaption>
-  * **Occlude by target:** Enabled by default, sets whether you are giving priority to the target over the selected structure.
+  * **Force min target margin:** disabled by default, when enabled it will force a minimum margin around the target taking priority over the settings of the avoidance structure.
+**For example:** As shown below, there is an overlap between the margin set for the avoidance structure and our target structure. Since "force min target margin" is disabled, the avoidance margin has priority over the target.
-**For example:** Selecting to "Occlude by target" gives the target priority over the structure, ass seen below.
+<imgcaption block_force_min_target_off|Force min target margin is off>{{ :electronrt:userguide:tutorials:block_force_min_target_margin_off.png?direct&800 }}</imgcaption>
-<imgcaption block_avoidance_occluded|Structure is occluded>{{ :electronrt:userguide:tutorials:decimal_electronrt_beams_block_avoidance_structures_selected_occlude.png?direct&400 }}</imgcaption>
-And disabling the checkbox gives the priority to the avoidance structure, this means you block the entire structure regardless of its position relative to the target.:
+If the user decides that the target should have priority over the avoidance structure we can enable the "force min target margin" and set a min margin for our target. As you can see below the min margin set takes priority over our avoidance margin and there is no more overlap.
-<imgcaption block_avoidance_not_occluded|Structure is not occluded>{{ :electronrt:userguide:tutorials:decimal_electronrt_beams_block_avoidance_structures_selected_not_occlude.png?direct&400 }}</imgcaption>\
+<imgcaption block_force_min_target_on|Force min target margin is on>{{ :electronrt:userguide:tutorials:block_force_min_target_margin_on.png?direct&800 }}</imgcaption>
+  * **Occlude by target:** The user may also choose to occlude the structure by the target or not by using the "Occlude by Target" option. For the following examples we will use the Spinal Cord as it shows a dramatic example of differences of using or not using the "Occlude by Target" option. A 5mm margin was applied to the Cord for the following examples. {{ :electronrt:userguide:tutorials:aperture_choose_structure_avoidance.png?300 |}}
+      * Checking the "Occlude by Target" option makes the calculations account for the relative depth positions of the target and avoidance structure when determining the area to avoid. More specifically, the visible portion of the target (target volume that is in front of the avoidance structure) will not be blocked by the aperture. Note that just the inferior edge of the Cord is blocked by the aperture as this is the only portion that is visible (not behind the target) and the part of the Cord that is behind the PTV is not blocked. {{ :electronrt:userguide:tutorials:aperture_occlude.png?300 |}}
+      * Unchecking the "Occlude by Target" option makes the calculations ignore the depth order. This means the entire avoidance structure will be blocked, regardless of whether it is behind or in front of the target. In this example, the aperture now blocks out all of the Cord. {{ :electronrt:userguide:tutorials:aperture_not_occluded.png?300 |}}
 ===== Manual Edits =====
@@ Line 53: / Line 61: @@
 <imgcaption block_manual_edit|Enabling manual edits>{{ :electronrt:userguide:tutorials:decimal_electronrt_beams_block_manual_edits.png?direct&400 }}</imgcaption>
-Once manual editing has been enabled you will see the cursor update to reflect the editing tool. You can choose to edit edit with the Brush cursor or by drawing straight lines using the Line tool. Both take in the radius that can also be set by the user to alter the size of the editing tool.
+Once manual editing has been enabled you will see the cursor update to reflect the editing tool. You can choose to edit with the Brush cursor or by drawing straight lines using the Line tool. Both take in the radius that can also be set by the user to alter the size of the editing tool.
 **Note:** Drawing on the "Exterior" of the aperture shape will shrink the shape of the block as can be seen below.