Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/cutright/DVH-Analytics
A DICOM Database Application for Radiation Oncology
https://github.com/cutright/DVH-Analytics
bokeh dicom dicompyler machine-learning pydicom radiation-oncology wxpython-phoenix
Last synced: about 1 month ago
JSON representation
A DICOM Database Application for Radiation Oncology
- Host: GitHub
- URL: https://github.com/cutright/DVH-Analytics
- Owner: cutright
- License: other
- Archived: true
- Created: 2019-03-02T23:09:58.000Z (almost 6 years ago)
- Default Branch: master
- Last Pushed: 2022-02-01T16:22:03.000Z (almost 3 years ago)
- Last Synced: 2024-10-13T11:59:41.385Z (2 months ago)
- Topics: bokeh, dicom, dicompyler, machine-learning, pydicom, radiation-oncology, wxpython-phoenix
- Language: Python
- Homepage:
- Size: 39.3 MB
- Stars: 82
- Watchers: 14
- Forks: 30
- Open Issues: 5
-
Metadata Files:
- Readme: README.rst
- Changelog: CHANGELOG.md
- License: LICENSE.txt
Awesome Lists containing this project
- awesome-medphys - DVH-Analytics - (**Deprecated**) A software application for building a local database of radiation oncology treatment planning data. (Applications)
README
DVH Analytics
=============
**NOTE**: DVHA has been archived and is no longer supported. The developers of DVHA and dicompyler have teamed up to form `ONCurate `__.
|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| |Docs| |lgtm-cq| |lgtm| |lines| |repo-size| |code-style|
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
-----
|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
Installation
------------
To install via pip:
.. code-block:: console
$ pip install dvha
If you've installed via pip or setup.py, launch from your terminal with:
.. code-block:: console
$ dvha
If you've cloned the project, but did not run the setup.py installer, launch DVHA with:
.. code-block:: console
$ 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
------------
* `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 `__
* `SQLite3 `__
* `SciPy `__
* `NumPy `__
* `Shapely `__ < 1.7.0
* `Statsmodels `__ >=0.8.0
* `Scikit-image `__
* `Scikit-learn `__ >= 0.21.0
* `regressors `__
* `RapidFuzz `__
* `selenium `__
* `PhantomJS `__
* `DVHA MLC Analyzer `__
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.
Related Publications
--------------------
DOI: `http://doi.org/10.1002/mp.14795 `__
Roy A, Widjaja R, Wang M, Cutright D, Gopalakrishnan M, Mittal BB. "Treatment plan quality control using multivariate control charts." Medical Physics. (2021).
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.
.. |pypi| image:: https://img.shields.io/pypi/v/dvha.svg
:target: https://pypi.org/project/dvha/
:alt: pypi
.. |lgtm-cq| image:: https://img.shields.io/lgtm/grade/python/g/cutright/DVH-Analytics.svg?logo=lgtm&label=code%20quality
:target: https://lgtm.com/projects/g/cutright/DVH-Analytics/context:python
:alt: lgtm code quality
.. |lgtm| image:: https://img.shields.io/lgtm/alerts/g/cutright/DVH-Analytics.svg?logo=lgtm
:target: https://lgtm.com/projects/g/cutright/DVH-Analytics/alerts
:alt: lgtm
.. |Docs| image:: https://readthedocs.org/projects/dvha/badge/?version=latest
:target: https://dvha.readthedocs.io/en/latest/?badge=latest
:alt: Documentation Status
.. |lines| image:: https://img.shields.io/tokei/lines/github/cutright/dvh-analytics
:target: https://img.shields.io/tokei/lines/github/cutright/dvh-analytics
:alt: Lines of code
.. |repo-size| image:: https://img.shields.io/github/languages/code-size/cutright/dvh-analytics
:target: https://img.shields.io/github/languages/code-size/cutright/dvh-analytics
:alt: Repo Size
.. |code-style| image:: https://img.shields.io/badge/code%20style-black-000000.svg
:target: https://github.com/psf/black
:alt: Code style: black
.. |logo| raw:: html
.. |screenshot| raw:: html
