Difference between revisions of "Documentation/4.4/Modules/ABC"

From Slicer Wiki
Jump to: navigation, search
Line 33: Line 33:
 
The software is designed and tested for healthy brain MRI (pediatric - adult). Initiating the pipeline requires the specification of an atlas (which contains a template image and prior probability images) and at least one image modality for a subject. The module can accommodate up to five modalities, which need not be registered beforehand. All images are assumed to have the correct metadata for spatial orientation.
 
The software is designed and tested for healthy brain MRI (pediatric - adult). Initiating the pipeline requires the specification of an atlas (which contains a template image and prior probability images) and at least one image modality for a subject. The module can accommodate up to five modalities, which need not be registered beforehand. All images are assumed to have the correct metadata for spatial orientation.
  
The atlas can be specified through the first panel. The module assumes that it is stored in a directory where the template image (e.g., a T1 image) is specified as template.mha and that the prior images are stored in sequence (1.mha, 2.mha, ...). An example atlas can be found at , which needs to be uncompressed and stored in a local path before running the module.
+
{|
 +
|[[Image:abc_panels.png|thumb|280px|'''Extension Panels.''']]
 +
|[[Image:abc_panels_marked.png|thumb|280px|'''Annotated Extension Panels.''']]
 +
|}
  
The input images are specified in the second panel. The choice of the first image in the list is crucial, as the outputs are generated in the space of the first image. All other modality images and the atlas are registered to the first image during processing.
+
The input images are specified in the first panel. The choice of the first image in the list is crucial, as the outputs are generated in the space of the first image. All other modality images and the atlas are registered to the first image during processing.
 +
The atlas can be specified through the second panel. The module assumes that it is stored in a directory where the template image (e.g., a T1 image) is specified as template.mha and that the prior images are stored in sequence (1.mha, 2.mha, ...). An example atlas is available through NITRC for adult brains: [https://www.nitrc.org/frs/download.php/1766/adult-atlas-abc1.1.zip Adult Brain Atlas], which needs to be uncompressed and stored in a local path before running the module.
  
The output images are specified in the third panel. Users can specify the target volumes for the segmentation labels as well as the bias corrected images for each modality. The bias corrected output images do not need to be specified if they are of no interest.
+
The output images are specified in the third panel. Users can create and specify the target volumes for the segmentation labels as well as the bias corrected images for each modality. The bias corrected output images do not need to be specified if they are of no interest.
  
Once all input parameters have been specified, execution can be initiated by clicking the Apply button.
+
Once all input parameters have been specified, execution can be initiated by clicking the '''Apply''' button.
  
The processing involved in the module can take up to five minutes for a typical MR image, using the default setting that was chosen to generate coarser results. Speed-ups are possible by increasing the number of threads (specified in the Speed panel). Results with higher accuracy can be obtained by increasing the maximum polynomial degree of the bias field (in the Advanced panel), increasing the number of pre-filtering iterations (in the Advanced panel), and switching to finer sampling for image registration (in the Speed panel).
+
The processing involved in the module can take up to five minutes for a typical MR image, using the default setting that was chosen to generate coarser results. Speed-ups are possible by increasing the number of threads (specified in the '''Speed''' panel). Results with higher accuracy can be obtained by increasing the maximum polynomial degree of the bias field (in the '''Advanced''' panel), increasing the number of pre-filtering iterations (in the Advanced panel), and switching to finer sampling for image registration (in the '''Speed''' panel).
  
 
<!-- ---------------------------- -->
 
<!-- ---------------------------- -->

Revision as of 16:57, 18 September 2015

Home < Documentation < 4.4 < Modules < ABC

For the latest Slicer documentation, visit the 4.10 page.


Introduction and Acknowledgements

Author: Marcel Prastawa
Contact: Marcel Prastawa, <email>marcel.prastawa@gmail.com</email>
Website: http://www.nitrc.org/projects/abc

Acknowledgments: This project was supported by NIH grant U54 EB005149.



Module Description

ABC (Atlas Based Classification) is a full segmentation pipeline designed and developed for healthy brain MRIs. The processing pipeline includes image registration, filtering, inhomogeneity correction, and skull stripping.


Tutorials

The software is designed and tested for healthy brain MRI (pediatric - adult). Initiating the pipeline requires the specification of an atlas (which contains a template image and prior probability images) and at least one image modality for a subject. The module can accommodate up to five modalities, which need not be registered beforehand. All images are assumed to have the correct metadata for spatial orientation.

Extension Panels.
Annotated Extension Panels.

The input images are specified in the first panel. The choice of the first image in the list is crucial, as the outputs are generated in the space of the first image. All other modality images and the atlas are registered to the first image during processing. The atlas can be specified through the second panel. The module assumes that it is stored in a directory where the template image (e.g., a T1 image) is specified as template.mha and that the prior images are stored in sequence (1.mha, 2.mha, ...). An example atlas is available through NITRC for adult brains: Adult Brain Atlas, which needs to be uncompressed and stored in a local path before running the module.

The output images are specified in the third panel. Users can create and specify the target volumes for the segmentation labels as well as the bias corrected images for each modality. The bias corrected output images do not need to be specified if they are of no interest.

Once all input parameters have been specified, execution can be initiated by clicking the Apply button.

The processing involved in the module can take up to five minutes for a typical MR image, using the default setting that was chosen to generate coarser results. Speed-ups are possible by increasing the number of threads (specified in the Speed panel). Results with higher accuracy can be obtained by increasing the maximum polynomial degree of the bias field (in the Advanced panel), increasing the number of pre-filtering iterations (in the Advanced panel), and switching to finer sampling for image registration (in the Speed panel).

Panels and their use

Parameters:





  ()
 
 
   
     * ': 
     
       ** ': 
       
        *** ': 
       
     
   
 


List of parameters generated transforming this XML file using this XSL file. To update the URL of the XML file, edit this page.


Similar Modules

EMSegmenter


References

Information for Developers


Source code can be found at http://www.nitrc.org/plugins/scmsvn/viewcvs.php/?root=abc