Differences

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

--- planning:userguide:tutorials:pbs_beams [2019/08/15 13:06] – [Creating a Proton Beam] dpatenaude
+++ planning:userguide:tutorials:pbs_beams [2021/07/29 18:28] (current) – external edit 127.0.0.1
@@ Line 11: / Line 11: @@
 ===== Beam Creation =====
-  - The next step is to create the beam by clicking the //Create New PBS Beam// button
+  * The next step is to create the beam by clicking the:
-  - Now we will proceed step-by-step through the various "blocks" to create a complete beam as shown below:
+    * //Create New PBS Beam// button for use in PBS treatment rooms
+    * //Create New SOBP Beam// button for use in SOBP treatment rooms
+  * Now we will proceed step-by-step through the various "blocks" to create a complete beam as shown below:
 ==== General Settings ====
-The //General// block is used to set general beam details including:
+The //**General**// block is used to set general beam details including:
-  * Beam label, description, and color
+  * Color, Beam Label (or select //automatically generate label//) and Description
-  * The intended Geometric Target (used for approach and device creation). You may choose an existing target or create a new structure. For this example we chose the PTV_7920 as the geometric target. The geometric target will be used to define the extents of the aperture (if used) and will be linked to the isocenter position (if target centroid is selected in the approach block).
-  * Also specified here is the //Spot Target// (PBS only), which will be used to define the extent of the pbs spot placements for the beam. The spot target can either match the geometric target, or the user can choose to use the target for the fraction group in which the beam is used (this is a useful option as it allows the same geometric beam to be used in multiple fraction groups by simply recomputing the spot positions based on the fraction group target). {{ :planning:userguide:tutorials:pbs_select_target.png?500 |}}
+=== PBS specific ===
+For PBS beams the following additional options will be available:
+  * //**Geometric Target**// is used for approach and device creation. You may choose an existing target or create a new structure. For this example we chose the PTV_7920 as the geometric target. The geometric target will be used to define the extents of the aperture (if used) and will be linked to the isocenter position (if target centroid is selected in the approach block).
+  * //**Spot Target**// is used to define the extent of the PBS spot placements for the beam. The spot target can either match the geometric target, or the user can choose to use the target for the fraction group in which the beam is used (useful for allowing the same geometric beam to be used in multiple fraction groups by simply recomputing the spot positions based on the fraction group target). {{ :planning:userguide:tutorials:pbs_select_target.png?500 |}}
+=== SOBP specific ===
+For SOBP beams the following additional options will be available:
+  * //**Target**// is used for approach and device creation, and it can be either a structure or an existing beam.
+{{ :planning:userguide:tutorials:sobp_beam_general_settings_target_selection.png?300 |}}
+  * If the target selected is an existing beam, the new beam becomes a //**Patch beam**//. Thus, the targeted beam becomes a parent thru-beam of the current patch beam (child).
+    * The patch dose field box is then enabled, allowing users to enter a dose value amount. The parent beam's target will reduced such that any portion receiving a dose from the parent beam that is greater than this amount will be ignored when designing the patch beam range compensator. In other words, the target of the patch beam becomes the target of the parent beam, minus the volume enclosed by the isodose surface (compute only for parent beam) at the defined patch dose value. This patch beam target can be viewed in the Display UI and toggled on and off in the right hand side beam controls.
+    * Patch beams can also be "chained" beyond a single parent-child pair by creating a beam and selecting the desired patch beam as the target.
+    * Also note, that once a beam is designated as a patch and added to a fraction group, it cannot be changed back to a standard non-patch beam. In such cases, you must either remove the beams from the Fraction Group first, or a new SOBP beam must be created.
 ==== Beam Approach ====
@@ Line 31: / Line 50: @@
 ==== Apertures ====
-If desired, add an aperture in the //Aperture// block. (No //Aperture// was chosen in this example)
+An option to add an aperture can be found within the //Aperture// block. An //Aperture// was not chosen in the PBS beam example. Although selecting an aperture is optional for PBS beam plans, selecting an aperture is **required for SOBP beam** plans.
-  - Refer to [[planning:userguide:tutorials:apertures|Creating a New Aperture]] for detailed instruction
+  * Refer to [[planning:userguide:tutorials:apertures|Creating a New Aperture]] for detailed instruction
 ==== Shifters (PBS) ====
@@ Line 38: / Line 57: @@
 The Range Shifter block is only available for PBS treatment modes.
-    - If desired, select the range //Shifter// to use based on the ones available for the selected snout. If no //Shifter// is needed as in the example given, the user may go to the next step
+    * If desired, select the range //Shifter// to use based on the ones available for the selected snout. If no //Shifter// is needed as in the example given, the user may go to the next step
 ==== Air Gap ====
@@ Line 48: / Line 67: @@
 The Spot Placement block is only available for PBS treatment modes.
-    - With the beam positioned and any beamline devices put in place, the user is ready view the PBS Spots and adjust the //Spot Placement// values if needed. The //Spot Placement// box, if chosen, will allow the user to set new parameters, overriding the spot placement parameters for this one beam if desired. The example below illustrates the message shown when using the spot placement values from the plan level.
+    * With the beam positioned and any beamline devices put in place, the user is ready view the PBS Spots and adjust the //Spot Placement// values if needed. The //Spot Placement// box, if chosen, will allow the user to set new parameters, overriding the spot placement parameters for this one beam if desired. The example below illustrates the message shown when using the spot placement values from the plan level.
 ==== Proton DRRs ====
 Proton DRRs do not impact the beam and are used purely for visualization purposes so that you can set the DRR Options to levels that generate appropriate anatomy visualizations. An example DRR is shown below. Note that Astroid allows you to define 2 distinct DRRs and then blend them together using a simple weight factor to create a single DRR image on the screen. This gives users the freedom to create high contrast, high quality DRR visualizations.  A single image was used in the example below as the second set of DRR options has the weight set to 0. {{ :planning:userguide:tutorials:pbs_drr_options.png?300 |}}