Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/tbezo/pymcc
module that reads and analyzes mephisto mcc files from watertank scans
https://github.com/tbezo/pymcc
pandas python
Last synced: 3 months ago
JSON representation
module that reads and analyzes mephisto mcc files from watertank scans
- Host: GitHub
- URL: https://github.com/tbezo/pymcc
- Owner: tbezo
- License: mit
- Created: 2021-08-16T11:30:31.000Z (about 3 years ago)
- Default Branch: main
- Last Pushed: 2024-05-30T14:23:51.000Z (5 months ago)
- Last Synced: 2024-06-19T22:14:58.350Z (5 months ago)
- Topics: pandas, python
- Language: Python
- Homepage:
- Size: 98.6 KB
- Stars: 6
- Watchers: 3
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-medphys - pymcc -  Module that reads mephisto mcc files from watertank scans or array files. (Libraries)
README
# pymcc
Module that reads PTW mephisto mcc files from watertank scans or array files. pymcc relies on Pandas
and uses a Pandas DataFrame to store the measurement values within the class objects.
At the moment the tests implemented are the ones used at the University Medical Center Mainz
(mainly the default PTW Data Analyze Varian profile ones). pymcc is able to handle Photon (FF
and FFF) as well as electron water tank measurements, Starcheck (files with options to analyze
the four main profiles) as well as Octavius 729 measurement files (measurement is put into an
interpolated Pandas DataFrame - no further analysis possible).
pymcc was created to analyze mcc files from within [QATrack+](https://github.com/qatrackplus/qatrackplus)
through an upload test that creates a dict (of dicts), followed by composite tests that grab the
individual results from that dict.
Only symmetric fields (X=Y) are validated, asymmetric fields should work.
## Installation
It is now possible to install pymcc with pip directly from github. This should be easier than copying
the source files to your local venv or inside the QATrack+ project folder and will also check the dependencies.
source ~/venvs/qatrack31/bin/activate #optional
pip install git+https://github.com/tbezo/pymcc
If you do not want to have pymcc inside your environment (a.e you customize the code to your needs)
you can also put it inside the QATrack+ directory as described by Randy here:
[Import Code](https://groups.google.com/g/qatrack/c/n5x8osAj0eY/m/yHrQq7HzAQAJ)
## Examples for QATrack+
Using pymcc.wtscans profile and pdd curves can be analyzed.
### Water Tank Profile
*File Upload Test: read_mcc_6x_10x10 (macro name)*
```Python
import pymcc
# read mcc file and return list of measurement objects (PDD and/or Profiles)
mymcc = pymcc.readmcc.read_file(FILE.name)
mcc_dict = {}
for i in mymcc:
mcc_dict[i.curve_type] = i.calc_results()
# provide object dict for composite tests
read_mcc_6x_10x10 = mcc_dict
```
*Access single result from dict in composite test: flat_10x10_x_py (macro name)*
```Python
flat_10x10_x_py = read_mcc_6x_10x10["CROSSPLANE_PROFILE"]["Flatness"]
```
A complete mcc_dict can looks like this (here electrons, 20 x 20 cm²):
{'PDD': {'Type': 'PDD', 'R80': 19.986482881280565, 'R50': {'R50 (DIN)': 24.940544317729188, 'R50': 23.788279990789775}, 'Rp': 29.794591153821518},
'INPLANE_PROFILE': {'Type': 'INPLANE_PROFILE', 'CaxDev': 0.3168300690775254, 'FWHM': {'fwhm (nominal)': 204.02442621763075, 'fwhm': 201.42603042514637}, 'Flatness': 1.9405358627975489, 'Symmetry': 0.9219008965810869},
'CROSSPLANE_PROFILE': {'Type': 'CROSSPLANE_PROFILE', 'CaxDev': 0.49851535225756294, 'FWHM': {'fwhm (nominal)': 203.39409918216086, 'fwhm': 200.8037310515953}, 'Flatness': 1.6065593462425587, 'Symmetry': -0.2758778417071142}}
For a single photon pdd the dict contains the following:
{'PDD': {'Type': 'PDD', 'Q Index': 0.6671976734598629, 'Surface Dose': 47.71301033726637, 'D100': 67.11913960530438, 'D200': 38.52406807977445}}
### Starcheck
*File Upload Test: read_mcc_0_6x (macro name)*
```Python
import pymcc
# read Starcheck mcc file
mystar = pymcc.readmcc.read_file(FILE.name)
# analyze center inplane and crossplane profiles
mcc_dict = mystar.analyze_center()
# provide object dict for composite tests
read_mcc_0_6x = mcc_dict
```
*Access single result from dict in composite test: fs_0_y_py (macro name)*
```Python
fs_0_y_py = read_mcc_0_6x["INPLANE_PROFILE"]["FWHM"]["fwhm"]
```
The two diagonals are labeled TLGR_PROFILE and TRGL_PROFILE. The dict from mystar.analyze_diagonal() looks like this:
{'TLGR_PROFILE': {'Type': 'INPLANE_PROFILE', 'CaxDev': -1.7500384951353993, 'FWHM': {'fwhm (nominal)': 276.49675566173937, 'fwhm': 276.49675566173937}, 'Flatness': 2.118534052326748, 'Symmetry': -0.7116183813665132}, 'TRGL_PROFILE': {'Type': 'INPLANE_PROFILE', 'CaxDev': 0.12798456264559377, 'FWHM': {'fwhm (nominal)': 275.69602807162545, 'fwhm': 275.69602807162545}, 'Flatness': 2.20840822848013, 'Symmetry': -0.8215006262255542}}