README – QAMgr v0.9.0

Introduction

Welcome to QAManager!
This is a Python package designed to streamline the process of performing Proton Patient QA.
An example screenshot of the graphical interface is shown below.

Quick Reference

The full documentation can be found as described below; please refer to it if you have any trouble with the following abbreviated version of the instructions.

Note: You will need GhostScript installed on your machine in order to use the prepare_report() function.
Mac / Linux users can probably do this using their terminal’s respective package manager, but Windows users will probably need to contact OCF for assistance.

To get up and running quickly, follow these steps:

• Download the package.
• Extract the files into a folder of your choosing – for example, your home directory (this can usually be done by double-clicking the .zip file).
• Open a file browser (for example, Windows Explorer) and navigate to the directory that you chose.
• Run the installer by double-clicking install.py.
• Open a terminal (on Windows, either cmd or powershell).
• Navigate to the folder containing the patient’s RTPlan file.
• Start Python.
• Enter the two Python commands below.
• Enter your initials, select the patient’s RTPLAN file, then click Execute on the steps in order, following any instructions you receive along the way.
  

from qamgr import *
q = GuiQAMgr()

Full Documentation

The complete QAMgr documentation should be included in the doc folder of the extracted package files.
It is also available online here.

~ Dr. Mark J. Duvall, PhD
~ duvall at wustl dot edu
~ Last updated 2025/07/09