Skip to main content

Create a database of DVHs, GUI with wxPython, plots with Bokeh

Project description

DVHA logo

DVH Analytics (DVHA) is a software application for building a local database of radiation oncology treatment planning data. It imports data from DICOM-RT files (i.e., plan, dose, and structure), creates a SQL database, provides customizable plots, and provides tools for generating linear, multi-variable, and machine learning regressions.

pypi Documentation Status lgtm code quality lgtm Lines of code Repo Size Code style: black


Be sure to check out the latest release for the user manual PDF, which is geared towards the user interface. For power-users, contains detailed documentation for backend tools (e.g., if you want to perform queries with python commands).


Executable versions of DVHA can be found here. Please keep in mind this software is still in beta. If you have issues, compiling from source may be more informative.


DVH Analytics screenshot

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

  • download queried data

  • create time-series plots of various planning and dosimetric variables

  • calculate correlations

  • generate multi-variable linear and machine learning regressions

  • share regression models with other DVHA users

  • additional screenshots available here

The code is built with these core libraries:

  • wxPython Phoenix - Build a native GUI on Windows, Mac, or Unix systems

  • Pydicom - Read, modify and write DICOM files with python code

  • dicompyler-core - A library of core radiation therapy modules for DICOM RT

  • Bokeh - Interactive Web Plotting for Python

  • scikit-learn - Machine Learning in Python


To install via pip:

$ pip install dvha

If you’ve installed via pip or, launch from your terminal with:

$ dvha

If you’ve cloned the project, but did not run the installer, launch DVHA with:

$ python

See our installation notes for potential Shapely install issues on MS Windows and help setting up a PostgreSQL database if it is preferred over SQLite3.



If you like DVHA and would like to support our mission, all we ask is that you cite us if we helped your publication, or help the DVHA community by submitting bugs, issues, feature requests, or solutions on the issues page.



Cutright D, Gopalakrishnan M, Roy A, Panchal A, and Mittal BB. “DVH Analytics: A DVH database for clinicians and researchers.” Journal of Applied Clinical Medical Physics 19.5 (2018): 413-427.

The previous web-based version described in the above publication can be found here but is no longer being developed.

Selected Studies Using DVHA

5,000 Patients National Cancer Institute (5R01CA219013-03): Active 8/1/17 → 7/31/22 Retrospective NCI Phantom-Monte Carlo Dosimetry for Late Effects in Wilms Tumor Brannigan R (Co-Investigator), Kalapurakal J (PD/PI), Kazer R (Co-Investigator)

265 Patients DOI: Gross J, et al. “Determining the organ at risk for lymphedema after regional nodal irradiation in breast cancer.” International Journal of Radiation Oncology* Biology* Physics 105.3 (2019): 649-658.

Project details

Release history Release notifications | RSS feed

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

dvha-0.9.7.tar.gz (1.2 MB view hashes)

Uploaded source

Built Distribution

dvha-0.9.7-py3-none-any.whl (1.2 MB view hashes)

Uploaded py3

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page