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

From Slicer Wiki
Jump to: navigation, search
(Page created)
m (Text replacement - "\[http:\/\/www\.slicer\.org\/slicerWiki\/index\.php\/([^ ]+) ([^]]+)]" to "$2")
 
(11 intermediate revisions by 5 users not shown)
Line 1: Line 1:
 +
<noinclude>{{documentation/versioncheck}}</noinclude>
 
<!-- ---------------------------- -->
 
<!-- ---------------------------- -->
 
{{documentation/{{documentation/version}}/module-header}}
 
{{documentation/{{documentation/version}}/module-header}}
Line 8: Line 9:
 
{{documentation/{{documentation/version}}/module-introduction-row}}
 
{{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>
 
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: Kevin Wang (Radiation Medicine Program, Princess Margaret Hospital, University Health Network Toronto)<br>
+
Author: Kevin Wang (Princess Margaret Cancer Centre)<br>
 
Contact: Kevin Wang, <email>kevin.wang@rmp.uhn.on.ca</email><br>
 
Contact: Kevin Wang, <email>kevin.wang@rmp.uhn.on.ca</email><br>
 +
[[Documentation/Nightly/Extensions/SlicerRT|Back to SlicerRT home]]
 
{{documentation/{{documentation/version}}/module-introduction-row}}
 
{{documentation/{{documentation/version}}/module-introduction-row}}
 
{{documentation/{{documentation/version}}/module-introduction-logo-gallery
 
{{documentation/{{documentation/version}}/module-introduction-logo-gallery
 
|{{collaborator|logo|cco}}|{{collaborator|longname|cco}}
 
|{{collaborator|logo|cco}}|{{collaborator|longname|cco}}
 
|{{collaborator|logo|sparkit}}|{{collaborator|longname|sparkit}}
 
|{{collaborator|logo|sparkit}}|{{collaborator|longname|sparkit}}
 +
|{{collaborator|logo|ocairo}}|{{collaborator|longname|ocairo}}
 
}}
 
}}
 
{{documentation/{{documentation/version}}/module-introduction-end}}
 
{{documentation/{{documentation/version}}/module-introduction-end}}
 +
 +
{|
 +
|
  
 
<!-- ---------------------------- -->
 
<!-- ---------------------------- -->
 
{{documentation/{{documentation/version}}/module-section|Module Description}}
 
{{documentation/{{documentation/version}}/module-section|Module Description}}
The {{documentation/modulename}} module accumulates the multiple dose distribution maps into one dose map. The output accumulated dose volume is the weighted sum of the input dose volumes.
+
The {{documentation/modulename}} module computes accumulated dose for multiple input dose volumes as a weighted sum of the dose values. The weight of each input volume is specified in the module’s user interface. The dose volumes have to be spatially aligned prior the dose accumulation to obtain a meaningful summation. This can be achieved by utilizing image registration algorithms already available in the 3D Slicer core. First, the alignment transformation is computed by registering the anatomical volumes and then the same transformation is applied to the corresponding dose volumes.
  
 
<!-- ---------------------------- -->
 
<!-- ---------------------------- -->
 
{{documentation/{{documentation/version}}/module-section|Use Cases}}
 
{{documentation/{{documentation/version}}/module-section|Use Cases}}
 
Evaluate total delivered dose for multiple treatment fractions.
 
Evaluate total delivered dose for multiple treatment fractions.
 
{|align="center"
 
|[[File:SlicerRT0.3 DoseAccumulation.jpg|thumb|720px| Contours module GUI]]
 
|}
 
  
 
<!-- ---------------------------- -->
 
<!-- ---------------------------- -->
Line 35: Line 37:
 
<!-- ---------------------------- -->
 
<!-- ---------------------------- -->
 
{{documentation/{{documentation/version}}/module-section|Panels and their use}}
 
{{documentation/{{documentation/version}}/module-section|Panels and their use}}
* Input
+
* '''Input'''
** Show dose volumes only: Ic checked, only the volumes that have been created by a SlicerRT module (such as DicomRtImport or DoseAccumulation) are displayed
+
** '''Reference dose volume:''' The output dose volume will have the same size, spacing, position, and orientation as the reference dose volume and will have the same dose unit. Voxel values of the reference dose volume do not influence the output.
** Dose volume table
+
** '''Show dose volumes only:''' If checked, only the volumes that have been created by a SlicerRT module (such as DicomRtImport or DoseAccumulation) are displayed
 +
** '''Dose volume table'''
 
*** The checked dose volumes are accumulated
 
*** The checked dose volumes are accumulated
 
*** Weight can be assigned to the dose distributions for the accumulation
 
*** Weight can be assigned to the dose distributions for the accumulation
* Output
+
* '''Output'''
** Accumulated dose volume: The output volume
+
** '''Accumulated dose volume:''' The output volume
** Apply: Compute accumulated dose and save it in the output volume
+
** '''Apply:''' Compute accumulated dose and save it in the output volume
 
<!--
 
<!--
 
{{documentation/{{documentation/version}}/module-parametersdescription}}
 
{{documentation/{{documentation/version}}/module-parametersdescription}}
 
-->
 
-->
 +
 +
| [[File:SlicerRT_DoseAccumulationModuleUi.png|thumb|445px|Dose accumulation module UI]]
 +
|}
  
 
<!-- ---------------------------- -->
 
<!-- ---------------------------- -->
Line 57: Line 63:
 
<!-- ---------------------------- -->
 
<!-- ---------------------------- -->
 
{{documentation/{{documentation/version}}/module-section|Information for Developers}}
 
{{documentation/{{documentation/version}}/module-section|Information for Developers}}
{{documentation/{{documentation/version}}/module-developerinfo}}
+
Custom attributes:
 
+
* DicomRtImport.DoseVolume: identifier attribute that is set to each imported dose volume. Facilitates easier distinction between dose and non-dose volumes (without tampering in the Patient Hierarchy tree, see below)
 +
* DicomRtImport.DoseUnitName: set in the study of each imported dose volume, the value of this attribute is read from the Dose Units (3004,0002) attribute of the RTDOSE DICOM volume
 +
* DicomRtImport.DoseUnitValue: set in the study of 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
  
 
<!-- ---------------------------- -->
 
<!-- ---------------------------- -->
 
{{documentation/{{documentation/version}}/module-footer}}
 
{{documentation/{{documentation/version}}/module-footer}}
 
<!-- ---------------------------- -->
 
<!-- ---------------------------- -->

Latest revision as of 02:26, 27 November 2019

Home < Documentation < Nightly < Modules < DoseAccumulation


For the latest Slicer documentation, visit the read-the-docs.


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: Kevin Wang (Princess Margaret Cancer Centre)
Contact: Kevin Wang, <email>kevin.wang@rmp.uhn.on.ca</email>
Back to SlicerRT home

Cancer Care Ontario  
Software Platform and Adaptive Radiotherapy Kit  
Ontario Consortium for Adaptive Interventions in Radiation Oncology  

Module Description

The DoseAccumulation module computes accumulated dose for multiple input dose volumes as a weighted sum of the dose values. The weight of each input volume is specified in the module’s user interface. The dose volumes have to be spatially aligned prior the dose accumulation to obtain a meaningful summation. This can be achieved by utilizing image registration algorithms already available in the 3D Slicer core. First, the alignment transformation is computed by registering the anatomical volumes and then the same transformation is applied to the corresponding dose volumes.

Use Cases

Evaluate total delivered dose for multiple treatment fractions.

Tutorials

See SlicerRT extension page

Panels and their use

  • Input
    • Reference dose volume: The output dose volume will have the same size, spacing, position, and orientation as the reference dose volume and will have the same dose unit. Voxel values of the reference dose volume do not influence the output.
    • Show dose volumes only: If checked, only the volumes that have been created by a SlicerRT module (such as DicomRtImport or DoseAccumulation) are displayed
    • Dose volume table
      • The checked dose volumes are accumulated
      • Weight can be assigned to the dose distributions for the accumulation
  • Output
    • Accumulated dose volume: The output volume
    • Apply: Compute accumulated dose and save it in the output volume
Dose accumulation module UI

Similar Modules

N/A

References

N/A

Information for Developers

Custom attributes:

  • DicomRtImport.DoseVolume: identifier attribute that is set to each imported dose volume. Facilitates easier distinction between dose and non-dose volumes (without tampering in the Patient Hierarchy tree, see below)
  • DicomRtImport.DoseUnitName: set in the study of each imported dose volume, the value of this attribute is read from the Dose Units (3004,0002) attribute of the RTDOSE DICOM volume
  • DicomRtImport.DoseUnitValue: set in the study of 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