Difference between revisions of "Modules:AtlasCreator"

From Slicer Wiki
Jump to: navigation, search
Line 35: Line 35:
 
===Use Cases, Examples===
 
===Use Cases, Examples===
  
This module is especially appropriate for these use cases:
+
''' Input Data Requirements '''
  
* Use Case 1:
+
The Atlas Creator expects input data to be structured the following way:
* Use Case 2:
 
  
Examples of the module in use:
+
* In general each original image is accompanied by a manual segmentation.
 +
* The images and the segmentations have to be in two different folders but have matching filenames.
 +
* For Example:
 +
**./originals/case1.nrrd
 +
**./originals/case2.nrrd
 +
**./originals/case3.nrrd
 +
**./segmentations/case1.nrrd
 +
**./segmentations/case2.nrrd
 +
**./segmentations/case3.nrrd
  
* Example 1
+
 
* Example 2
+
 
 +
'''HowTo: Simple Atlas Creation'''
 +
 
 +
The following steps perform a Pair Fixed Registration against an automatic chosen template for automatically detected structures.
 +
 
 +
1. Select the directories containing the Original Images and the Segmentations in the Input/Output panel.
 +
 
 +
2. Select an Output Directory in the Input/Output panel. It makes sense to create a new directory to use for the Output.
 +
 
 +
3. Hit 'Start!'
 +
 
 +
4. After some wait (minutes or hours!, depending on the number of input cases), the generated atlases and the used template will be loaded into 3D Slicer.
  
 
===Tutorials===
 
===Tutorials===

Revision as of 19:47, 14 April 2011

Home < Modules:AtlasCreator

Return to Slicer 3.6 Documentation


AtlasCreator

Atlas Creator User Interface in simple mode
Example of generated Atlases
Comparison of the alignment of two cases before and after Atlas Creation

General Information

Module Type & Category

Type: Built-in Loadable Module

Category: Registration

Authors, Collaborators & Contact

  • Daniel Haehn, University of Pennsylvania
  • Kilian Pohl, University of Pennsylvania
  • Contact: Daniel Haehn (haehn@bwh.harvard.edu)

Module Description

The Atlas Creator module aligns images paired with segmentations to generate statistical atlases for several segmented structures.

Usage

This module supports different usage types:

  1. The simple graphical user interface
  2. The advanced graphical user interface
  3. The command line interface
  4. External invocation using the Atlas Creator MRML Node

Use Cases, Examples

Input Data Requirements

The Atlas Creator expects input data to be structured the following way:

  • In general each original image is accompanied by a manual segmentation.
  • The images and the segmentations have to be in two different folders but have matching filenames.
  • For Example:
    • ./originals/case1.nrrd
    • ./originals/case2.nrrd
    • ./originals/case3.nrrd
    • ./segmentations/case1.nrrd
    • ./segmentations/case2.nrrd
    • ./segmentations/case3.nrrd


HowTo: Simple Atlas Creation

The following steps perform a Pair Fixed Registration against an automatic chosen template for automatically detected structures.

1. Select the directories containing the Original Images and the Segmentations in the Input/Output panel.

2. Select an Output Directory in the Input/Output panel. It makes sense to create a new directory to use for the Output.

3. Hit 'Start!'

4. After some wait (minutes or hours!, depending on the number of input cases), the generated atlases and the used template will be loaded into 3D Slicer.

Tutorials

Links to tutorials explaining how to use this module:

  • Tutorial 1
    • Data Set 1

Quick Tour of Features and Use

A list panels in the interface, their features, what they mean, and how to use them. For instance:

  • Main Panel:
    • Input volume
    • Atlas List
    • Initial Erosion distance
    • Image Modality
    • Output in Original Image Space
    • Find Midsaggital Plane
  • Advanced panel:
    • Run Smooth Brain Mask
    • Resample Data to Isotropic Voxels
    • Initial Probability Threshold
    • Minimum Probability threshold
    • MMC Dilation Distance
    • MMC Erosion Distance
  • FANTASM panel:
    • Inhomogeneity Correction
    • Smoothing Parameter
    • Background Threshold (%)
  • MSP panel:
    • Output Plane?
    • Output Split-Halves?
    • Output Segmentation on Plane?
  • Optimized Automated Registration panel:
    • Main Subpanel
      • Degres of freedom
      • Cost Function
      • Registration Interpolation
      • Output Interpolation
      • Apply Rotation
      • Minimum Angle
      • Maximum Angle
      • Coarse Angle Increment
      • Fine Angle Increment
    • Advanced Subpanel
      • Multiple of Tolerance to Bracket the Minimum
      • Number of Iterations
      • Number of Minima From Level 8 to test at Level 4
      • Use the Max of the Min Resolutions of the Two Datasets when Resampling
      • Subsample Image for Speed
      • Skip Multilevel Search (Assume Images are Close to Alignment)
      • Multithreading for Registration
  • Output panel:
    • First output
    • Second output
  • Viewing panel:
Atlas Creator User Interface in advanced mode

Development

Notes from the Developer(s)

Dependencies

Tests

On the Dashboard, these tests verify that the module is working on various platforms:

Known bugs

Usability issues

Source code & documentation

Links to the module's source code:

Source code:

Doxygen documentation:

More Information

Acknowledgment

References