Skip to content

FilmQADose Documentation

FilmQADose Logo

License Python

FilmQADose is an open-source software for the analysis of radiochromic films in radiation therapy QA (Quality Assurance). It provides intuitive calibration tools and dose map generation to promote accessible and efficient quality control.

Development branch: pyside

Key Features 🚀

  • Multiple Calibration Methods: Offers single-channel and multi-channel calibration fits.
  • 2D Dose Map Construction: Build two-dimensional dose maps from scanned film data.
  • Correction Methods: Enhance accuracy and consistency with built-in corrections.
  • Dose Profile & Isodose Visualization: Easily generate dose profiles and isodose lines.
  • TPS Comparison: Compare measured dose maps with those generated by treatment planning systems.

Getting Started 🔧

To set up and run the application locally, make sure you have:

  • Python 3.9+ installed on your system
  • pip for managing Python packages

Installation

  1. Clone the repository: bash git clone -b pyside https://github.com/eduardoh27/FilmQADose.git
  2. Navigate to the project folder: bash cd app
  3. Install dependencies: bash pip install -r requirements.txt

Running the Application ▶️

  1. From the root directory, run: bash python main.py
  2. A GUI window will open, allowing you to interact with FilmQADose.

Contributing 👨‍💻

Contributions are always welcome! You can:

  1. Fork the project.
  2. Create a feature branch (git checkout -b feature/my-new-feature).
  3. Commit your changes (git commit -m 'Add some feature').
  4. Push to the branch (git push origin feature/my-new-feature).
  5. Open a Pull Request.

Feel free to report issues or suggest enhancements on the Issues page.

License ⚖️

This project is licensed under the terms specified in the LICENSE file.
Feel free to use, modify, and distribute it in accordance with the license.