Difference between revisions of "Documentation/4.1/Modules/MultiVolumeExplorer"

From Slicer Wiki
Jump to: navigation, search
Line 1: Line 1:
 
{{documentation/underconstruction}}
 
{{documentation/underconstruction}}
  
[[Image:Screen_Shot_2012-02-23_at_7.53.51_AM.png|400px|thumb|Screenshot of charts derived from the sample data set. The curves represent average signal intensity in the ROI's with corresponding colors, which were drawn in the editor. Please note the arterial input function in red.]]
+
==Work in progress: Disclaimer==
 
 
'''This is a placeholder for MultiVolumeExplorer module documentation.'''
 
 
 
=Overview=
 
 
 
Development of this module was initiated at the 2012 NA-MIC Project week at SLC (see http://wiki.na-mic.org/Wiki/index.php/2012_Project_Week:4DImageSlicer4)
 
 
 
The module is located in '''Modules -> Work in progress -> MultiVolume Support'''
 
 
 
'''Disclaimer''': this module is '''Work in progress'''. This means that
 
 
* the functionality provided by this module may change drastically in the future releases of 3D Slicer
 
* the functionality provided by this module may change drastically in the future releases of 3D Slicer
 
* the scenes containing data types specific to this module may not be readable by the future versions of Slicer
 
* the scenes containing data types specific to this module may not be readable by the future versions of Slicer
Line 17: Line 7:
 
* some functionality may not work as intended
 
* some functionality may not work as intended
 
* testing and documentation is limited
 
* testing and documentation is limited
 
If you would like to try this module:
 
# download the sample dataset [http://wiki.slicer.org/slicerWiki/images/5/56/Case1_DCE.tgz anonymized prostate DCE MRI DICOM series]
 
# another sample dataset [[File:Cardiac_ECGg_CT.tgz]] (ECG-gated contrast-enhanced cardiac CT) (use "User-defined non-DICOM" parameter option to load it into MultiVolumeImporter). Short [[media:BeatingHeart.mov|movie]]
 
# check out [http://www.youtube.com/watch?v=7zFWRzC31o4 this screencast] if you would like to learn how to use this module. (The module is located in '''Modules -> Work in progress -> MultiVolume Support''', not in Modules -> MultiVolume Support, as shown in the video)
 
 
==Known issues that won't be resolved==
 
* [http://www.na-mic.org/Bug/view.php?id=1841 bug 1841]: multivolumes that contain less than 7 frames will not be saved correctly and the scene containing such objects will not be loaded correctly by Slicer (limitation of the NRRD IO for DWI)
 
 
==Unresolved issues==
 
* assign correctly title and points for the X axis
 
* review the comments from JC/J2 on github and fix the code
 
* bug: repeated loading of a scene that contains a MV node causes crash in onInputChanged()
 
* improve error reporting!
 
* look into flickering issue of vtkChart
 
* improve documentation
 
 
==Features to be implemented==
 
* integrate MV importer as a DICOM module plugin
 
* allow the user to speed-up or slow-down the playback, and also turn off "loop"
 
* report to the user the actual, measured, frame rate
 
* add an option to report curves in relative SI change in addition to absolute
 
 
==Features under consideration==
 
* can we use chart viewer for interactive plotting? -- Discussed with Jim, speedup is possible, but not a priority right now
 
* should use color names for the legend in the chart viewer -- Will be available as general feature of Charts (Jim)
 
* interactive update of the active frame based on the point selected in the chart viewer
 
* should DWI node be a child under the MV hierarchy?
 
* add GUI elements to update the current frame at the exact time intervals specified in multivolume. If the intervals are non-uniform, I am not sure I can use the timer anymore, so this would require some extra thought.
 
* import multivolumes from ITK 4d images
 
 
  
 
<!-- ---------------------------- -->
 
<!-- ---------------------------- -->
Line 80: Line 39:
 
Most frequently used for these scenarios:
 
Most frequently used for these scenarios:
 
* visualization of DCE MRI
 
* visualization of DCE MRI
 +
 +
[[Image:Screen_Shot_2012-02-23_at_7.53.51_AM.png|400px|thumb|Screenshot of charts derived from the sample data set. The curves represent average signal intensity in the ROI's with corresponding colors, which were drawn in the editor. Please note the arterial input function in red.]]
  
 
<!-- ---------------------------- -->
 
<!-- ---------------------------- -->
 
{{documentation/{{documentation/version}}/module-section|Tutorials}}
 
{{documentation/{{documentation/version}}/module-section|Tutorials}}
 
+
* [http://www.youtube.com/watch?v=7zFWRzC31o4 Screencast tutorial] (note that the module is located in '''Modules -> Work in progress -> MultiVolume Support''', not in Modules -> MultiVolume Support, as shown in the video)
 +
* Sample datasets are available:
 +
** [http://wiki.slicer.org/slicerWiki/images/5/56/Case1_DCE.tgz anonymized prostate DCE MRI DICOM series]
 +
** [[File:Cardiac_ECGg_CT.tgz]] (ECG-gated contrast-enhanced cardiac CT) (use "User-defined non-DICOM" parameter option to load it into MultiVolumeImporter). Short [[media:BeatingHeart.mov|movie]]
  
 
<!-- ---------------------------- -->
 
<!-- ---------------------------- -->
Line 94: Line 58:
 
<!-- ---------------------------- -->
 
<!-- ---------------------------- -->
 
{{documentation/{{documentation/version}}/module-section|References}}
 
{{documentation/{{documentation/version}}/module-section|References}}
 +
* Development of this module was initiated at the 2012 NA-MIC Project week at SLC (see http://wiki.na-mic.org/Wiki/index.php/2012_Project_Week:4DImageSlicer4)
  
 
<!-- ---------------------------- -->
 
<!-- ---------------------------- -->
 
{{documentation/{{documentation/version}}/module-section|Information for Developers}}
 
{{documentation/{{documentation/version}}/module-section|Information for Developers}}
 
{{documentation/{{documentation/version}}/module-developerinfo}}
 
{{documentation/{{documentation/version}}/module-developerinfo}}
 +
==Known issues that won't be resolved==
 +
* [http://www.na-mic.org/Bug/view.php?id=1841 bug 1841]: multivolumes that contain less than 7 frames will not be saved correctly and the scene containing such objects will not be loaded correctly by Slicer (limitation of the NRRD IO for DWI)
 +
 +
==Unresolved issues==
 +
* assign correctly title and points for the X axis
 +
* review the comments from JC/J2 on github and fix the code
 +
* bug: repeated loading of a scene that contains a MV node causes crash in onInputChanged()
 +
* improve error reporting!
 +
* look into flickering issue of vtkChart
 +
* improve documentation
 +
 +
==Features to be implemented==
 +
* integrate MV importer as a DICOM module plugin
 +
* allow the user to speed-up or slow-down the playback, and also turn off "loop"
 +
* report to the user the actual, measured, frame rate
 +
* add an option to report curves in relative SI change in addition to absolute
 +
 +
==Features under consideration==
 +
* can we use chart viewer for interactive plotting? -- Discussed with Jim, speedup is possible, but not a priority right now
 +
* should use color names for the legend in the chart viewer -- Will be available as general feature of Charts (Jim)
 +
* interactive update of the active frame based on the point selected in the chart viewer
 +
* should DWI node be a child under the MV hierarchy?
 +
* add GUI elements to update the current frame at the exact time intervals specified in multivolume. If the intervals are non-uniform, I am not sure I can use the timer anymore, so this would require some extra thought.
 +
* import multivolumes from ITK 4d images
 +
  
  

Revision as of 12:54, 24 April 2012

Home < Documentation < 4.1 < Modules < MultiVolumeExplorer


Work in progress: Disclaimer

  • the functionality provided by this module may change drastically in the future releases of 3D Slicer
  • the scenes containing data types specific to this module may not be readable by the future versions of Slicer
  • the functionality and user interface may change at any time
  • some functionality may not work as intended
  • testing and documentation is limited


Introduction and Acknowledgements

This work is supported by NA-MIC, NAC, NCIGT, and the Slicer Community. This work is partially supported by TODO.
Author: Andrey Fedorov, Jean-Cristophe Fillion Robin, Julien Finet, Steve Pieper, Ron Kikinis
Contact: Andrey Fedorov <email>fedorov@bwh.harvard.edu</email>

National Center for Image Guided Therapy (NCIGT)  
National Alliance for Medical Image Computing (NA-MIC)  
Surgical Planning Laboratory (SPL)  
Kitware, Inc.  
Neuroimage Analysis Center (NAC)  


Module Description

This module provides support for exploring multivolume (multiframe) data.

Use Cases

Most frequently used for these scenarios:

  • visualization of DCE MRI
Screenshot of charts derived from the sample data set. The curves represent average signal intensity in the ROI's with corresponding colors, which were drawn in the editor. Please note the arterial input function in red.

Tutorials

Panels and their use

Similar Modules

N/A

References

Information for Developers


Known issues that won't be resolved

  • bug 1841: multivolumes that contain less than 7 frames will not be saved correctly and the scene containing such objects will not be loaded correctly by Slicer (limitation of the NRRD IO for DWI)

Unresolved issues

  • assign correctly title and points for the X axis
  • review the comments from JC/J2 on github and fix the code
  • bug: repeated loading of a scene that contains a MV node causes crash in onInputChanged()
  • improve error reporting!
  • look into flickering issue of vtkChart
  • improve documentation

Features to be implemented

  • integrate MV importer as a DICOM module plugin
  • allow the user to speed-up or slow-down the playback, and also turn off "loop"
  • report to the user the actual, measured, frame rate
  • add an option to report curves in relative SI change in addition to absolute

Features under consideration

  • can we use chart viewer for interactive plotting? -- Discussed with Jim, speedup is possible, but not a priority right now
  • should use color names for the legend in the chart viewer -- Will be available as general feature of Charts (Jim)
  • interactive update of the active frame based on the point selected in the chart viewer
  • should DWI node be a child under the MV hierarchy?
  • add GUI elements to update the current frame at the exact time intervals specified in multivolume. If the intervals are non-uniform, I am not sure I can use the timer anymore, so this would require some extra thought.
  • import multivolumes from ITK 4d images