Metadata-Version: 2.1
Name: topasgraphsim
Version: 3.0
Summary: GUI to plot the results of a topas simulation
Home-page: https://github.com/sebasj13/topas-create-graphs
Author: Sebastian Schäfer
Author-email: sebastian.schaefer@student.uni-halle.de
License: UNKNOWN
Project-URL: Bug Tracker, https://github.com/sebasj13/topas-create-graphs/issues
Keywords: topas,monte-carlo,python,simulation
Platform: UNKNOWN
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE

# topasgraphsim

## A script to automatically plot the results of a topas simulation

Works for percentage depth dose (pdd) and dose profiles (dp). Depth dose measurements are assumed to be in the z-direction, dose profiles in the x- or y-directions.
Language is in german.

## Installation

Install using <b>pip install topasgraphsim</b>. Then, start the GUI by running:

<img src="https://user-images.githubusercontent.com/87897942/149929356-790ad05e-1d99-4999-a5ae-35b8da894c38.png"  width="300" height="75" />

## Automatically calculates relevant parameters

| Measurement type | Parameters |         |              |             |                |                 |
|------------------|:----------:|:-------:|:------------:|:-----------:|:--------------:|:---------------:|
|                  |            |         |              |             |                |                 |
| Depth dose       |  Q-Factor  |  z<sub>max</sub>  |              |             |                |                 |
|                  |            |         |              |             |                |                 |
| Dose profile     |    FWHM    | CAX<sub>dev</sub>  | FLAT<sub>Krieger</sub>  | FLAT<sub>stddev</sub>  | Penumbra (L&R) | Integral (L&R)  |

- Q-Factor : Radiation Quality Factor
- z<sub>max</sub> : Depth at Maximum

- FWHM : Full-Width at Half-Maximum
- CAX<sub>dev</sub> : Centre Axis Deviation
- FLAT<sub>Krieger</sub> : Flatness of Dose Plateau (Definitionby Krieger)
- FLAT<sub>stddev</sub> : Flatness of Dose Plateau (Standard Deviation)
- Penumbra (L&R) : Width of Left and Right Penumbra
- Integral (L&R) : Integral below Left and Right Penumbra

### Assumes a ".csv" input file format from a TOPAS Scorer with the following header format:

\# TOPAS Version: {...}  
\# Parameter File: {...}.txt  
\# Results for scorer {...}  
\# Scored in component: {...}  
\# X in {...} bin of {...} cm  
\# Y in 1 {...} of {...} cm  
\# Z in {...} bins of {...} cm  
\# DoseToMedium ( Gy ) : {Sum/Mean}   Standard_Deviation     
Voxel Coordinate X, Voxel Coordinate Y, Voxel Coordinate Z, {Sum/Mean} Value, Standard_Deviation Value   
                 .   
                 .   
                 .   
## Dependencies

Uses the beautiful Azure-ttk dark theme by @rdbende.
Requires python3, numpy, scipy, matplotlib, Pillow, python-opencv, pywin32, and tkinter.


