Sept. 16, 2015
EasyGamma3D User Manual (Ver. 1.0)
1. Introduction EasyGamma3D is a free 3D gamma evaluation tool developed as an extension of an open source project (plastimatch). The EasyGamma3D aims to provide users with convenient graphical user interfaces and fast gamma evaluation by using a batch‐mode. The gamma calculation itself is performed by the plastimatch engine inside of the EasyGamma3D. The software is completely free and the source codes can be downloaded from the plastimatch website (http://plastimatch.org, project name: “gamma_gui”)
2. Features ‐ DICOM‐RT dose file compatible (*.dcm) ‐ ITK meta file compatible (*.mha) ‐ Cross‐platform QT4 application (Tested in win32 / win64 / Linux systems) ‐ Multiple gamma evaluations in a single run ‐ Supports 2D Dose map‐export in IBA‐format (*.opg for Omnipro I’mRT) ‐ Supports workspace file for review the results ‐ Supports Profile view, zoom, pan, normalization for convenient analysis
3. How to run 3.1. Find and run EasyGamma3D_32.exe or EasyGamma3D_64.exe according to a user’s system. ‐ If you use Windows 32‐bit and want to perform batch‐mode evaluations, “low memory option” is recommended to be checked.
1
4. Work flow
A. [Optional] Rename DICOM‐RT dose files originally having long‐number names. [ToolsRename RD Files] will automatically rename those files based on patient ID and Beam number. This function could be useful if the dose file type is BEAM which is hard to sort by the original file name. B. Load reference and comparing dose files C. Set save directory: analysis result will be saved here. D. Set gamma parameters ‐ Inherent resample: This will resample the reference dose file with the specified value (mm) before the gamma calculation. (The compared dose file is by default resampled to the reference dose file inside the gamma calculation.) ‐ Interp‐search: Advanced gamma‐search algorithm proposed by Ju et al. (Med Phys. 2008 Mar;35(3):879‐87). With this option, gamma pass rate would be consistent eliminating the need of resampling. ‐ Local gamma / global gamma: When calculating dose difference (e.g. 3%), local gamma uses the local reference dose while the global gamma uses a specified reference dose (usually Dmax if not specified). 2
‐ DTA/Dose diff(%):Distance‐to‐agreement and dose difference (typical gamma parameters) ‐ Cut‐off dose(%): Points with dose values below this threshold will be excluded in the analysis. ‐ Ref. Dose[Gy]: User‐defined reference dose in Gy. If it remains blank, a maximum dose will be used for it. # Recommendations (to get same 2D results as in IBA‐Omnipro I’mRT) ‐ Inherent resample: 1 mm ‐ Interp‐search: off ‐ Global gamma ‐ Ref. Dose: blank (use maximum dose) E. Run 3D gamma analysis
‐ To see the progress, monitor the (black) console window.
F. Select a preferred result to review
‐ The name in the combo‐box refers to the compared dose file.
‐ Keyboard arrow keys (up / down) can be also used.
‐ If [low memory option] is checked, it takes some time to load a selected result.
G. Review results on the display
‐ g1: Scroll (with scroll‐zoom checked): enable zoom in/out for mouse scroll ‐ g2: Go to a position specified manually. (DICOM coordinate) ‐ g3: Select direction of the dose plane (Axial, Sagittal, and Frontal) ‐ g4: Set normalization dose (For display purpose only. Gamma evaluation is performed based‐ on absolute dose). “NormF” and “apply” button can be used to normalize the compared dose matrix according to the reference dose matrix. ‐ g5: Profile view. The range of the display can be customized in conjunction with “Auto Adjust” option. Unchecking “Normalized” will result in absolute dose‐based display. ‐ g6: Select profile direction ‐ g7: Copy table contents of current profiles. The contents can be pasted to a excel sheet.
‐ Mouse actions: i) Scroll (if scroll‐zoom is not checked): navigate dose planes according to the selection of direction (Axial, Sagittal, Frontal) ii) Right click and Drag: pan iii) Left click: go to a point of interest
3
iV) Left double‐click: go to the middle point automatically H. 3D gamma report for a selected analysis I. Run 2D gamma ‐ A user can perform 2D gamma evaluation for the selected 2D dose plane (the plane displayed). ‐ Gamma parameters (Section D) can be modified if needed. ‐ For each 2D gamma analysis, the result as well as IBA‐I’mRT‐compatible files is saved in a subfolder of “save directory”.
5. Report / load a saved project A typical output folder (=save directory) may look like following. Names of files / directories should not be changed arbitrarily.
A. A brief report for the whole 3D gamma evaluations carried out. ‐ Naming convention: Analysis_yyMMdd_HHMMSS_dta_%_resample~.txt B. Gamma work space file [*.gws] generated after an analysis. To read this file, [FileLoad saved results]
‐ If a memory error occurs (window 32‐bit system with a small memory size), “low memory option” should be checked before opening this file. 4
C. Resampled meta files (*.mha) for reference dose D. Resampled meta files (*.mha) for compared dose E. A directory that contains results of 2D gamma analysis as well as IBA‐compatible *.OPG files. F. A directory that contains individual reports of 3D gamma evaluations.
6. Miscellaneous A. plastimatch gamma (command‐line based method) ‐ EasyGamma3D uses “plastimatch gamma” function inside of it. ‐ For a detailed instruction, users are referred to the plastimatch documentation (http://plastimatch.org/plastimatch.html/) ‐ An example of a command‐line is as follows: plastimatch gamma ‐‐inherent‐resample 1.0 ‐‐dose‐tolerance 0.03 ‐‐dta‐tolerance 3.0 ‐‐analysis‐ threshold 0.1 ‐‐output‐text [text report path] ‐‐output [gamma output path] [Reference dose file path] [Compared dose file path] ‐ A batch mode using command‐line is not yet supported B. Question / bug report / feed‐back Yang Park (
[email protected], 1‐617‐726‐0186)
5