Differences

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

--- planning:userguide:tutorials:pbs_beams [2017/02/08 21:56] – 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 and including an aperture and range shifter, is given below to illustrate the features available when defining a beam.
+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.
-FIXME : below here needs updating to match the description given above.
+===== Treatment Room & Mode Type (SOBP or PBS) =====
-  - From within the //Plan Overview// select the //Beams// block {{ :planning:userguide:tutorials:pbs_choose.png?300 |}}
+  - Within the //Plan Overview// select the //Beams// block
-  - Select the treatment room from the drop down then click the blue //OK// button {{ :planning:userguide:tutorials:pbs_tx_room_1.png?300 |}}
+  - From this interface you can select the treatment room, including the treatment mode {{ :planning:userguide:tutorials:pbs_tx_room_1.png?300 |}}
-  - Next select the //Spot Placement Parameters//. You may either choose to go with the default parameters or enter your own parameters {{ :planning:userguide:tutorials:pbs_spot_placement_parameters.png?300 |}}
+  - 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
-  - Once your //Spot Placement Parameters// are set the //Create New PBS Beam// button will become active {{ :planning:userguide:tutorials:pbs_create_beam.png?300 |}}
-  - After you select the //Create New PBS Beam// you will be able to set the beam geometry parameters:
-    - In the //General// block select the intended target from the dropdown. You may choose an exisiting target or create a new structure. {{ :planning:userguide:tutorials:pbs_select_target.png?300 |}}
-    - In the //Approach// block select the Isocenter from the dropdown. You will also enter the gantry angle and couch angle. You may do so by typing in the angle or use the sliders {{ :planning:userguide:tutorials:pbs_approach.png?300 |}}
-    - The next block is the //Snout// block. A list of snouts associated with your chosen treatment machine will be available to choose from {{ :planning:userguide:tutorials:pbs_snout.png?300 |}}
-    - If desired, add an aperture in the //Aperture// block
-     - Refer to [[planning:userguide:tutorials:apertures|Creating a New Aperture]] for detailed instruction
-    - If desired, select the range shifter to use based on the ones available for the selected snout
-    - Set the air gap distance {{ :planning:userguide:tutorials:pbs_geometry.png?300 |}}
+===== Beam Creation =====
+  * The next step is to create the beam by clicking the:
+    * //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:
+  * 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 |}}