Difference between revisions of "Modules:ChangeTracker-Documentation"

From Slicer Wiki
Jump to: navigation, search
 
(23 intermediate revisions by 2 users not shown)
Line 4: Line 4:
  
 
{|
 
{|
|[[Image:screenshotBlank.png|thumb|280px|Caption 1]]
+
|[[Image:ChangeTracker_Analysis.png|thumb|420px|ChangeTracker analysis results]]
|[[Image:screenshotBlank.png|thumb|280px|Caption 2]]
+
|[[Image:ChangeTracker_snapshot.png|thumb|280px|ChangeTracker greetings]]
|[[Image:screenshotBlank.png|thumb|280px|Caption 3]]
 
 
|}
 
|}
  
Line 18: Line 17:
 
===Authors, Collaborators & Contact===
 
===Authors, Collaborators & Contact===
 
* Kilian Pohl, IBM Research/SPL
 
* Kilian Pohl, IBM Research/SPL
 +
* Ender Konukoglu, INRIA
 
* Andriy Fedorov, SPL
 
* Andriy Fedorov, SPL
 
* Ron Kikinis, SPL
 
* Ron Kikinis, SPL
Line 35: Line 35:
  
 
===Quick Tour of Features and Use===
 
===Quick Tour of Features and Use===
List all the panels in your interface, their features, what they mean, and how to use them. For instance:
+
ChangeTracker uses workflow processing of the input data guided by minimal user interaction. There are 4 processing steps.
  
* '''Input panel:'''
+
* '''Step 1: Define input scans'''
* '''Parameters panel:'''
+
 
* '''Output panel:'''
+
{|
* '''Viewing panel:'''
+
|Use drop-down controls to choose the two scans where you would like to measure pathology development. Currently, we support analysis of the images that correspond to two time points. Extending of the module to accept more than two time points is the feature under development.
 +
|[[Image:ChangeTracker_Step1.png|thumb|250px|Step 1: Scan selection]]
 +
|}
 +
 
 +
