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.
Install using pip:
$ pip install topasgraphsim Then, start the GUI by running:
$ python -m topasgraphsimOr, if your Python is added to $PATH, simply run:
$ topasgraphsimOpen 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!
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 mc2) measurements
- German and english language support
- Dark mode
Depending on the imported measurement, the following parameters can be calculated:
| Measurement type | Parameters | |||||
|---|---|---|---|---|---|---|
| Depth dose | Q-Factor | zmax | ||||
| Dose profile | FWHM | CAXdev | FLATKrieger | FLATstddev | Penumbra (L&R) | Integral (L&R) |
-
Q-Factor : Radiation Quality Factor
-
zmax : Depth at Maximum
-
FWHM : Full-Width at Half-Maximum
-
CAXdev : Centre Axis Deviation
-
FLATKrieger : Flatness of Dose Plateau (Definition by Krieger)
-
FLATstddev : Flatness of Dose Plateau (Standard Deviation)
-
Penumbra (L&R) : Width of Left and Right Penumbra
-
Integral (L&R) : Integral below Left and Right Penumbra
The UI is based on the customtkinter library.
Requires python3, numpy, scipy, matplotlib, Pillow, python-opencv, pynput, requests, topas2numpy, and python-tkdnd.
Thank you for using TopasGraphSim! Please let me know about any issues you encounter, or suggestions/wishes you might have!
