<p align="center">TopasGraphSim</p>

<p align="center">A GUI to simplify and streamline the plotting and analysis of medical physics simulations</p>

<p align="center"> <img src="https://user-images.githubusercontent.com/87897942/152699152-d4d39654-4449-4354-b899-4adc81eb25a7.png" width="320" height="160" /> </p>

This GUI can visualize and analyze percentage depth dose (pdd) and dose profiles (dp) simulations from TOPAS. Depth dose measurements are assumed to be in the z-direction, dose profiles in the x- or y-directions. Data read-in is handled by topas2numpy.

Installation

Install using pip:

$ pip install topasgraphsim     

Then, start the GUI by running:

$ python -m topasgraphsim

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

$ topasgraphsim

Open compatible files from the command line:

$ topasgraphsim "path_to_your_file"

Since all my testing in done on Windows 11, I cannot guarantee ToapsGrapSim will work on any other plattform. I'm open to suggestions or PRs making the software work better cross-plattfrom!

Features

Visit the wiki for detailed information!

Highlights include:

• Reproducible graphing and analysis of 1D TOPAS simulation for medical physics
• Simultaneous plotting and parameter calculation for all data sets
• Calculation of the Gamma Index with adjustable parameters
• Graph adjustment options
  • Normalization (On/Off)
  • Error bars (On/Off)
  • Graph order and colors
  • Marker size and style
  • Line width
• Drag and drop of files
• Center axis deviation correction
• Import of RadCalc OAR and PDD data, RayStation and Eclipse depth doses and dose profiles, and Slicer line profiles
• Import of custom measurements (as numpy .txt files)
• Import of PTW tbaScan (MEPHYSTO mc²) measurements
• German and english language support
• Dark mode

Screenshots

Parameters

Depending on the imported measurement, the following parameters can be calculated:

| Measurement type | Parameters | | | | | | | ---------------- | :--------: | :---------------: | :--------------------: | :-------------------: | :------------: | :------------: | | | | | | | | | | Depth dose | Q-Factor | z_max | | | | | | | | | | | | | | Dose profile | FWHM | CAX_dev | FLAT_Krieger | FLAT_stddev | Penumbra (L&R) | Integral (L&R) |

• Q-Factor : Radiation Quality Factor

• z_max : Depth at Maximum

• FWHM : Full-Width at Half-Maximum

• CAX_dev : Centre Axis Deviation

• FLAT_Krieger : Flatness of Dose Plateau (Definition by Krieger)

• FLAT_stddev : Flatness of Dose Plateau (Standard Deviation)

• Penumbra (L&R) : Width of Left and Right Penumbra

• Integral (L&R) : Integral below Left and Right Penumbra

Dependencies

The UI is based on the customtkinter library.

Requires python3, numpy, scipy, matplotlib, Pillow, python-opencv, pynput, requests, topas2numpy, and python-tkdnd.

Contact me!

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