* '''Step 2: Define volume of interest'''
 +
 
 +
{|
 +
|Use the mouse pointer in combination with left button clicks to identify the bounding box enclosing pathology in three projections of the viewer. You can also use the mouse to adjust sliders defining the bounding box more precisely. If you made a mistake, click "Reset" button to start over. "Show VOI" button can be used to show/hide blue overlay of the region of interest of the the image slice views.
 +
|{|
 +
|[[Image:ChangeTracker_Step2_1.png|thumb|200px|Step 2: ROI selection]]
 +
|[[Image:ChangeTracker_Step2_2.png|thumb|250px|Step 2: ROI visualization]]
 +
|}
 +
 
 +
 
 +
* '''Step 3: Select tumor segmentation threshold'''
 +
 
 +
{|
 +
|Use threshold control slider to find the intensity that most closely approximates tumor volume. Tumor volume is rendered in the 3D viewer as you are choosing the appropriate threshold, and is also visualized as semi-transparent label in the image slice viewers.
 +
|[[Image:ChangeTracker_Step3.png|thumb|450px|Step 3: Threshold selection]]
 +
|}
 +
 
 +
* '''Step 4: Define metric'''
 +
 
 +
{|
 +
|We provide two metrics -- intensity-based and deformation-based -- to quantify tumor progression (see details in this [http://www.spl.harvard.edu/pages/Special:PubDB_View?dspaceid=1430 paper]). Choose the metric you would like to use.
 +
|[[Image:ChangeTracker_Step4.png|thumb|250px|Step 4: Metric selection]]
 +
|}
 +
 
 +
* '''Analysis/Results'''
 +
 
 +
{|
 +
|Results are reported as the change in tumor volume, separately for growth and shrinkage component. The quantitative results are reported in voxels and mm^3.
 +
 
 +
Sensitivity of the analysis can be controlled by choosing Sensitive, Moderate, or Robust analysis approach (Robust being the most conservative). As you change the sensitivity, visualization and quantitative data are updated accordingly. Growth is shown in purple, and shrinkage -- in green color.
 +
 
 +
You can choose to display the original sampling grid, and view the coronal slice of the subject using the module controls.
 +
 
 +
|[[Image:ChangeTracker_Analysis.png|thumb|450px|Visualization of the analysis results]]
 +
|}
  
 
== Development ==
 
== Development ==
Line 46: Line 84:
 
===Dependencies===
 
===Dependencies===
  
The module is using [http://slicer.spl.harvard.edu/slicerWiki/index.php/Modules:LinearRegistration-Documentation Rigid Registration module] through the CommandLineModule shared object invocation
+
{|
 +
|ChangeTracker is using [http://slicer.spl.harvard.edu/slicerWiki/index.php/Modules:LinearRegistration-Documentation Rigid Registration module] through the CommandLineModule shared object invocation. Note, that there are two distinct rigid registration modules in Slicer, which have identical functionality: "Linear registration" and "Rigid registration". Both of these modules should be available in your build, but "Rigid registration" *must* be available for ChangeTracker to function properly. You can verify the availability of the module manually by looking at the list of modules in the registration category.
 +
|[[Image:rigid_registration_module.png|thumb|200px|Checking availability of Rigid registration module (click to zoom in)]]
 +
|}
  
 
===Known bugs===
 
===Known bugs===
Line 60: Line 101:
 
===Source code & documentation===
 
===Source code & documentation===
  
Customize following [http://www.na-mic.org/ViewVC/index.cgi/ links] for your module.
+
Follow this [http://viewvc.slicer.org/viewcvs.cgi/trunk/Modules/ChangeTracker/ link] to the ChangeTracker source code in ViewVC.
 
 
[http://www.na-mic.org/Slicer/Documentation/Slicer3/html/ Links] to documentation generated by doxygen.
 
  
 +
[http://www.na-mic.org/Slicer/Documentation/Slicer3/html/classes.html Documentation] generated by doxygen.
  
 
== More Information ==  
 
== More Information ==  

Latest revision as of 23:51, 22 December 2008

Home < Modules:ChangeTracker-Documentation

Return to Slicer Documentation

ChangeTracker

ChangeTracker analysis results
ChangeTracker greetings

General Information

Module Type & Category

Type: Interactive

Category: Base/Segmentation

Authors, Collaborators & Contact

  • Kilian Pohl, IBM Research/SPL
  • Ender Konukoglu, INRIA
  • Andriy Fedorov, SPL
  • Ron Kikinis, SPL
  • Contact: Andriy Fedorov, fedorov at spl dot bwh dot edu

Module Description

ChangeTracker is a software tool for quantification of the subtle changes in pathology. The module provides a workflow pipeline that combines user input with the medical data. As a result we provide quantitative volumetric measurements of growth/shrinkage together with the volume rendering of the tumor and color-coded visualization of the tumor growth/shrinkage.

Usage

Examples, Use Cases & Tutorials

  • The module has been designed and tested for measuring meningioma development.
  • Detecting subtle change in pathology tutorial: slides, data

Quick Tour of Features and Use

ChangeTracker uses workflow processing of the input data guided by minimal user interaction. There are 4 processing steps.

  • Step 1: Define input scans
Use drop-down controls to choose the two scans where you would like to measure pathology development. Currently, we support analysis of the images that correspond to two time points. Extending of the module to accept more than two time points is the feature under development.
Step 1: Scan selection
  • Step 2: Define volume of interest
Use the mouse pointer in combination with left button clicks to identify the bounding box enclosing pathology in three projections of the viewer. You can also use the mouse to adjust sliders defining the bounding box more precisely. If you made a mistake, click "Reset" button to start over. "Show VOI" button can be used to show/hide blue overlay of the region of interest of the the image slice views.
Step 2: ROI selection
Step 2: ROI visualization


  • Step 3: Select tumor segmentation threshold
Use threshold control slider to find the intensity that most closely approximates tumor volume. Tumor volume is rendered in the 3D viewer as you are choosing the appropriate threshold, and is also visualized as semi-transparent label in the image slice viewers.
Step 3: Threshold selection
  • Step 4: Define metric
We provide two metrics -- intensity-based and deformation-based -- to quantify tumor progression (see details in this paper). Choose the metric you would like to use.
Step 4: Metric selection
  • Analysis/Results
Results are reported as the change in tumor volume, separately for growth and shrinkage component. The quantitative results are reported in voxels and mm^3.

Sensitivity of the analysis can be controlled by choosing Sensitive, Moderate, or Robust analysis approach (Robust being the most conservative). As you change the sensitivity, visualization and quantitative data are updated accordingly. Growth is shown in purple, and shrinkage -- in green color.

You can choose to display the original sampling grid, and view the coronal slice of the subject using the module controls.

Visualization of the analysis results

Development

Dependencies

ChangeTracker is using Rigid Registration module through the CommandLineModule shared object invocation. Note, that there are two distinct rigid registration modules in Slicer, which have identical functionality: "Linear registration" and "Rigid registration". Both of these modules should be available in your build, but "Rigid registration" *must* be available for ChangeTracker to function properly. You can verify the availability of the module manually by looking at the list of modules in the registration category.
Checking availability of Rigid registration module (click to zoom in)

Known bugs

Follow this link to the Slicer3 bug tracker.


Usability issues

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

Source code & documentation

Follow this link to the ChangeTracker source code in ViewVC.

Documentation generated by doxygen.

More Information

Acknowledgment

ChangeTracker development has been funded by Brain Science Foundation

References

  • E.Konukoglu, W.M.Wells, S.Novellas, N.Ayache, R.Kikinis, P.M.Black, K.M.Pohl. Monitoring Slowly Evolving Tumors. Proc. of 5th IEEE International Symposium on Biomedical Imaging: From Nano to Macro 2008, pp.812-815 link