Skip to content
Maria edited this page May 19, 2022 · 10 revisions

Introduction to the 4D evaluation script

The script can be used to:

  • Automatical recalculation of a proton, IMRT or VMAT plan on all phases of a 4D
  • Perform a simple evaluation on plans calculated on all phases of a 4D
  • Export of DVHs from the main plan and phase plans.
  • The script is still under development. Each clinic must perform its own quality assurance of script. We do not take responsibility for any bugs or errors that may occur.

Technical requirements

  • Binary Varian ESAPI script developed at the Danish Centre for particle therapy under the MIT license.
  • Varian Eclipse version 16.1
  • Proton or photon calculation license
  • The code must be compiled before it can run.

Workflow

  • Open a treatment plan and place it in a new course. It is a good idea to have unique names for each phase image, however not necessary.
  • Run the script ...\Evaluering4D_v3.esapi.dll.
  • Choose the treatment plan in the dropdown menu and press Select plan.
  • Define CTV1, CTV2 and Spinal cord and define the prescribed dose to the CTVs and the evaluation dose to the OAR. This part can also be completely skipped.
  • Chose which 3D images that is to be used for each phase in the dropdown-menus under 4D image.
  • Press Evaluate: Select images if there already exists plans on the phases and you only wish to evaluate. ** Select the plans for each phase and press Evaluate: Evaluate plans.
  • Press Create and evaluate: Select images if the plan has to be copied to each phase and calculated. ** Use Create and evaluate: Prepare images to select the same calibration curve and structure overwrites as the main CT. The couch structures must be copied to every phase beforehand, the script will only perform the overwrite if the structures exist. This step can be skipped. ** Press Create and evaluate: Create plans. All plans are now calculated. This can take a while, and the interface will freeze. Have patience. It seems VMAT plans are extremely slow. Go get some coffee.
  • Use Export DVHs to export DVHs. They will be exported for all structures and for the robust scenarios of the main plan.
  • The section Errors and messages will write out messages and/or errors.
  • Close the window manually. If there are new plans calculated they have to be saved by the user in the main Eclipse window.

Evaluering4D

Tips, tricks and known issues

  • VMAT plans are very slow.
  • Only the two buttons Create and evaluate: Prepare images and Create and evaluate: Create plans' will write to the database.
  • If AcurosPT is used, the plans will only be copied and not calculated if there is no materials table selected.
  • When 4D phases are automatically found the DCPT specific strings are used. These are defined in the method: SelectPlan_Click.

Incomming update mid 2022

  • GPU calculation for VMAT
  • An extra OAR for evaluation
  • Automatic copy of structures from main plan to 4D phases
  • A progress bar while calculating
  • Add course name to plan name in the selection box
  • Move "edit patient" to the button functions.
Clone this wiki locally