Documentation/Nightly/Modules/DoseVolumeHistogram - Revision history

Lasso: Moved to https://github.com/slicerrt/slicerrt

2026-01-04T20:41:00Z

Moved to https://github.com/slicerrt/slicerrt

Grundlett: Text replacement - "\[http:\/\/www\.slicer\.org\/slicerWiki\/index\.php\/([^ ]+) ([^]]+)]" to "$2"

2019-11-27T02:25:10Z

Text replacement - "\[http:\/\/www\.slicer\.org\/slicerWiki\/index\.php\/([^ ]+) ([^]]+)]" to "$2"

Pinter: Add tutorial

2019-07-24T12:28:51Z

Add tutorial

Pinter at 16:37, 25 October 2018

2018-10-25T16:37:51Z

Pinter: Update screenshots

2018-10-25T16:34:44Z

Update screenshots

Pinter: Add DVH nodes architectures diagram

2018-10-24T18:41:12Z

Add DVH nodes architectures diagram

Hillarylia: Minor formatting edits

2016-05-12T18:14:21Z

Minor formatting edits

Pinter at 17:02, 5 November 2013

2013-11-05T17:02:06Z

Pinter: Added link to SlicerRT home

2013-08-26T21:47:59Z

Added link to SlicerRT home

Pinter: Added OCAIRO logo

2013-08-14T19:27:24Z

Added OCAIRO logo

