DVH Analytics
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.
Documentation
Be sure to check out the latest release for the user manual PDF, which is geared towards the user interface. For power-users, dvha.readthedocs.io contains detailed documentation for backend tools (e.g., if you want to perform queries with python commands).
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
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
Installation
To install via pip:
$ pip install dvhaIf you’ve installed via pip or setup.py, launch from your terminal with:
$ dvhaIf you’ve cloned the project, but did not run the setup.py installer, launch DVHA with:
$ python dvha_app.pySee 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
Python >3.5
wxPython Phoenix >= 4.0.4, < 4.1.0
Pydicom >=1.4.0
dicompyler-core >= 0.5.4
Bokeh >= 1.2.0, < 2.0.0
PostgreSQL (optional) and psycopg2
Shapely < 1.7.0
Statsmodels >=0.8.0
Scikit-learn >= 0.21.0
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.
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: 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.
1 maintainer
Metadata
1 maintainer
Release files for dvha 0.9.7
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| dvha-0.9.7.tar.gz | 1.2 MB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| dvha-0.9.7-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 2.3 MB
Release files / dvha-0.9.7.tar.gz
| Download URL | dvha-0.9.7.tar.gz |
|---|---|
| Size | 1.2 MB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
3c7234db1634b35d29ac47903a3aae51e08bca95d386d120ab1571fdce82d3cb
|
|
BLAKE2b-256 checksum How to use checksums |
aeda879cce0f9e3419f98ca3f1da7cb01f4d074c79a5db0083d34984cfa76071
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/3.2.0 pkginfo/1.6.1 requests/2.25.0 setuptools/51.0.0 requests-toolbelt/0.9.1 tqdm/4.54.1 CPython/3.6.8
|
Release files / dvha-0.9.7-py3-none-any.whl
| Download URL | dvha-0.9.7-py3-none-any.whl |
|---|---|
| Size | 1.2 MB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
a0ec3db51e587538071a6c4cea182745501eaf9f78cac86432010df717233aed
|
|
BLAKE2b-256 checksum How to use checksums |
7c22b0afeff9e6807f4077979d992baef99e8295e94913254f32ae0957d9bd9e
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/3.2.0 pkginfo/1.6.1 requests/2.25.0 setuptools/51.0.0 requests-toolbelt/0.9.1 tqdm/4.54.1 CPython/3.6.8
|
