TopasGraphSim
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.
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 mc2) 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 | 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
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!
1 maintainer
Metadata
1 maintainer
Release files for topasgraphsim 27.0.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| topasgraphsim-27.0.1.tar.gz | 105.2 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| topasgraphsim-27.0.1-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 237.0 kB
Release files / topasgraphsim-27.0.1.tar.gz
| Download URL | topasgraphsim-27.0.1.tar.gz |
|---|---|
| Size | 105.2 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
8aa8dee3ffe9634e9db385602d1c566df3d099a2c1a2461cf787b2c3998f234a
|
|
BLAKE2b-256 checksum How to use checksums |
d97290cc7513ce9fe45a634959c06b3eaea6ff9dff75abf7a6f90adeff31b6a1
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/5.0.0 CPython/3.11.5
|
Release files / topasgraphsim-27.0.1-py3-none-any.whl
| Download URL | topasgraphsim-27.0.1-py3-none-any.whl |
|---|---|
| Size | 131.7 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
ab0a396e1b1428521e79f4d1cc4e4b61fc7b1810d3d7b86f812f530755e60c24
|
|
BLAKE2b-256 checksum How to use checksums |
98e3bd65280b59ce3919ecdfec160e4afa1bcecc624fa2398d2e9160c6bf5fcc
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/5.0.0 CPython/3.11.5
|
