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

From Slicer Wiki
Jump to: navigation, search
Line 148: Line 148:
 
===Source code & documentation===
 
===Source code & documentation===
  
SpineSegmentation's source code (revision 151):
+
Module source code (revision 151):
  
 
*[http://www.nitrc.org/plugins/scmsvn/viewcvs.php/Slicer3/Modules/SpineSegmentation/SpineSegmentation.cxx?annotate=151&root=sylvainproject SpineSegmentation.cxx]  
 
*[http://www.nitrc.org/plugins/scmsvn/viewcvs.php/Slicer3/Modules/SpineSegmentation/SpineSegmentation.cxx?annotate=151&root=sylvainproject SpineSegmentation.cxx]  
 
*[http://www.nitrc.org/plugins/scmsvn/viewcvs.php/Slicer3/Modules/SpineSegmentation/SpineSegmentation.xml?annotate=151&root=sylvainproject SpineSegmentation.xml]
 
*[http://www.nitrc.org/plugins/scmsvn/viewcvs.php/Slicer3/Modules/SpineSegmentation/SpineSegmentation.xml?annotate=151&root=sylvainproject SpineSegmentation.xml]
 
   
 
   
Slicer's Doxygen documentation:
+
Doxygen generated documentation:
*[http://www.na-mic.org/Slicer/Documentation/Slicer3-doc/html/classes.html class1]
+
*[http://www.na-mic.org/Slicer/Documentation/Slicer3-doc/html/classes.html Slicer Doxygen]
  
 
== More Information ==  
 
== More Information ==  

Revision as of 17:20, 14 May 2010

Home < Modules:SpineSegmentation-Documentation-3.6

Return to Slicer 3.6 Documentation

Gallery of New Features


Module Name

SpineSegmentation module for Slicer 3.6 (available through Slicer extension manager)

A sample data set is available on http://nitrc.org. Download both .mhd and .zraw files.
The SpineSegmentation module is available through the Slicer extension module manager.
After 3 minutes, the segmentation results appear: a label map (blue) and a 3D model (3D view).

General Information

Module Type & Category

Type: Interactive or CLI

Category: Segmentation

Authors, Collaborators & Contact

  • Sylvain Jaume: MIT CSAIL
  • Contact: sylvain at csail.mit.edu
MIT & NA-MIC

Module Description

Image segmentation of the spinal cord and the cerebro-spinal fluid in T2-weighted MRI images. The SpineSegmentation module builds on Pattern Recognition theory to provide for a fully automated segmentation. The module first defines a shape model of the spinal cord modeling both the inner volume and the outer volume. Then the segmentation algorithm uses this model to explored the image space and find the best match given the field on intensities in the image. The advantage of this method relies on its unsupervised property: no need for any parameter setting or any initialization.

Usage

Use Cases, Examples

This module is especially appropriate for this use case:

  • Automated segmentation of MRI of the spine is critical during minimally invasive intervention when frequent acquisitions of intra-operative images prevents the manual segmentation of the image by an expert. The SpineSegmentation module provides a solution to reduce the burden on the radiologist.

Examples of the module in use:

  • Image-guided surgery for the treatment of disk herniation

Tutorial

Below are the step-by-step instructions to load, process and save some sample data (see link above).

  • Step 0/9. Download Sample Data
0. download sample data

The sample data sets MRI_Spine.mhd and MRI_Spine.zraw are available at the link below. You will need to create a username on http://nitrc.org. Then log onto nitrc.org and click on the link below. Right-click on MRI_Spine.mhd and MRI_Spine.zraw to copy those files to your local directory.

http://www.nitrc.org/plugins/scmsvn/viewcvs.php/Slicer3/Modules/SpineSegmentation/TestingData/?root=sylvainproject
  • Step 1/9. Load the sample data
1. load sample data
  • Step 2/9. Select the SpineSegmentation module.
2. select SpineSegmentation module
  • Step 3/9. Select the input image.
3. select input image
  • Step 4/9. Create a Slicer node for the output image.
4. create image node
  • Step 5/9. Create a Slicer node for the output model.
5. create model node
  • Step 6/9. Apply the segmentation algorithm.
6. apply algorithm
  • Step 7/9. Review segmentation result.
7. review result

The sliders on the top of each 2D view allows for reviewing the segmentation result overlaid on the input image.

  • Step 8/9. Save result image and model.
8. save results

The output image and the 3D model can be saved using the Slicer user interface.

  • Step 9/9. Find contact information for help and paper reference.
9. help information

Quick Tour of Features and Use

  • Input panel:
    • Image input: select the input image
    • Image output: create Slicer node for output image
    • Model output: create Slicer node for output model
  • Command panel:
    • Default: reset input and output nodes to blank values
    • Cancel: cancel the execution of the algorithm
    • Apply: apply the segmentation algorithm (takes approx. 3 min)

Development

Notes from the Developer(s)

Reports of new use cases are welcome (email: sylvain at csail.mit.edu). If time permits, we will tune the algorithm for your data sets.

Dependencies

Linking to Slicer 3.6 is sufficient. This module requires the typical packages bundled with Slicer.

Tests

Tests are automatically generated using CTest to verify that the module is working on all platforms supported by Slicer.

Known bugs

No bugs have been found yet. If you find a bug, please first email the Slicer mailing list to verify that this is a bug due to SpineSegmentation. Once you have received an answer, follow the link below to add a bug report:

Usability issues

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

Source code & documentation

Module source code (revision 151):

Doxygen generated documentation:

More Information

Acknowledgment

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 (PI: Ron Kikinis).

References

Stochastic Neurography, S. Jaume, M. Loepprich, E.J. Schmidt, R. Kikinis, 16th Annual Meeting of the Organization for Human Brain Mapping (HBM 2010), Barcelona, Spain, June 6-10, 2010.