GUI to analyze the results of a Monte-Carlo radiation simulation
A GUI to simplify and streamline the plotting and analysis of medical physics simulations
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 topasgraphsim
Or, if your Python is added to $PATH, simply run:
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!
Visit the wiki for detailed information!
- 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 EGS and RadCalc simulation results *
- Import of custom measurements (as numpy .txt files)
- Import of PTW tbaScan (MEPHYSTO mc2) measurements
- German and english language support
- Dark mode
(*) Not yet implemented
Depending on the imported measurement, the following parameters can be calculated:
|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.
Release history Release notifications | RSS feed
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Hashes for topasgraphsim-25.1.1-py3-none-any.whl