/DVH-Analytics

A DVH Database for Clinicians and Researchers

Primary LanguagePythonOtherNOASSERTION

  fastlane Logo

DVH Analytics

NOTE: We have begun a complete design overhaul using a desktop application framework (wxPython), while continuing to use Bokeh for plotting. Development of the pure Bokeh app has been halted, but we can address bugs if (when) they come up until the new application is ready. DVH Analytics v1.0 will be a desktop application instead of the current web-based application. This will allow for significantly easier distribution. See screen shot of an alpha build below. Public release expected by Fall '19.

  fastlane Logo

DVH Analytics is a software application to help radiation oncology departments build an in-house database of treatment planning data for the purpose of historical comparisons and statistical analysis. This code is still in development. Please contact the developer if you are interested in testing or collaborating.

The application builds a SQL database of DVHs and various planning parameters from DICOM files (i.e., Plan, Structure, Dose). Since the data is extracted directly from DICOM files, we intend to accommodate an array of treatment planning system vendors.

DVH Analytics screenshot

In addition to viewing DVH data, this software provides methods to:

  • download queried data
  • view plan contours
  • create time-series plots of various planning and dosimetric variables
  • calculate correlations
  • and generate multi-variable linear regressions.

The code is built upon these core libraries:

  • pydicom - Read, modify and write DICOM files with python code
  • dicompyler-core - Extensible radiation therapy research platform and viewer for DICOM and DICOM RT
  • Bokeh - Interactive Web Plotting for Python

For installation instructions of the source code, see our installation notes.

Docker

We're working on an easier way to deploy DVH Analytics here.

Some installation challenges with DVH Analytics that are resolved with Docker:

  • Complete DVH Analytics docker image is used.
  • A workaround for this Bokeh bug is applied.
  • Postgres SQL is included (so no need for setting up a database and user access).
  • All three servers for the main, admin, and settings views are started.

Citing DVH Analytics

DOI: https://doi.org/10.1002/acm2.12401
“DVH Analytics: A DVH Database for Clinicians and Researchers,” J. App. Clin. Med. Phys. - JACMP-2018-01083

Dependencies