TopasDoseCalc

A GUI to merge and scale split-up TOPAS simulations to absolute doses and calculate DVHs

This GUI allows the merging of multiple TOPAS DICOM simulations. This can be useful when a patient plan has been split up into individual simulations of the control points. The merged simulation can then be scaled using a reference calibration simulation and data from the RTPLAN. Finally, DVHs can be automatically created when supplying a RTSTRUCT file.

Installation

Install using pip:

$ pip install topasdosecalc  

Then, start the GUI by running:

$ python -m topasdosecalc

Or, if your Python is added to $PATH, simply run:

$ topasdosecalc

Manual

To use TopasDoseCalc, you need to supply at least five things:

1. A directory containing your TOPAS DICOM simulation results, named after the control point (order is relevant!)
2. A TOPAS dose profile reference simulation. The mean of the values close to the center axis is used as the scale
3. A directory containing at least the relevant RTPLAN file. For DVH calculation, a RTDOSE and RTSTRUCT file is required
4. The histories used for the simulation of each control point (individual, not total)
5. A new series description for the merged DICOM

If you supplied a RTDOSE and RTSTRUCT file, you can select the structures for which to calculate a DVH. This can be useful as an initial validation of the simulation results.

Note: The program assumes 1 MU to be equivalent to 1cGy. If this doesn't apply to your case, scale the histories per simulation by the relevant amount.

Screenshots

Dependencies

Built using the beautiful Azure-ttk theme by @rdbende. Requires python3, numpy, matplotlib, pydicom and dicompyler-core.

Contact me!

Thank you for using TopasDoseCalc! Please let me know about any issues you encounter, or suggestions/wishes you might have!