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

From Slicer Wiki
Jump to: navigation, search
(Prepend documentation/versioncheck template. See http://na-mic.org/Mantis/view.php?id=2887)
 
(13 intermediate revisions by 3 users not shown)
Line 1: Line 1:
 +
<noinclude>{{documentation/versioncheck}}</noinclude>
 
<!-- ---------------------------- -->
 
<!-- ---------------------------- -->
 
{{documentation/{{documentation/version}}/module-header}}
 
{{documentation/{{documentation/version}}/module-header}}
Line 7: Line 8:
 
{{documentation/{{documentation/version}}/module-introduction-start|{{documentation/modulename}}}}
 
{{documentation/{{documentation/version}}/module-introduction-start|{{documentation/modulename}}}}
 
{{documentation/{{documentation/version}}/module-introduction-row}}
 
{{documentation/{{documentation/version}}/module-introduction-row}}
This work is supported by NA-MIC, NAC, NCIGT, and the Slicer Community. This work is partially supported by NIH U01 CA151261<br>
+
This work is supported by NA-MIC, NAC, NCIGT, and the Slicer Community. This work is partially supported by Brain Science Foundation and NIH U01 CA151261.<br>
 
Author: Andrey Fedorov, Kilian Pohl, Peter Black, Ron Kikinis, SPL <br>
 
Author: Andrey Fedorov, Kilian Pohl, Peter Black, Ron Kikinis, SPL <br>
 
Contact: Andrey Fedorov <email>fedorov@bwh.harvard.edu</email> <br>
 
Contact: Andrey Fedorov <email>fedorov@bwh.harvard.edu</email> <br>
 
{{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
|Image:NAMIC 380x463.jpg|NA-MIC
+
|{{collaborator|logo|namic}}|{{collaborator|longname|namic}}
 +
|{{collaborator|logo|bsf}}|{{collaborator|longname|bsf}}
 +
|{{collaborator|logo|ncigt}}|{{collaborator|longname|ncigt}}
 +
|{{collaborator|logo|spl}}|{{collaborator|longname|spl}}
 
}}
 
}}
 
{{documentation/{{documentation/version}}/module-introduction-end}}
 
{{documentation/{{documentation/version}}/module-introduction-end}}
 
<!-- ----------------------------------------------------------------- -->
 
<!-- THE FOLLOWING SHOULD BE REMOVED FOR YOUR OWN MODULE DOCUMENTATION -->
 
<!-- ----------------------------------------------------------------- -->
 
  
  
 
<!-- ---------------------------- -->
 
<!-- ---------------------------- -->
 
{{documentation/{{documentation/version}}/module-section|Module Description}}
 
