Difference between revisions of "Modules:ABC-Documentation-3.5"

From Slicer Wiki
Jump to: navigation, search
Line 33: Line 33:
 
===Examples, Use Cases & Tutorials===
 
===Examples, Use Cases & Tutorials===
  
* Note use cases for which this module is especially appropriate, and/or link to examples.
+
The software is designed and tested for healthy brain MRI (pediatric - adult).
* Link to examples of the module's use
+
 
* Link to any existing tutorials
+
The processing involved in the module is not designed for interactive use. It may take up to 30 minutes to 1 hour for processing a dataset. Speed-ups are possible by modifying the advanced parameters and disabling the bias correction and deformable registration of the atlas.
  
 
===Quick Tour of Features and Use===
 
===Quick Tour of Features and Use===
List all the panels in your interface, their features, what they mean, and how to use them. For instance:
 
  
 
{|
 
{|
 
|-
 
|-
 
|* '''Input Panel'''
 
|* '''Input Panel'''
Input images.  First image in the list is the reference image space. All other images are registered to first image.
+
Specify the input images representing the different modalities of the same subject (up to five).  First image in the list is the reference image space. All other images are registered to first image.
 
|[[Image:abc-slicer-inputs.png|thumb|250px|Input panel]]
 
|[[Image:abc-slicer-inputs.png|thumb|250px|Input panel]]
  
 
|-
 
|-
 
|* '''Atlas Panel'''
 
|* '''Atlas Panel'''
Atlas information.
+
Specify the atlas information. The atlas is represented as a directory that contains the template file (template.mha), and the prior probabilities (1.mha, ..., 999.mha)
Atlas directory contains the template file (template.mha), and the prior probabilities (1.mha, ..., 999.mha)
+
The atlas orientation specifies the code for the different axes ([R]ight-[L]eft, [A]nterior-[P]osterior, [I]nferior-[S]uperior): RAI, ASR, LPS, etc. If the image orientation matrix is embedded in the image, you can simply specify "file" as the orientation code.
Orientation: RAI, ASR, LPS, etc
+
The prior weight can be adjusted globally (e.g., if one class overwhelms the other it can be set a lower weight) through space separated numbers. You must specify the same amount of numbers as the amount of priors in the atlas directory.
Prior weight adjustments: space separated numbers, must be the same number as number of priors.
 
 
|[[Image:abc-slicer-atlas.png|thumb|250px|Atlas information panel]]
 
|[[Image:abc-slicer-atlas.png|thumb|250px|Atlas information panel]]
  
 
|-
 
|-
 
|* '''Output Panel'''
 
|* '''Output Panel'''
Specify where to store output files (optional). Segmentation label image, and bias corrected image.
+
Specify where to store the output files (optional), this includes the segmentation label image, and bias corrected images.
 
|[[Image:abc-slicer-outputs.png|thumb|250px|Output panel]]
 
|[[Image:abc-slicer-outputs.png|thumb|250px|Output panel]]
  
 
|-
 
|-
 
|* '''Advanced Panel'''
 
|* '''Advanced Panel'''
Advanced parameters
+
Advanced parameters for registration and bias correction. You can adjust the type of linear transformation for the alignment of the intra-subject modalities and the subject-template. Bias correction polynomial degree adjust the severity of the bias field in your images, and can this part can be disabled by setting it to zero. The amount of deformation of the atlas is controlled by the number of iterations in the fluid flow, and setting it to zero will disable the atlas deformation component.
 
|[[Image:abc-slicer-advanced.png|thumb|250px|Advanced panel]]
 
|[[Image:abc-slicer-advanced.png|thumb|250px|Advanced panel]]
  

Revision as of 18:03, 9 February 2010

Home < Modules:ABC-Documentation-3.5

Return to Slicer 3.5 Documentation

Gallery of New Features


Atlas Based Classification

Atlas Based Classification

(Documentation in progress)

Interface in Slicer 3
3D visualization of the result

General Information

Module Type & Category

Type: CLI

Category: Segmentation

Authors, Collaborators & Contact

  • Marcel Prastawa, Utah
  • Guido Gerig, Utah
  • Contact: Marcel Prastawa, prastawa@sci.utah.edu

Module Description

ABC (Atlas Based Classification) is a full segmentation pipeline developed and used at University of North Carolina and University of Utah for healthy brain MRIs. The processing pipeline includes image registration, filtering, and inhomogeneity correction.

Usage

Examples, Use Cases & Tutorials

The software is designed and tested for healthy brain MRI (pediatric - adult).

The processing involved in the module is not designed for interactive use. It may take up to 30 minutes to 1 hour for processing a dataset. Speed-ups are possible by modifying the advanced parameters and disabling the bias correction and deformable registration of the atlas.

Quick Tour of Features and Use

* Input Panel

Specify the input images representing the different modalities of the same subject (up to five). First image in the list is the reference image space. All other images are registered to first image.

Input panel
* Atlas Panel

Specify the atlas information. The atlas is represented as a directory that contains the template file (template.mha), and the prior probabilities (1.mha, ..., 999.mha) The atlas orientation specifies the code for the different axes ([R]ight-[L]eft, [A]nterior-[P]osterior, [I]nferior-[S]uperior): RAI, ASR, LPS, etc. If the image orientation matrix is embedded in the image, you can simply specify "file" as the orientation code. The prior weight can be adjusted globally (e.g., if one class overwhelms the other it can be set a lower weight) through space separated numbers. You must specify the same amount of numbers as the amount of priors in the atlas directory.

Atlas information panel
* Output Panel

Specify where to store the output files (optional), this includes the segmentation label image, and bias corrected images.

Output panel
* Advanced Panel

Advanced parameters for registration and bias correction. You can adjust the type of linear transformation for the alignment of the intra-subject modalities and the subject-template. Bias correction polynomial degree adjust the severity of the bias field in your images, and can this part can be disabled by setting it to zero. The amount of deformation of the atlas is controlled by the number of iterations in the fluid flow, and setting it to zero will disable the atlas deformation component.

Advanced panel



Development

Dependencies

None

Known bugs

Follow this link to the bug tracker at NITRC.


Source code & documentation

Available at [1]

More Information

Acknowledgment

References