Difference between revisions of "Modules:PETCTFusion-Documentation-3.6"

From Slicer Wiki
Jump to: navigation, search
 
(19 intermediate revisions by the same user not shown)
Line 1: Line 1:
 
[[Documentation-3.6|Return to Slicer 3.6 Documentation]]
 
[[Documentation-3.6|Return to Slicer 3.6 Documentation]]
  
−
[[Announcements:Slicer3.6#Highlights|Gallery of New Features]]
 
  
 
__NOTOC__
 
__NOTOC__
Line 7: Line 6:
  
 
{|
 
{|
−
|[[Image:screenshotBlankNotOptional.png|thumb|280px|User Interface]]
+
|[[Image:PETCTFusion-Fusionframe.png|thumb|280px|Fusion GUI panel]]
−
|[[Image:screenshotBlank.png|thumb|280px|Output]]
+
|[[Image:PETCTFusion.png|thumb|220px|Coronal Slice]]
−
|[[Image:screenshotBlank.png|thumb|280px|Caption]]
+
|[[Image:PETCTFusionBig.png|thumb|280px|Full View]]
 
|}
 
|}
  
Line 38: Line 37:
 
Links to tutorials explaining how to use this module:
 
Links to tutorials explaining how to use this module:
  
−
* Tutorial 1
+
* [http://www.na-mic.org/Wiki/index.php/Events:RSNA_CTSA_2009#Tutorial_Slides Link to PET/CT Tutorial ]
−
** Data Set 1
+
** [http://www.na-mic.org/Wiki/index.php/Events:RSNA_CTSA_2009#Tutorial_Data Link to PET/CT Data Set ]
  
 
===Quick Tour of Features and Use===
 
===Quick Tour of Features and Use===
Line 45: Line 44:
 
A list panels in the interface, their features, what they mean, and how to use them. For instance:
 
A list panels in the interface, their features, what they mean, and how to use them. For instance:
  
−
{|
+
'''Data Fusion & Study Information:'''
−
|
+
 
−
* '''Data Fusion & Study Information:'''
+
In the Data Fusion panel shown below, a CT volume and corresponding PET volume should be selected. A pre-created tumor mask (label map) should be selected. This mask can be created in the editor module using the PET volume as a reference volume. This module will compute a separate SUV-bw for each label in the map. So if there are multiple volumes of interest for which individual SUV's should be computed, a separate label (color) should be used for each VOI. Volumes contained within same-label colors will be computed together.
−
* '''Display panel:'''
+
 
−
* '''Quantitative Measures panel:'''
+
This panel also displays some basic study information, including patient name and study date, as these may be important visual checks for a user.
−
* '''Study Parameters panel: '''
+
 
 +
[[Image:PETCTFusion-Fusionframe.png|thumb|center|280px|User Interface]]
 +
 
 +
'''Display panel:'''
 +
 
 +
In the  module's Display panel shown below, options to select a colorizing scheme for the PET dataset are provided:
 +
* Grey will provide white to black colorization, with black indicating the highest count values.
 +
* Heat will provide a warm color scale, with Dark red lowest, and white the highest count values.
 +
* Spectrum will provide a warm color scale that goes cooler (dark blue) on the low-count end to white at the highest.
 +
 
 +
This panel also provides a means to adjust the window and level of both PET and CT volumes.
 +
 
 +
[[Image:PETCTFusion-Displayframe.png|thumb|center|280px|User Interface]]
 +
 
 +
'''Quantitative Measures panel:'''
 +
 
 +
This display panel has the "Compute/Refresh" button which may be selected after datasets are selected. Once SUV has been computed, the panel above will be populated by results for each label in the tumor mask, and indexed by both ID number and color.
 +
 
 +
[[Image:PETCTFusion-Measuresframe.png|thumb|center|280px|User Interface]]
 +
 
 +
'''Study Parameters panel: '''
 +
 
 +
This panel can be consulted to view other study parameters that may be of interest. Parameters may also be entered manually here, if no DICOM metadata is available for them (note, this feature has not been thoroughly tested.)
  
−
|[[Image:screenshotBlankNotOptional.png|thumb|280px|User Interface]]
+
[[Image:PETCTFusion-Manualframe.png|thumb|center|280px|User Interface]]
−
|}
 
  
 
== Development ==
 
== Development ==
Line 59: Line 79:
 
===Notes from the Developer(s)===
 
===Notes from the Developer(s)===
  
−
Algorithms used, library classes depended upon, use cases, etc.
+
This module uses ITK's gdcm to access DICOM metadata used for computing SUV-bw. Philips datasets are not currently handled.
  
 
===Dependencies===
 
===Dependencies===
  
−
Other modules or packages that are required for this module's use.
+
Slicer Core.
−
 
 
−
===Tests===
 
−
 
 
−
On the [http://www.cdash.org/CDash/index.php?project=Slicer3 Dashboard], these tests verify that the module is working on various platforms:
 
−
 
 
−
* MyModuleTest1 [http://viewvc.slicer.org/viewcvs.cgi/trunk MyModuleTest1.cxx]
 
−
* MyModuleTest2 [http://viewvc.slicer.org/viewcvs.cgi/trunk MyModuleTest2.cxx]
 
  
 
===Known bugs===
 
===Known bugs===
Line 86: Line 99:
  
 
Source code:
 
Source code:
−
*[http://viewvc.slicer.org/viewcvs.cgi/trunk file.cxx ]
+
 
−
*[http://viewvc.slicer.org/viewcvs.cgi/trunk file.h ]
+
[http://viewvc.slicer.org/viewcvs.cgi/branches/Slicer-3-6/Modules/PETCTFusion/ Module directory ]
 +
 
 +
Files:
 +
* vtkPETCTFusion.h
 +
* vtkPETCTFusionLogic.h
 +
* vtkPETCTFusionLogic.cxx
 +
* vtkPETCTFusionGUI.h
 +
* vtkPETCTFusionGUI.cxx
 +
* vtkMRMLPETCTFusionNode.h
 +
* vtkMRMLPETCTFusionNode.cxx
 +
 
 
   
 
   
 
Doxygen documentation:
 
Doxygen documentation:
−
*[http://www.na-mic.org/Slicer/Documentation/Slicer3-doc/html/classes.html class1]
+
*[http://www.na-mic.org/Slicer/Documentation/Slicer3-doc/html/classvtkPETCTFusionGUI.html vtkPETCTFusionGUI]
 +
*[http://www.na-mic.org/Slicer/Documentation/Slicer3-doc/html/classvtkPETCTFusionLogic.html vtkPETCTFusionLogic]
 +
*[http://www.na-mic.org/Slicer/Documentation/Slicer3-doc/html/classvtkMRMLPETCTFusionNode.html vtkMRMLPETCTFusionNode]
 +
 
 +
===Acknowledgment===
 +
 
 +
[[image:Slicer3-6AcknowledgementLogos.png]]
  
 +
Development of this module was supported by
  
−
===Acknowledgment===
+
* The Harvard Clinical and Translational Science Center
−
Include funding and other support here.
+
* The National Alliance for Medical Image Computing
 +
* The Neuroimage Analysis Center
 +
* The National Center for Image-Guided Therapy, and
 +
* The Surgical Planning Laboratory at Brigham and Women's Hospital.
 +
 
 +
This module was developed by Wendy Plesniak, Jeffrey Yap and Ron Kikinis

Latest revision as of 13:32, 8 May 2010

Home < Modules:PETCTFusion-Documentation-3.6

Return to Slicer 3.6 Documentation


PET/CT Fusion Module

Fusion GUI panel
Coronal Slice
Full View

General Information

Module Type & Category

Type: Interactive

Category: Base

Authors, Collaborators & Contact

  • Author1: Wendy Plesniak, BWH
  • Contributor1: Jeffrey Yap, Dana Farber Cancer Institute
  • Contributor2: Ron Kikinis, BWH
  • Contact: Wendy Plesniak, wjp@bwh.harvard.edu

Module Description

This module computes Standardized Uptake Value (SUV) based on patient body weight, using a PET image and one or more manually drawn VOIs. SUV-bw for VOIs of different color (id) will be assessed separately.

Usage

Use Cases, Examples

This module can be used to quantify tumor response to treatment. Typically, an initial PET/CT study is done prior to treatment, and a followup study is registered to it. ROIs can be specified on the initial study and used to compute SUVmax-bw and SUVmean-bw on both studies.

Tutorials

Links to tutorials explaining how to use this module:

Quick Tour of Features and Use

A list panels in the interface, their features, what they mean, and how to use them. For instance:

Data Fusion & Study Information:

In the Data Fusion panel shown below, a CT volume and corresponding PET volume should be selected. A pre-created tumor mask (label map) should be selected. This mask can be created in the editor module using the PET volume as a reference volume. This module will compute a separate SUV-bw for each label in the map. So if there are multiple volumes of interest for which individual SUV's should be computed, a separate label (color) should be used for each VOI. Volumes contained within same-label colors will be computed together.

This panel also displays some basic study information, including patient name and study date, as these may be important visual checks for a user.

User Interface

Display panel:

In the module's Display panel shown below, options to select a colorizing scheme for the PET dataset are provided:

  • Grey will provide white to black colorization, with black indicating the highest count values.
  • Heat will provide a warm color scale, with Dark red lowest, and white the highest count values.
  • Spectrum will provide a warm color scale that goes cooler (dark blue) on the low-count end to white at the highest.

This panel also provides a means to adjust the window and level of both PET and CT volumes.

User Interface

Quantitative Measures panel:

This display panel has the "Compute/Refresh" button which may be selected after datasets are selected. Once SUV has been computed, the panel above will be populated by results for each label in the tumor mask, and indexed by both ID number and color.

User Interface

Study Parameters panel:

This panel can be consulted to view other study parameters that may be of interest. Parameters may also be entered manually here, if no DICOM metadata is available for them (note, this feature has not been thoroughly tested.)

User Interface

Development

Notes from the Developer(s)

This module uses ITK's gdcm to access DICOM metadata used for computing SUV-bw. Philips datasets are not currently handled.

Dependencies

Slicer Core.

Known bugs

Philips PET datasets use private DICOM tags that are not supported by this version of the module. The module should not be used to analyze datasets acquired by Philips systems.


Usability issues

Follow this link to the Slicer3 bug tracker. Please select the usability issue category when browsing or contributing.

Source code & documentation

Links to the module's source code:

Source code:

Module directory

Files:

  • vtkPETCTFusion.h
  • vtkPETCTFusionLogic.h
  • vtkPETCTFusionLogic.cxx
  • vtkPETCTFusionGUI.h
  • vtkPETCTFusionGUI.cxx
  • vtkMRMLPETCTFusionNode.h
  • vtkMRMLPETCTFusionNode.cxx


Doxygen documentation:

Acknowledgment

Slicer3-6AcknowledgementLogos.png

Development of this module was supported by

  • The Harvard Clinical and Translational Science Center
  • The National Alliance for Medical Image Computing
  • The Neuroimage Analysis Center
  • The National Center for Image-Guided Therapy, and
  • The Surgical Planning Laboratory at Brigham and Women's Hospital.

This module was developed by Wendy Plesniak, Jeffrey Yap and Ron Kikinis

Retrieved from "https://www.slicer.org/w/index.php?title=Modules:PETCTFusion-Documentation-3.6&oldid=15540"