Skip to content
Maria edited this page Sep 26, 2024 · 11 revisions

Introduction to the 4D evaluation script

The script can be used to:

  • Automatic 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 by medical physicist Mariafj under the MIT license.
  • Varian Eclipse version 16.1
  • Proton or photon calculation license
  • The project 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.esapi.dll.
  • 1: Choose the treatment plan in the dropdown menu and press Select plan.
  • 2: Define CTV1, CTV2, OAR1, OAR2 and OAR3 and define the prescribed dose to the CTVs and the evaluation dose to the OARs. This part can also be completely skipped.
  • Choose which 3D images that are to be used for each phase in the dropdown menus under '4D image'.
  • 3a: Press 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.
  • 3b: Press Select images if the plan has to be copied to each phase and calculated.
    • Select if the script should try to create/copy the body structure, copy and overwrite all overwritten structures and set the calibration curve on each scan.
    • Press Create plans. All plans are now calculated. This can take a while, and the interface will update after each phase. But have patience. It seems VMAT plans are very slow. Go get some coffee.
  • Use Export DVHs to export DVHs. DVHs will be exported for the main plan and all phases as well as the robust scenarios of the main plan if they exist. The format is the prefered format for the international Protect Esophagus Trial.
  • 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.

Version2 and 3

Clone this wiki locally