Skip to main content

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

Project description

  


Welcome to the brand new DVH Analytics (DVHA), rewritten as a native OS application with wxPython. The previous web-based version can be found here but is no longer being developed.

DVHA Executables

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.

About

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.

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
  • create time-series plots of various planning and dosimetric variables
  • calculate correlations
  • generate multi-variable linear and machine learning regressions.
  • additional screenshots available here

The code is built upon 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 - Extensible radiation therapy research platform and viewer for DICOM and DICOM RT
  • Bokeh - Interactive Web Plotting for Python
  • scikit-learn - Machine Learning in Python

Installation

To install via pip:

pip install dvha

If you've installed via pip or setup.py, launch from your terminal with:

dvha

If you've cloned the project, but did not run the setup.py installer, launch DVHA with:

python dvha_app.py

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.

Dependencies

Support

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.

Cite

DOI: https://doi.org/10.1002/acm2.12401
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.

Related Publications

DOI: https://doi.org/10.1016/j.adro.2019.11.006
Roy A, Cutright D, Gopalakrishnan M, Yeh AB, and Mittal BB. "A Risk-Adjusted Control Chart to Evaluate IMRT Plan Quality." Advances in Radiation Oncology (2019).

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: https://doi.org/10.1016/j.ijrobp.2019.06.2509
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.7.2.post2.tar.gz (1.3 MB view details)

Uploaded Source

Built Distribution

dvha-0.7.2.post2-py3-none-any.whl (1.3 MB view details)

Uploaded Python 3

File details

Details for the file dvha-0.7.2.post2.tar.gz.

File metadata

  • Download URL: dvha-0.7.2.post2.tar.gz
  • Upload date:
  • Size: 1.3 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/1.13.0 pkginfo/1.5.0.1 requests/2.22.0 setuptools/41.6.0 requests-toolbelt/0.9.1 tqdm/4.32.2 CPython/3.7.5

File hashes

Hashes for dvha-0.7.2.post2.tar.gz
Algorithm Hash digest
SHA256 dab57361de93dfae2d905499d0c44b699966e5b019f2168b5c8d18e24be4fb76
MD5 dba8773df886c294e31b4170767dfe7f
BLAKE2b-256 0b7c48019dfce4027d74990a974daf6fea9474b83e6080e4ae68e0e47ac421bf

See more details on using hashes here.

File details

Details for the file dvha-0.7.2.post2-py3-none-any.whl.

File metadata

  • Download URL: dvha-0.7.2.post2-py3-none-any.whl
  • Upload date:
  • Size: 1.3 MB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/1.13.0 pkginfo/1.5.0.1 requests/2.22.0 setuptools/41.6.0 requests-toolbelt/0.9.1 tqdm/4.32.2 CPython/3.7.5

File hashes

Hashes for dvha-0.7.2.post2-py3-none-any.whl
Algorithm Hash digest
SHA256 2d1104394fe6dfe4c9c7904e25edc8402271f8a8872f504d5ab95616641b0b22
MD5 18b445cd9a65aa0aaeb3353d2e3886ba
BLAKE2b-256 fdc29f40402b96116322c87c1bafa2f26b3b54c9d8d799c27b92a50dc3d5c6c6

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page