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

From Slicer Wiki
Jump to: navigation, search
(Initial version)
 
(Added panel information and screenshot)
Line 48: Line 48:
 
<!-- ---------------------------- -->
 
<!-- ---------------------------- -->
 
{{documentation/{{documentation/version}}/module-section|Panels and their use}}
 
{{documentation/{{documentation/version}}/module-section|Panels and their use}}
 +
{|
 +
|
 +
* <span style="color:blue">'''''Input Parameters'''''</span>: Input parameters for analysis.
 +
** <span style="color:green">'''Input T1 Volume'''</span> [<span style="color:orange">----inputT1Volume</span>] : Required: input T1 image
 +
** <span style="color:green">'''Input T2 Volume'''</span> [<span style="color:orange">----inputT2Volume</span>] : Required: input T2 image
 +
** <span style="color:green">'''Input FLAIR Volume'''</span> [<span style="color:orange">----inputFLAIRVolume</span>] : Required: input FLAIR image
 +
** <span style="color:green">'''Input Brain Mask Volume'''</span> [<span style="color:orange">----inputMaskVolume</span>] : Required: input brain mask image
 +
** <span style="color:green">'''Input T1 Reference Volume'''</span> [<span style="color:orange">----inputT1RefVolume</span>] : Required: input T1 image
 +
** <span style="color:green">'''Input T2 Reference Volume'''</span> [<span style="color:orange">----inputT2RefVolume</span>] : Required: input T2 image
 +
** <span style="color:green">'''Input FLAIR Reference Volume'''</span> [<span style="color:orange">----inputFLAIRRefVolume</span>] : Required: input FLAIR image
 +
** <span style="color:green">'''Input Brain Mask Reference Volume'''</span> [<span style="color:orange">----inputMaskRefVolume</span>] : Required: input brain mask image
 +
** <span style="color:green">'''Input Lesion Segmentation Model File'''</span> [<span style="color:orange">----inputModel</span>] : The file containing the lesion segmentation model.
  
 +
* <span style="color:blue">'''''Advanced Options'''''</span>: Advanced input parameters
 +
** <span style="color:green">'''Percent Lesion Threshold'''</span> [<span style="color:orange">----inputLesionThreshold</span>] : Percent value above which a voxel should be considered lesion.  Increasing this number increases false negatives and decreases false positives. ''Default value: 30''
 +
* <span style="color:blue">'''''Output Parameters'''''</span>: Output parameters.
 +
** <span style="color:green">'''Output Lesion Mask Volume'''</span> [<span style="color:orange">----outputLesionVolume</span>] : Required: output lesion mask image
 +
** <span style="color:green">'''Output Lesion Probability Volume'''</span> [<span style="color:orange">----outputLesionProbVolume</span>] : Required: output lesion probability image
 +
 +
|[[Image:PredictModelInterface.png|thumb|280px|User Interface]]
 +
|}
 
<!-- ---------------------------- -->
 
<!-- ---------------------------- -->
 
{{documentation/{{documentation/version}}/module-section|Similar Modules}}
 
{{documentation/{{documentation/version}}/module-section|Similar Modules}}

Revision as of 19:52, 22 June 2012

Home < Documentation < 4.1 < Modules < PredictLesions


Introduction and Acknowledgements

Extension: LesionSegmentation
Acknowledgments: This work is part of the National Alliance for Medical Image Computing (NAMIC), funded by the National Institutes of Health through the NIH Roadmap for Medical Research, Grant U54 EB005149.
Author: Mark Scully ()
Contact: Mark Scully, <email>mark@biomedicalmining.com</email>

National Alliance for Medical Image Computing (NA-MIC)  

Module Description

This module is used to segment white matter lesions using an existing segmentation model. In order to use this tool your data must include a T1, T2, FLAIR, and brain mask. All data must be preprocessed including intra-subject co-registration, AC-PC alignment, bias correction, consistent spacing between sequences, and brain mask creation.


Use Cases

  1. Segmenting Lesions based on an existing model.

In order to perform segmentations you must first have access to an existing model (a model trained on 1.5T lupus data is available [|here]) and the images that were used for intensity standardization when training that model (the images for the lupus model are available [|here]. Performing a segmentation can then be done by loading the T1, T2, FLAIR, and brain mask for the subject you would like to segment, the reference T1, T2, FLAIR, and brain mask for intensity standardization, and the segmentation model. (Image of loading data to go here)

Navigate to Modules->Segmentation->LesionSegmentation->PredictLesions, then populate the appropriate parts of the PredictLesions input panel: (Image of populated input panel goes here.)

Then create a new volume (and a name, if you like) for the ouput lesion mask and the output probability volume. (Image of input panel with new outputs goes here)

Then press "Run" and wait approximately twenty minutes. The Lesion Probability Volume output will be an image where each voxel contains a value from 0 to 100 representing the percent chance that voxel is a lesion. The lesion mask contains zeros and ones and is a version of the Lesion Probability Volume thresholded at the inputLesionThreshold value which defaults to 70. (Image of Lesion Probability Volume) (Image of Lesion Mask)

If you navigate to the Volumes tab and select the Lesion Probability Volume you can then adjust the lower threshold to a value between 1-100. This effectively trades-off between sensitivity and specificity. (Image of adjusting the threshold)

Tutorials

Coming soon!

Panels and their use

  • Input Parameters: Input parameters for analysis.
    • Input T1 Volume [----inputT1Volume] : Required: input T1 image
    • Input T2 Volume [----inputT2Volume] : Required: input T2 image
    • Input FLAIR Volume [----inputFLAIRVolume] : Required: input FLAIR image
    • Input Brain Mask Volume [----inputMaskVolume] : Required: input brain mask image
    • Input T1 Reference Volume [----inputT1RefVolume] : Required: input T1 image
    • Input T2 Reference Volume [----inputT2RefVolume] : Required: input T2 image
    • Input FLAIR Reference Volume [----inputFLAIRRefVolume] : Required: input FLAIR image
    • Input Brain Mask Reference Volume [----inputMaskRefVolume] : Required: input brain mask image
    • Input Lesion Segmentation Model File [----inputModel] : The file containing the lesion segmentation model.
  • Advanced Options: Advanced input parameters
    • Percent Lesion Threshold [----inputLesionThreshold] : Percent value above which a voxel should be considered lesion. Increasing this number increases false negatives and decreases false positives. Default value: 30
  • Output Parameters: Output parameters.
    • Output Lesion Mask Volume [----outputLesionVolume] : Required: output lesion mask image
    • Output Lesion Probability Volume [----outputLesionProbVolume] : Required: output lesion probability image
User Interface

Similar Modules

References

  • Scully M, Anderson B, Lane T, Gasparovic C, Magnotta V, Sibbitt W, Roldan C, Kikinis R and Bockholt HJ (2010) An automated method for segmenting white matter lesions through multi-level morphometric feature classification with application to lupus. Front. Hum. Neurosci. doi:10.3389/fnhum.2010.00027

http://frontiersin.org/neuroscience/humanneuroscience/paper/10.3389/fnhum.2010.00027/


Information for Developers