Differences

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

--- planning:userguide:tutorials:pbs_beams [2017/06/27 18:21] – [Creating a PBS Beam] kmobile
+++ planning:userguide:tutorials:pbs_beams [2021/07/29 18:28] (current) – external edit 127.0.0.1
@@ Line 1: / Line 1: @@
-====== Creating a PBS Beam ======
+====== Proton Beams ======
 Defining treatment beams will be one of the most important tasks within the Astroid planning system. Defining appropriate beams will require users to use their knowledge and experience to properly select many of the parameters that define a treatment beam. These parameters include the target, geometry (isocenter, gantry and couch angles), beamline devices, air gap, and spot placement options. The //Beam// task utilizes a series of blocks to organize the beam creation process into a common step-by-step sequence. Several blocks are optional as not all beams will use all features. Additionally, it is important to point out that the treatment room & default spot placement parameters are set outside of the individual beam creation tasks as these apply to all beams (however, spot placement parameters can be overridden within each beam if desired). An example of constructing a lateral beam, with the isocenter at the centroid of the PTV is given below to illustrate the features available when defining a beam.
-  - From within the //Plan Overview// select the //Beams// block {{ :planning:userguide:tutorials:pbs_choose.png?300 |}}
+===== Treatment Room & Mode Type (SOBP or PBS) =====
-  - Select the treatment room from the drop down then click the blue //OK// button {{ :planning:userguide:tutorials:pbs_tx_room_1.png?300 |}}
-  - Next select the //Spot Placement Parameters//. Edit these parameters to define the spot placement grid for each beam in the plan, noting that individual beams can override these values during beam creation if you so desire {{ :planning:userguide:tutorials:pbs_spot_placement_parameters.png?300 |}}
+  - Within the //Plan Overview// select the //Beams// block
-  - The next step is to create the beam by clicking the //Create New PBS Beam// button {{ :planning:userguide:tutorials:pbs_create_beam.png?300 |}}
+  - From this interface you can select the treatment room, including the treatment mode {{ :planning:userguide:tutorials:pbs_tx_room_1.png?300 |}}
-  - Now we will proceed step-by-step through the various "blocks" to create a complete beam as shown below:
+  - If the treatment mode is PBS you can then select and define the plan level PBS //Spot Placement Parameters//. Edit these parameters to define the spot placement grid for each beam in the plan, noting that individual beams can override these values during beam creation if you so desire
-    - In the //General// block select the intended //Geometric Target// from the dropdown. 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//, 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 |}}
-    - In the //Approach// block specify the desired isocenter from the dropdown. You may choose to use the centroid of the Geometric Target (as shown below) or you can select or create a new point to define the location for the isocenter. The gantry angle and couch angles are also entered here as well. Editing these values can be done by typing directly in the provided fields or by using the sliders. The patient in this example is feet first so we will use 90 for the //Gantry// angle and 0 for the //Couch Angle// to create a left lateral beam. {{ :planning:userguide:tutorials:pbs_approach.png?300 |}}
+===== Beam Creation =====
-    - The next block is the //Snout// block. A list of snouts associated with the specified treatment room will be available to choose from. The 12cm snout was chosen here. {{ :planning:userguide:tutorials:pbs_snout.png?300 |}}
-    - If desired, add an aperture in the //Aperture// block. (No //Aperture// was chosen in this example)
+  * The next step is to create the beam by clicking the:
-      - Refer to [[planning:userguide:tutorials:apertures|Creating a New Aperture]] for detailed instruction
+    * //Create New PBS Beam// button for use in PBS treatment rooms
-    - 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 {{ :planning:userguide:tutorials:pbs_shifter.png?300 |}}
+    * //Create New SOBP Beam// button for use in SOBP treatment rooms
-    - Once the beam line devices are defined, we can move to specify the //Air Gap// distance. The valid air gap range will be listed based on the selected snout. The user may choose any value in this range. 30mm was chosen in the below example.   {{ :planning:userguide:tutorials:pbs_airgap2.png?300 |}}
+  * Now we will proceed step-by-step through the various "blocks" to create a complete beam as shown below:
-    - 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. {{ :planning:userguide:tutorials:pbs_beam_spot_placement.png?300 |}}
-    - The last block in the //Create Beam// task is the //Proton DRR Options//. These 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 |}}
+==== General Settings ====
+The //**General**// block is used to set general beam details including:
+  * Color, Beam Label (or select //automatically generate label//) and Description
+=== 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 ====
+In the //Approach// block specify the desired isocenter from the dropdown. You may choose to use the centroid of the Geometric Target (as shown below) or you can select or create a new point to define the location for the isocenter. The gantry angle and couch angles are also entered here as well. Editing these values can be done by typing directly in the provided fields or by using the sliders. The patient in this example is feet first so we will use 90 for the //Gantry// angle and 0 for the //Couch Angle// to create a left lateral beam. {{ :planning:userguide:tutorials:pbs_approach.png?300 |}}
+==== Snout ====
+In the snout block a list of snouts associated with the specified treatment room will be available to choose from. Selecting a snout can change what beamline devices are available based on the facility model in the site info.
+==== Apertures ====
+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
+==== Shifters (PBS) ====
+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
+==== Air Gap ====
+Once the beam line devices are defined, we can move to specify the //Air Gap// distance. The valid air gap range will be listed based on the selected snout. The user may choose any value in this range. 30mm was chosen in the below example.
+==== Beam Spot Placements (PBS) ====
+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.
+==== 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 |}}