Differences

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

--- electronrt:userguide:tutorials:electron_blocks [2020/12/06 23:08] – [Avoidance Structures] dpatenaude
+++ electronrt:userguide:tutorials:electron_blocks [2022/04/18 19:12] (current) – Image size edit anegron
@@ Line 3: / Line 3: @@
 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 =====
@@ Line 11: / Line 11: @@
 **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/saving of the beam until an appropriate size is selected.
@@ Line 20: / Line 20: @@
 ===== Target Margin =====
-  * **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.
+  * **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 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 =====
@@ Line 30: / Line 36: @@
 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:
@@ Line 38: / Line 44: @@
   * **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 you can see 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:** 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.
 <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>
@@ Line 46: / Line 52: @@
 <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:** You may also choose to occlude the structure by the target or not using the “Occlude by Target” option. By checking the “Occlude by Target” box you are choosing to give the target priority over the structure in the view you are looking at in the BEV. In other words the visible target (target in front of this structure) will not be blocked by the aperture. If you leave the “Occlude by Target” unchecked, you are choosing to give the structure priority over the target. This means you will block the entire structure regardless of its position relative to the target. In this example the aperture blocks out all of the Urethra.
+  * **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 |}}
-**For example:** Selecting to "Occlude by target" ignores portions of the avoidance structure that are deeper than the target (from the BEV perspective), as seen below.
+      * 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 |}}
-<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.:
-<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>
 ===== Manual Edits =====