{{documentation/{{documentation/version}}/module-section|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 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
+
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 pathology area is characterized by bright image intensities (contrast-enhanced meningioma MRI)
+
* the analyzed images are roughly aligned  
images have similar, close to isotropic, spacing
+
* the pathology area is characterized by bright image intensities (contrast-enhanced meningioma MRI)  
the change in pathology between the consequtive scans is small in relation to the total pathology volume
+
* 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.
 
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.
 +
 +
|[[Image:Slicer4_ChangeTracker_Ad.png|thumb|450px|ChangeTracker processing results visualization]]
 +
|}
 +
  
 
<!-- ---------------------------- -->
 
<!-- ---------------------------- -->
Line 38: Line 47:
 
<!-- ---------------------------- -->
 
<!-- ---------------------------- -->
 
{{documentation/{{documentation/version}}/module-section|Tutorials}}
 
{{documentation/{{documentation/version}}/module-section|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).
  
 
<!-- ---------------------------- -->
 
<!-- ---------------------------- -->
 
{{documentation/{{documentation/version}}/module-section|Panels and their use}}
 
{{documentation/{{documentation/version}}/module-section|Panels and their use}}
  
A list of all the panels in the interface, their features, what they mean, and how to use them. For instance:
+
ChangeTracker is organized as a workflow that consists of the following steps:
  
{|style="width: 100%"
+
* '''Step 1: Define input scans'''
|
+
 
* Input panel1:
+
{|
** First input
+
|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.
** Second input
+
 
* Parameters panel:
+
|[[Image:Slicer4_ChangeTracker_Step1.png|thumb|450px|Step 1: Scan selection]]
** First parameter
+
|}
** Second parameter
+
 
* Output panel:
+
* '''Step 2: Define volume of interest'''
** First output
+
 
** Second output
+
{|
* Viewing panel:
+
|This step of wizard includes the following user controls to facilitate Volume of Interest (VOI) selection:
| align="right" |
+
* "Hide/show render" button: used to control visibility of volume rendering for the selected region
[[Image:screenshotBlankNotOptional.png|thumb|280px|Name of panel 1]]
+
* "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.
|
+
 
* Input panel2:
+
|[[Image:Slicer4_ChangeTracker_Step2.png|thumb|450px|Step 2: ROI Widget controls in wizard GUI]]
** First input
+
|}
** Second input
+
 
* Parameters panel:
+
 
** First parameter
+
* '''Step 3: Segment the analyzed structure'''
** Second parameter
+
 
* Output panel:
+
{|
** First output
+
|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.
** Second output
+
 
* Viewing panel:
+
Note, that currently ChangeTracker expects that the tissue you monitor is hyperintensive on the image.
| align="right" |
+
 
[[Image:screenshotBlankNotOptional.png|thumb|280px|Name of panel 2]]
+
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'')
 +
 
 +
|[[Image:Slicer4_ChangeTracker_Step3.png|thumb|450px|Step 3: ChangeTracker ROI segmentation]]
 +
|}
 +
 
 +
* '''Step 4: ROI Analysis'''
 +
 
 +
{|
 +
|Choose the metric(s) you would like to use. ChangeTracker provides an extensible framework for developing and incorporating change quantification metrics into the workflow (see Information for Developers section). The metrics currently available are the following (follow the links for details and documentation):
 +
* [[Documentation/4.0/Modules/IntensityDifferenceMetric | Intensity Difference Metric]] is based on intensity difference between the two ROIs
 +
 
 +
In some cases, the registration procedure that ChangeTracker is using may not be robust enough to align your data. If this happens and the baseline and followup ROIs are not aligned after this step, you can use the '''Advanced''' tab to register your data, and place followup volume under the transform. ChangeTracker will use the prescribed transform and will skip registration step.
 +
 
 +
|[[Image:Slicer4_ChangeTracker_Step4.png|thumb|450px|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.
 +
 
 +
|[[Image:Slicer4_ChangeTracker_Step5.png|thumb|450px|Step 5: ROI Analysis Results]]
 
|}
 
|}
 +
  
 
<!-- ---------------------------- -->
 
<!-- ---------------------------- -->
 
{{documentation/{{documentation/version}}/module-section|Similar Modules}}
 
{{documentation/{{documentation/version}}/module-section|Similar Modules}}
* Point to other modules that have similar functionality
+
N/A
  
 
<!-- ---------------------------- -->
 
<!-- ---------------------------- -->
 
{{documentation/{{documentation/version}}/module-section|References}}
 
{{documentation/{{documentation/version}}/module-section|References}}
Publications related to this module go here. Links to pdfs would be useful.
+
* Konukoglu, E., Wells, W. M., Novellas, S., Ayache, N., Kikinis, R., Black, P. M., & Pohl, K. M. (2008). Monitoring slowly evolving tumors. 2008 5th IEEE International Symposium on Biomedical Imaging: From Nano to Macro (pp. 812-815). IEEE. doi:10.1109/ISBI.2008.4541120 [http://www.spl.harvard.edu/publications/item/view/1958 URL]
For extensions: link to the source code repository and additional documentation
+
* Pohl, K. M., Konukoglu, E., Novellas, S., Ayache, N., Fedorov, A., Talos, I.-F., Golby, A., et al. (2011). A new metric for detecting change in slowly evolving brain tumors: validation in meningioma patients. Neurosurgery, 68(1 Suppl Operative), 225-33. doi:10.1227/NEU.0b013e31820783d5 [http://www.spl.harvard.edu/publications/item/view/1958 URL]
  
 
<!-- ---------------------------- -->
 
<!-- ---------------------------- -->
 
{{documentation/{{documentation/version}}/module-section|Information for Developers}}
 
{{documentation/{{documentation/version}}/module-section|Information for Developers}}
{{documentation/{{documentation/version}}/module-developerinfo|ModuleTemplate|type=Interactive|category=Base}}
+
{{documentation/{{documentation/version}}/module-developerinfo}}
 
 
 
 
<!-- ----------------------------------------------------------------- -->
 
<!-- THE FOLLOWING SHOULD BE REMOVED FOR YOUR OWN MODULE DOCUMENTATION -->
 
<!-- ----------------------------------------------------------------- -->
 
{{note}}The section above is generated using the following wiki code:
 
<pre>
 
{{documentation/{{documentation/version}}/module-section|Information for Developers}}
 
{{documentation/{{documentation/version}}/module-developerinfo|ModuleTemplate|type=Interactive|category=Example}}
 
</pre>
 
 
 
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:<pre>{{documentation/{{documentation/version}}/module-category|xmlurl=http://path/to/YOURMODULENAME.xml }}</pre>
 
 
 
If your module is available in Slicer repository, the following template could be useful to obtain the corresponding URL:
 
<pre>{{documentation/{{documentation/version}}/module-cli-xmlurl|{{documentation/modulename}}|SVNREVISION}}</pre>
 
 
 
Using this later template, the final syntax would be:
 
<pre>{{documentation/{{documentation/version}}/module-category|xmlurl={{documentation/{{documentation/version}}/module-cli-xmlurl|{{documentation/modulename}}|SVNREVISION}} }}</pre>
 
<!-- ----------------------------------------------------------------- -->
 
<!-- ----------------------------------------------------------------- -->
 
<!-- ----------------------------------------------------------------- -->
 
  
  
 
<!-- ---------------------------- -->
 
<!-- ---------------------------- -->
{{documentation/{{documentation/version}}/module-footer|category=Example}}
+
{{documentation/{{documentation/version}}/module-footer}}
 
<!-- ---------------------------- -->
 
<!-- ---------------------------- -->

Latest revision as of 07:36, 14 June 2013

Home < Documentation < 4.0 < Modules < ChangeTracker


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



Introduction and Acknowledgements

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

National Alliance for Medical Image Computing (NA-MIC)  
Brain Science Foundation (BSF)  
National Center for Image Guided Therapy (NCIGT)  
Surgical Planning Laboratory (SPL)  


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.

ChangeTracker processing results visualization


Use Cases

Most frequently used for these scenarios:

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

Tutorials

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
Choose the metric(s) you would like to use. ChangeTracker provides an extensible framework for developing and incorporating change quantification metrics into the workflow (see Information for Developers section). The metrics currently available are the following (follow the links for details and documentation):

In some cases, the registration procedure that ChangeTracker is using may not be robust enough to align your data. If this happens and the baseline and followup ROIs are not aligned after this step, you can use the Advanced tab to register your data, and place followup volume 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

N/A

References

  • Konukoglu, E., Wells, W. M., Novellas, S., Ayache, N., Kikinis, R., Black, P. M., & Pohl, K. M. (2008). Monitoring slowly evolving tumors. 2008 5th IEEE International Symposium on Biomedical Imaging: From Nano to Macro (pp. 812-815). IEEE. doi:10.1109/ISBI.2008.4541120 URL
  • Pohl, K. M., Konukoglu, E., Novellas, S., Ayache, N., Fedorov, A., Talos, I.-F., Golby, A., et al. (2011). A new metric for detecting change in slowly evolving brain tumors: validation in meningioma patients. Neurosurgery, 68(1 Suppl Operative), 225-33. doi:10.1227/NEU.0b013e31820783d5 URL

Information for Developers