← Older revision		Revision as of 20:41, 4 January 2026
Line 1:		Line 1:
−	~~<noinclude>{{documentation/versioncheck}}</noinclude>~~	+	Moved to https://github.com/slicerrt/slicerrt
−	~~<!-- ---------------------------- -->~~
−	~~{{documentation/{{documentation/version}}/module-header}}~~
−	~~<!-- ---------------------------- -->~~
−
−	~~<!-- ---------------------------- -->~~
−	~~{{documentation/{{documentation/version}}/module-section\|Introduction and Acknowledgements}}~~
−	~~{{documentation/{{documentation/version}}/module-introduction-start\|{{documentation/modulename}}}}~~
−	~~{{documentation/{{documentation/version}}/module-introduction-row}}~~
−	This work is part of the SparKit project, funded by An Applied Cancer Research Unit of Cancer Care Ontario with funds provided by the Ministry of Health and Long-Term Care and the Ontario Consortium for Adaptive Interventions in Radiation Oncology (OCAIRO) to provide free, open-source toolset for radiotherapy and related image-guided interventions.<br>
−	~~Author: Csaba Pinter (PerkLab, Queen's University)<br>~~
−	~~Contact: Csaba Pinter, <email>pinter@cs.queensu.ca</email><br>~~
−	~~[[Documentation/Nightly/Extensions/SlicerRT\|Back to SlicerRT home]]~~
−	~~{{documentation/{{documentation/version}}/module-introduction-row}}~~
−	~~{{documentation/{{documentation/version}}/module-introduction-logo-gallery~~
−	~~\|{{collaborator\|logo\|cco}}\|{{collaborator\|longname\|cco}}~~
−	~~\|{{collaborator\|logo\|sparkit}}\|{{collaborator\|longname\|sparkit}}~~
−	~~\|{{collaborator\|logo\|ocairo}}\|{{collaborator\|longname\|ocairo}}~~
−	}}
−	~~{{documentation/{{documentation/version}}/module-introduction-end}}~~
−
−	~~<!-- ---------------------------- -->~~
−	~~{{documentation/{{documentation/version}}/module-section\|Module Description}}~~
−	The {{documentation/modulename}} module enables the user to compute and display the DVH curve from a dose volume and structure (set). DVH metrics, such as volume, minimum, maximum and mean dose, Vdose (the volume that is radiated by a dose greater than a specified dose), and Dvolume (the minimum dose in the most exposed portion of a certain volume in a structure) can be also computed.
−
−	The dimensions of the 3D elements (voxels) describing delineated structures are derived from the selected dose distribution volume, in which the voxels have width in the transverse imaging plane as described in the DICOM image header. The image set volume is defined by a grid of voxels derived from the voxel grid in the dose volume. The dose grid is oversampled by a factor currently fixed to the value 2. The centre of each voxel is examined and if found to lie within a structure, is included in the volume for that structure. The dose value at the centre of the cube is interpolated in 3D from the dose grid.
−
−	~~<!-- ---------------------------- -->~~
−	~~{{documentation/{{documentation/version}}/module-section\|Use Cases}}~~
−	~~Evaluate single or accumulated dose distributions against target structures and organs at risk (OARs)~~
−
−	~~{\|align="center"~~
−	~~\|[[File:20181025_DVH_Screenshot_ModulePanel.png\|thumb\|572px\|Dose Volume Histogram module UI]]~~
−	~~\|[[File:20181025_DVH_Screenshot_Viewers.png\|thumb\|853px\| Dose volume histogram views using SlicerRT]]~~
−	\|}
−
−	~~<!-- ---------------------------- -->~~
−	~~{{documentation/{{documentation/version}}/module-section\|Tutorials}}~~
−	* See workflow tutorials involving DVH on the [[Documentation/Nightly/Extensions/SlicerRT#Tutorials\|SlicerRT main page]]
−	* [https://github.com/~~SlicerRt/SlicerRtDoc/blob/master/tutorials/SlicerRT_Tutorial_DoseSurfaceHistogram.pptx Dose surface histogram tutorial]~~
−
−	~~<!-- ---------------------------- -->~~
−	~~{{documentation/{{documentation/version}}/module-section\|Panels and their use}}~~
−	* '''Input'''
−	** '''Dose volume:''' The dose distribution using which the DVH is computed and the structure labelmap is created if necessary. All the volumes present in the Slicer scene appear here, however, when selecting a volume that has not been created by a SlicerRT module (such as DicomRtImport or DoseAccumulation), a warning will be displayed. If using such a volume, it is assumed not to contain dose values, so an Intensity Volume Histogram is created.
−	** '''Structure set:''' A contour or a contour hierarchy can be selected for which the DVH tables are computed. In case of a hierarchy, the DVH is computed for every contained contour.
−	** '''Dose surface histogram:''' If checked, then dose surface histogram (DSH) is calculated instead of a DVH. A current limitation is that open contours are not supported, so for example rectum structure bottom and top is considered.
−	* '''Output'''
−	** '''Show/hide all:''' After computing histograms, this checkbox adds or removes every histogram from the chart
−	** '''Switch layout:''' Switch layout to "four-up quantitative interactive" or "one-up quantitative interactive" so that DVH/DSH chart is visible
−	** '''DVH table'''
−	*** '''Checkbox:''' show/hide that specific structure in the selected chart
−	*** Structure data and computed DVH metrics appear in the columns
−	* '''Advanced options'''
−	** '''V metric for dose values:''' Values can be entered separated by commas. If 'cc' or '%' is checked, then the V metric for all structures according the entered values will appear in the DVH table in the checked unit(s)
−	** '''D metric for volumes:''' Values can be entered separated by commas in either ccs or percents. If 'Gy' is checked then the D metric for the entered volumes are displayed in the DVH table
−	** '''Export DVH to file:''' The currently plotted DVH tables are saved in CSV format
−	** '''Export DVH metrics to file:''' The currently displayed DVH table can be exported in CSV format
−
−	~~<!--~~
−	~~{{documentation/{{documentation/version}}/module-parametersdescription}}~~
−	~~-->~~
−
−	~~<!-- ---------------------------- -->~~
−	~~{{documentation/{{documentation/version}}/module-section\|Similar Modules}}~~
−	* DVH Comparison
−
−	~~<!-- ---------------------------- -->~~
−	~~{{documentation/{{documentation/version}}/module-section\|References}}~~
−	* Pinter, C.; Lasso, A.; Wang, A.; Jaffray, D. & Fichtinger, G. SlicerRT: Radiation therapy research toolkit for 3D Slicer Med. Phys., 2012, 39(10), 6332/7
−	* Ebert, M. A.; Haworth, A.; Kearvell, R.; Hooton, B.; Hug, B.; Spry, N. A.; Bydder, S. A. & Joseph, D. J. Comparison of DVH data from multiple planning systems Phys. Med. Biol., 2010, 55, N337–N346
−	* Drzymala, R. E.; R. Mohan, l. B.; Chu, J.; Goitein, M.; Harms, W. & Urie, M. Dose-Volume Histograms Radiation Oncology Biol. Phys., 1991, 21, 71-78
−
−	~~<!-- ---------------------------- -->~~
−	~~{{documentation/{{documentation/version}}/module-section\|Information for Developers}}~~
−	~~{\|align="left"~~
−	~~\|[[File:20181024_DVH_NodesArchitecture.png\|thumb\|447px\|Dose Volume Histogram nodes architecture]]~~
−	\|}
−
−	~~<!-- ---------------------------- -->~~
−	~~{{documentation/{{documentation/version}}~~/~~module-footer}}~~
−	~~<!-- ---------------------------- -->~~

@@ Line 11: / Line 11: @@
 Author: Csaba Pinter (PerkLab, Queen's University)<br>
 Contact: Csaba Pinter, <email>pinter@cs.queensu.ca</email><br>
-[http://www.slicer.org/slicerWiki/index.php/Documentation/Nightly/Extensions/SlicerRT Back to SlicerRT home]
+[[Documentation/Nightly/Extensions/SlicerRT|Back to SlicerRT home]]
 {{documentation/{{documentation/version}}/module-introduction-row}}
 {{documentation/{{documentation/version}}/module-introduction-logo-gallery
@@ Line 37: / Line 37: @@
 <!-- ---------------------------- -->
 {{documentation/{{documentation/version}}/module-section|Tutorials}}
-* See workflow tutorials involving DVH on the [http://www.slicer.org/slicerWiki/index.php/Documentation/Nightly/Extensions/SlicerRT#Tutorials SlicerRT main page]
+* See workflow tutorials involving DVH on the [[Documentation/Nightly/Extensions/SlicerRT#Tutorials|SlicerRT main page]]
 * [https://github.com/SlicerRt/SlicerRtDoc/blob/master/tutorials/SlicerRT_Tutorial_DoseSurfaceHistogram.pptx Dose surface histogram tutorial]

@@ Line 37: / Line 37: @@
 <!-- ---------------------------- -->
 {{documentation/{{documentation/version}}/module-section|Tutorials}}
-See [http://www.slicer.org/slicerWiki/index.php/Documentation/Nightly/Extensions/SlicerRT#Tutorials SlicerRT main page]
+* See workflow tutorials involving DVH on the [http://www.slicer.org/slicerWiki/index.php/Documentation/Nightly/Extensions/SlicerRT#Tutorials SlicerRT main page]
 <!-- ---------------------------- -->

@@ Line 44: / Line 44: @@
 ** '''Dose volume:''' The dose distribution using which the DVH is computed and the structure labelmap is created if necessary. All the volumes present in the Slicer scene appear here, however, when selecting a volume that has not been created by a SlicerRT module (such as DicomRtImport or DoseAccumulation), a warning will be displayed. If using such a volume, it is assumed not to contain dose values, so an Intensity Volume Histogram is created.
 ** '''Structure set:''' A contour or a contour hierarchy can be selected for which the DVH tables are computed. In case of a hierarchy, the DVH is computed for every contained contour.
 * '''Output'''
-** '''Chart:''' A chart can be created or selected in which the DVH plots are added
+** '''Show/hide all:''' After computing histograms, this checkbox adds or removes every histogram from the chart
-** '''Show/hide all:''' After computing histograms and a chart, this checkbox adds or removes every histogram from the selected chart
+** '''Switch layout:''' Switch layout to "four-up quantitative interactive" or "one-up quantitative interactive" so that DVH/DSH chart is visible
 ** '''DVH table'''
 *** '''Checkbox:''' show/hide that specific structure in the selected chart
@@ Line 62: / Line 63: @@
 <!-- ---------------------------- -->
 {{documentation/{{documentation/version}}/module-section|Similar Modules}}
-N/A
+* DVH Comparison
 <!-- ---------------------------- -->
 {{documentation/{{documentation/version}}/module-section|References}}
 * Ebert, M. A.; Haworth, A.; Kearvell, R.; Hooton, B.; Hug, B.; Spry, N. A.; Bydder, S. A. & Joseph, D. J. Comparison of DVH data from multiple planning systems Phys. Med. Biol., 2010, 55, N337–N346
 * Drzymala, R. E.; R. Mohan, l. B.; Chu, J.; Goitein, M.; Harms, W. & Urie, M. Dose-Volume Histograms Radiation Oncology Biol. Phys., 1991, 21, 71-78

@@ Line 31: / Line 31: @@
 {|align="center"
-|[[File:SlicerRT0.10_DvhModuleUi.png|thumb|447px|Dose Volume Histogram module UI]]
+|[[File:20181025_DVH_Screenshot_ModulePanel.png|thumb|572px|Dose Volume Histogram module UI]]
-|[[File:SlicerRT_0.12_DoseVolumeHistogram_Ent_AllStructures.png|thumb|800px| Dose volume histogram views using SlicerRT]]
+|[[File:20181025_DVH_Screenshot_Viewers.png|thumb|853px| Dose volume histogram views using SlicerRT]]
 |}

@@ Line 72: / Line 72: @@
 <!-- ---------------------------- -->
 {{documentation/{{documentation/version}}/module-section|Information for Developers}}
-Custom attributes:
+{|align="left"
-* DoseVolumeHistogram.DoseVolumeNodeId: Reference from the DVH array node to the dose volume that was used to create that array
+|[[File:20181024_DVH_NodesArchitecture.png|thumb|447px|Dose Volume Histogram nodes architecture]]
-* DoseVolumeHistogram.CreatedDvhNodeId: Reference from a contour node to the DVH array node
+|}
 <!-- ---------------------------- -->
 {{documentation/{{documentation/version}}/module-footer}}
 <!-- ---------------------------- -->

@@ Line 41: / Line 41: @@
 <!-- ---------------------------- -->
 {{documentation/{{documentation/version}}/module-section|Panels and their use}}
-* Input
+* '''Input'''
-** Dose volume: The dose distribution using which the DVH is computed and the structure labelmap is created if necessary. All the volumes present in the Slicer scene appear here, however, when selecting a volume that has not been created by a SlicerRT module (such as DicomRtImport or DoseAccumulation), a warning will be displayed. If using such a volume, it is assumed not to contain dose values, so an Intensity Volume Histogram is created.
+** '''Dose volume:''' The dose distribution using which the DVH is computed and the structure labelmap is created if necessary. All the volumes present in the Slicer scene appear here, however, when selecting a volume that has not been created by a SlicerRT module (such as DicomRtImport or DoseAccumulation), a warning will be displayed. If using such a volume, it is assumed not to contain dose values, so an Intensity Volume Histogram is created.
-** Structure set: A contour or a contour hierarchy can be selected for which the DVH tables are computed. In case of a hierarchy, the DVH is computed for every contained contour.
+** '''Structure set:''' A contour or a contour hierarchy can be selected for which the DVH tables are computed. In case of a hierarchy, the DVH is computed for every contained contour.
-* Output
+* '''Output'''
-** Chart: A chart can be created or selected in which the DVH plots are added
+** '''Chart:''' A chart can be created or selected in which the DVH plots are added
-** Show/hide all: After computing histograms and a chart, this checkbox adds or removes every histogram from the selected chart
+** '''Show/hide all:''' After computing histograms and a chart, this checkbox adds or removes every histogram from the selected chart
-** DVH table
+** '''DVH table'''
-*** Checkbox: show/hide that specific structure in the selected chart
+*** '''Checkbox:''' show/hide that specific structure in the selected chart
 *** Structure data and computed DVH metrics appear in the columns
-* Advanced options
+* '''Advanced options'''
-** V metric for dose values: Values can be entered separated by commas. If 'cc' or '%' is checked, then the V metric for all structures according the entered values will appear in the DVH table in the checked unit(s)
+** '''V metric for dose values:''' Values can be entered separated by commas. If 'cc' or '%' is checked, then the V metric for all structures according the entered values will appear in the DVH table in the checked unit(s)
-** D metric for volumes: Values can be entered separated by commas in either ccs or percents. If 'Gy' is checked then the D metric for the entered volumes are displayed in the DVH table
+** '''D metric for volumes:''' Values can be entered separated by commas in either ccs or percents. If 'Gy' is checked then the D metric for the entered volumes are displayed in the DVH table
-** Export DVH to file: The currently plotted DVH tables are saved in CSV format
+** '''Export DVH to file:''' The currently plotted DVH tables are saved in CSV format
-** Export DVH metrics to file: The currently displayed DVH table can be exported in CSV format
+** '''Export DVH metrics to file:''' The currently displayed DVH table can be exported in CSV format
 <!--

@@ Line 15: / Line 15: @@
 |{{collaborator|logo|cco}}|{{collaborator|longname|cco}}
 |{{collaborator|logo|sparkit}}|{{collaborator|longname|sparkit}}
 }}
 {{documentation/{{documentation/version}}/module-introduction-end}}