Difference between revisions of "Documentation/4.0/Modules/ChangeTracker"

From Slicer Wiki
Jump to: navigation, search
Line 59: Line 59:
 
|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.
 
|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.
  
|[[Image:Slicer4_ChangeTracker_Step1.png|thumb|250px|Step 1: Scan selection]]
+
|[[Image:Slicer4_ChangeTracker_Step1.png|thumb|450px|Step 1: Scan selection]]
 
|}
 
|}
  
 
* '''Step 2: Define volume of interest'''
 
* '''Step 2: Define volume of interest'''
  
This step of wizard includes the following user controls to facilitate Volume of Interest (VOI) selection:
+
{|
 +
|This step of wizard includes the following user controls to facilitate Volume of Interest (VOI) selection:
 
* "Hide/show render" button: used to control visibility of volume rendering for the selected region
 
* "Hide/show render" button: used to control visibility of volume rendering for the selected region
 
* "ROI Widget Controls: RAS Space" frame: contains sliders to initialize VOI in RAS (physical) space
 
* "ROI Widget Controls: RAS Space" frame: contains sliders to initialize VOI in RAS (physical) space
"ROI Widget" refers to the three-dimensional selection box that appears in the 3d slice view once you begin to select VOI.
+
"ROI Widget" refers to the three-dimensional selection box that appears in the 3d slice view once you begin to select VOI. You can define VOI by adjusting the colored handles of the ROI widget in the slice viewer or 3d viewer.
  
You can define VOI by adjusting the colored handles of the ROI widget in the slice viewer or 3d viewer.
+
|[[Image:Slicer4_ChangeTracker_Step2.png|thumb|450px|Step 2: ROI Widget controls in wizard GUI]]
 
 
{|
 
|[[Image:Slicer4_ChangeTracker_Step2.png|thumb|250px|Step 2: ROI Widget controls in wizard GUI]]
 
 
|}
 
|}
  
Line 95: Line 93:
 
In some cases, the automatic registration functionality in ChangeTracker may not be able to accurately register your data. If this happens, you can use the '''Advanced''' tab to register your data, and place Scan2 under the transform. ChangeTracker will use the prescribed transform and will skip registration step.
 
In some cases, the automatic registration functionality in ChangeTracker may not be able to accurately register your data. If this happens, you can use the '''Advanced''' tab to register your data, and place Scan2 under the transform. ChangeTracker will use the prescribed transform and will skip registration step.
  
|[[Image:Slicer4_ChangeTracker_Step4.png|thumb|250px|Step 4: ROI Analysis]]
+
|[[Image:Slicer4_ChangeTracker_Step4.png|thumb|450px|Step 4: ROI Analysis]]
 
|}
 
|}
  
Line 108: Line 106:
 
* Compare view: first row contains the resampled ROI corresponding to the first time-point as foreground, with the growth analysis results in the background. The second row contains resampled ROI corresponding to the second time-point.
 
* Compare view: first row contains the resampled ROI corresponding to the first time-point as foreground, with the growth analysis results in the background. The second row contains resampled ROI corresponding to the second time-point.
  
|[[Image:Slicer4_ChangeTracker_Step5.png|thumb|250px|Step 5: ROI Analysis Results]]
+
|[[Image:Slicer4_ChangeTracker_Step5.png|thumb|450px|Step 5: ROI Analysis Results]]
 
|}
 
|}
  

Revision as of 04:14, 22 November 2011

Home < Documentation < 4.0 < Modules < ChangeTracker


tumb

Introduction and Acknowledgements

This work is supported by NA-MIC, NAC, NCIGT, and the Slicer Community. This work is partially supported by NIH U01 CA151261
Author: Andrey Fedorov, Kilian Pohl, Peter Black, Ron Kikinis, SPL
Contact: Andrey Fedorov <email>fedorov@bwh.harvard.edu</email>

NA-MIC  
Brain Science Foundation  
NCIGT  


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.

