Difference between revisions of "Documentation/Nightly/Modules/DoseVolumeHistogram"

From Slicer Wiki
Jump to: navigation, search
Line 69: Line 69:
 
{{documentation/{{documentation/version}}/module-section|Information for Developers}}
 
{{documentation/{{documentation/version}}/module-section|Information for Developers}}
 
Custom attributes:
 
Custom attributes:
DicomRtImport.DoseUnitName: set in each imported dose volume, the value of this attribute is read from the Dose Units (3004,0002) attribute of the RTDOSE DICOM volume
+
* DicomRtImport.DoseUnitName: required to detect a volume as a "dose volume", used in DVH metrics column headers and DVH plot titles
DicomRtImport.DoseUnitValue: set in each imported dose volume, the value of this attribute is read from the Dose Grid Scaling (3004,000E) attribute of the RTDOSE DICOM volume. This value defines a scaling factor to convert the integer voxel values of the dose volume in the DICOM file to real dose values. This conversion is performed during DICOM importing, but this value is stored to let other modules know what was the original scaling factor (e.g., see how it is used in the documentation of the Dose Volume Histogram module)
+
* DicomRtImport.DoseUnitValue: required to detect a volume as a "dose volume"
  
 
{{documentation/{{documentation/version}}/module-developerinfo}}
 
{{documentation/{{documentation/version}}/module-developerinfo}}

Revision as of 14:16, 21 February 2013

Home < Documentation < Nightly < Modules < DoseVolumeHistogram

Introduction and Acknowledgements

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.
Author: Csaba Pinter (PerkLab, Queen's University)
Contact: Csaba Pinter, <email>pinter@cs.queensu.ca</email>

Cancer Care Ontario  
Software Platform and Adaptive Radiotherapy Kit  

Module Description

The DoseVolumeHistogram 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.

Use Cases

Evaluate single or accumulated dose distributions against target structures and organs at risk (OARs)

Dose volume histogram computation using SlicerRT

Tutorials

See SlicerRT extension page

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.
  • Output
    • 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
    • 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


Similar Modules

N/A

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
  • 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
  • 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

Information for Developers

Custom attributes:

  • DicomRtImport.DoseUnitName: required to detect a volume as a "dose volume", used in DVH metrics column headers and DVH plot titles
  • DicomRtImport.DoseUnitValue: required to detect a volume as a "dose volume"