Ctqa

<p align="center"> <a href="" rel="noopener"> <img width=200px height=200px src="https://i.imgur.com/XXOE0B4.png" alt="CTQA logo"></a> </p> <h3 align="center">CTQA</h3> <div align="center">

</div>

---

<p align="center"> This utility aims to perform automated QA testing on CT machines for technologists. <br><br> </p> <p align="center"> <a href="" rel="noopener"> <img src="https://i.imgur.com/hVLmu1X.png" alt="CTQA Demo Image"></a> </p>

Table of Contents

• About
• Feature List
• Getting Started
• Built Using
• Authors
• Acknowledgments

About <a name = "about"></a>

CTQA specializes in identifying the position of a phantom within an image and taking homogeneity measurements specific to the vendor. These measurements are tracked over time and any deviations are sent as notifications to the relevant parties.

For information on the deployment and usage of this system, please consult the wiki.

Please Note: This project requires usage of an Orthanc Server instance to act as an intermediary PACS server for CT machines to submit to.

You can view Orthanc here and download it here.

Feature List <a name = "feature_list"></a>

• Automated Phantom detection
• Automated Homogeneity Testing
• Homogeneity Value Drift Prediction
• Notifications and Reports through email or a custom method
• Configurable homogeneity value limits
• Daily and Weekly Reports
• Subscribe to specific notification levels (Eg: Failures and Warnings only)

Getting Started <a name = "getting_started"></a>

These instructions help you get a copy of the project up and running on your local machine for development and testing purposes.

See the wiki's installation section for notes on how to deploy the project on a live system.

Prerequisites

• Python 3.5+
• An accompanying Pip installation
• Virtualenv (Recommended)

Installing

If you'd like to setup a virtual environment and install all required packages, navigate to the project root and run the following command:

env-setup.bat

Otherwise, install all packages through the standard command:

pip install -r requirements.txt

After the package installations have finished, the application can be launched with the following command:

python run.py

The appropriate configuration files will be generated in the project root during the initial application launch (or if they aren't present). You can choose to follow through with the application's setup or choose to configure manually.

Details for setting up and configuring the utility can be found on the wiki.

Development documentation can be found under "docs/build/html" from the project root.

Compiling the Executable

To compile CTQA, run:

pyinstaller run.spec

or for a binary with a console debug output:

pyinstaller run-debug.spec

Running the tests <a name = "tests"></a>

CTQA currently uses PyTest to check the validity and accuracy of homogeneity tests run. The testing suite can be run with the following command:

pytest

Tests can be found under the "test" directory from the project root.

Built Using <a name = "built_using"></a>

• PyInstaller - Application Wrapper
• Tkinter - Application Framework
• OpenCV - Phantom Detection

Author <a name = "authors"></a>

• @brikwerk

Acknowledgements <a name = "acknowledgement"></a>

• Giampaolo Rodola' for usage of LogWatcher