ChangeTracker is not yet a generic tool for detecting small changes. It has been tuned specifically for meningioma growth analysis. Specifically, the assumptions made by ChangeTracker are

  • the analyzed images are roughly aligned
  • the pathology area is characterized by bright image intensities (contrast-enhanced meningioma MRI)
  • images have similar, close to isotropic, spacing
  • the change in pathology between the consequtive scans is small in relation to the total pathology volume.

If you want to apply ChangeTracker on non-meningioma data, please let us know. The algorithm is likely to require tuning of the parameters for registration and other processing steps.

Use Cases

Most frequently used for these scenarios:

  • Quantification of small changes in meningioma tumor volume from post-contrast MRI

Tutorials

Under development

The test data can be downloaded automatically by pushing the "Load test data" in the panel of the first step (you will need the internet connection).

Panels and their use

ChangeTracker is organized as a workflow that consists of the following 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.
Step 1: Scan selection
  • Step 2: Define volume of interest
This step of wizard includes the following user controls to facilitate Volume of Interest (VOI) selection:
  • "Hide/show render" button: used to control visibility of volume rendering for the selected region
  • "ROI Widget Controls: RAS Space" frame: contains sliders to initialize VOI in RAS (physical) space

"ROI Widget" refers to the three-dimensional selection box that appears in the 3d slice view once you begin to select VOI. You can define VOI by adjusting the colored handles of the ROI widget in the slice viewer or 3d viewer.

Step 2: ROI Widget controls in wizard GUI


  • Step 3: Segment the analyzed structure
Use threshold control slider to find the intensity that most closely approximates tumor volume. Thresholded volume is rendered interactively in the 3D viewer as you are adjusting the threshold value, and is also visualized as semi-transparent label in the image slice viewers.

Note, that currently ChangeTracker expects that the tissue you monitor is hyperintensive on the image.

In the cases when threshold is not effective in segmenting the structure of interest, Advanced tab allows to prescribe the segmentation label image directly, instead of using threshold. (this feature is currently disabled, under development)

Step 3: ChangeTracker ROI segmentation
  • Step 4: ROI Analysis
We provide two metrics to quantify tumor progression: intensity-based and deformation-based (see details in this paper). Choose the metric(s) you would like to use.

In some cases, the automatic registration functionality in ChangeTracker may not be able to accurately register your data. If this happens, you can use the Advanced tab to register your data, and place Scan2 under the transform. ChangeTracker will use the prescribed transform and will skip registration step.

Step 4: ROI Analysis
  • Step 5: ROI Analysis Results
Results are reported as the change in tumor volume, separately for growth and shrinkage component. The quantitative results are reported in voxels, mL and percentage relative the the volume of the structure segmented in the baseline scan.

The visualization of the analysis results includes the following components upon the completion of analysis:

  • Red slice view: resampled VOI for the second of the analyzed time-points
  • 3d slice viewer: color-coded results of the change analysis. Red color corresponds to the estimated growth regions, Green corresponds to estimated shrinkage.
  • Compare view: first row contains the resampled ROI corresponding to the first time-point as foreground, with the growth analysis results in the background. The second row contains resampled ROI corresponding to the second time-point.
Step 5: ROI Analysis Results


Similar Modules

  • Point to other modules that have similar functionality

References

Publications related to this module go here. Links to pdfs would be useful. For extensions: link to the source code repository and additional documentation

Information for Developers


Note The section above is generated using the following wiki code:

{{documentation/{{documentation/version}}/module-section|Information for Developers}}
{{documentation/{{documentation/version}}/module-developerinfo|ModuleTemplate|type=Interactive|category=Example}}

If you are documenting a CLI, the category should be extracted from the corresponding XML description. This could be done automatically using the following wiki template:

{{documentation/{{documentation/version}}/module-category|xmlurl=http://path/to/YOURMODULENAME.xml }}

If your module is available in Slicer repository, the following template could be useful to obtain the corresponding URL:

{{documentation/{{documentation/version}}/module-cli-xmlurl|{{documentation/modulename}}|SVNREVISION}}

Using this later template, the final syntax would be:

{{documentation/{{documentation/version}}/module-category|xmlurl={{documentation/{{documentation/version}}/module-cli-xmlurl|{{documentation/modulename}}|SVNREVISION}} }}