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

From Slicer Wiki
Jump to: navigation, search
Line 47: Line 47:
  
 
===Quick Tour of Features and Use===
 
===Quick Tour of Features and Use===
 
A list panels in the interface, their features, what they mean, and how to use them. For instance:
 
  
 
{|
 
{|
 
|
 
|
* '''Input 1: Raw Images'''
+
* '''Input 1 - Raw Images:''' set input images representing the different modalities of the same subject
 
** T1-weighted image: set input T1 image
 
** T1-weighted image: set input T1 image
 
** T2-weighted image: set input T2 image, if available
 
** T2-weighted image: set input T2 image, if available
Line 58: Line 56:
 
** Tissue segmentation atlas directory: set directory containing gray-scale atlas to perform the tissue segmentation
 
** Tissue segmentation atlas directory: set directory containing gray-scale atlas to perform the tissue segmentation
 
** Segmentation atlas type (T1 or T2, default: T1): set atlas type
 
** Segmentation atlas type (T1 or T2, default: T1): set atlas type
* '''Input 2: Segmented Images'''
+
 
 +
 
 +
* '''Input 2: Segmented Images''' set tissue segmentation label image with its related raw image
 
** Tissue segmentation image: set tissue segmentation label image
 
** Tissue segmentation image: set tissue segmentation label image
 
** White matter label (default: 1): set tissue segmentation white matter label
 
** White matter label (default: 1): set tissue segmentation white matter label
Line 64: Line 64:
 
** CSF label (default: 3): set tissue segmentation CSF label
 
** CSF label (default: 3): set tissue segmentation CSF label
 
** Raw image: set its related raw image (needed to perform the lobar analysis, i.e to perform the atlas orientation)
 
** Raw image: set its related raw image (needed to perform the lobar analysis, i.e to perform the atlas orientation)
 +
 +
 
* '''Output:'''
 
* '''Output:'''
 
** Cortical thickness on white matter boundary: set output image which represents cortical thickness measurement on the white matter boundary
 
** Cortical thickness on white matter boundary: set output image which represents cortical thickness measurement on the white matter boundary
 
** Cortical thickness on gray matter boundary: set output image which represents cortical thickness measurement on the gray matter boundary
 
** Cortical thickness on gray matter boundary: set output image which represents cortical thickness measurement on the gray matter boundary
 
** Cortical thickness results directory: set output directory to save cortical thickness measurements
 
** Cortical thickness results directory: set output directory to save cortical thickness measurements
** ID number: set ID number to set prefix of output images
+
** ID number: set ID number to set prefix of the output images
* '''Parcellation:''': parameters need to be set to perform a lobar analysis
+
 
** Parcellation already defined for the subject
+
 
 +
* '''Parcellation:''' set parameters to perform a lobar analysis
 +
** If a parcellation is already defined for the subject:
 
*** Case parcellation image: set the parcellation image defined in the case space coordinate
 
*** Case parcellation image: set the parcellation image defined in the case space coordinate
** Parcellation needs to be defined: atlas is registered to the case
+
** If a parcellation needs to be defined (i.e atlas registration):
 
*** Atlas parcellation image: set the atlas parcellation image
 
*** Atlas parcellation image: set the atlas parcellation image
 
*** Atlas image: set the grayscale atlas image
 
*** Atlas image: set the grayscale atlas image
 
** Atlas parcellation orientation:  
 
** Atlas parcellation orientation:  
 +
 +
 
* '''Advanced tissue segmentation parameters'''
 
* '''Advanced tissue segmentation parameters'''
 +
** Filter options: specifies smoothing parameters prior to the segmentation
 +
** Priors: set prior weights for priors defined in the atlas directory. Prior weights can be adjusted globally (e.g., if one class overwhelms the other it can be set a lower weight) through comma separated numbers.
 +
** Maximum bias degree: set bias correction polynomial degree to adjust the severity of the bias field in the image. Bias field correction can be disabled by setting it to zero.
 +
** Atlas warping parameters: enable/disable B-spline warping and set grid size per direction (number of control points).
 +
 
* '''Advanced skull-stripping parameters'''
 
* '''Advanced skull-stripping parameters'''
* '''Advanced registration parameters:'''
+
** Mask dilation (default: disabled): check button to slightly dilate the mask. Useful if the tissue segmentation doesn't perfectly mask the brain.
 +
 
 +
 
 +
* '''Advanced cortical thickness parameters:'''
 +
 
 +
 
 +
* '''Advanced atlas registration parameters:'''
 +
 
 
|[[Image:screenshotBlankNotOptional.png|thumb|280px|User Interface]]
 
|[[Image:screenshotBlankNotOptional.png|thumb|280px|User Interface]]
 
|}
 
|}

Revision as of 14:50, 1 April 2010

Home < Modules:ARCTIC-Documentation-3.6

Return to Slicer 3.6 Documentation

Gallery of New Features


ARCTIC: Automatic Regional Cortical ThICkness

ARCTIC logo
T1 skull-stripped image
Parcellation image
Cortical thickness on WM surface
Cortical thickness information

General Information

Module Type & Category

Type: CLI

Category: Pipeline

Authors, Collaborators & Contact

  • Author1: Cedric Mathieu, UNC-Chapel Hill
  • Contributor1: Clement Vachet, UNC-Chapel Hill
  • Contributor2: Martin Styner, UNC-Chapel Hill
  • Contributor3: Heather Cody Hazlett, UNC-Chapel Hill
  • Contact: Clement Vachet, cvachet[at]email[dot]unc[dot]edu

Module Description

ARCTIC (Automatic Regional Cortical ThICkness) is an end-to-end application developped at UNC-Chapel Hill allowing individual analysis of cortical thickness. This cross-platform tool can be run within Slicer3 as an external module, or directly as a command line.

Usage

Use Cases, Examples

This module is especially appropriate when one wants to perform individual regional cortical thickness analysis. ARCTIC allows efficient QC via precomputed 3D-Slicer scenes.

Tutorials

Quick Tour of Features and Use

  • Input 1 - Raw Images: set input images representing the different modalities of the same subject
    • T1-weighted image: set input T1 image
    • T2-weighted image: set input T2 image, if available
    • PD-weighted image: set input PD image, if available
    • Tissue segmentation atlas directory: set directory containing gray-scale atlas to perform the tissue segmentation
    • Segmentation atlas type (T1 or T2, default: T1): set atlas type


  • Input 2: Segmented Images set tissue segmentation label image with its related raw image
    • Tissue segmentation image: set tissue segmentation label image
    • White matter label (default: 1): set tissue segmentation white matter label
    • Gray matter label (default: 2): set tissue segmentation gray matter label
    • CSF label (default: 3): set tissue segmentation CSF label
    • Raw image: set its related raw image (needed to perform the lobar analysis, i.e to perform the atlas orientation)


  • Output:
    • Cortical thickness on white matter boundary: set output image which represents cortical thickness measurement on the white matter boundary
    • Cortical thickness on gray matter boundary: set output image which represents cortical thickness measurement on the gray matter boundary
    • Cortical thickness results directory: set output directory to save cortical thickness measurements
    • ID number: set ID number to set prefix of the output images


  • Parcellation: set parameters to perform a lobar analysis
    • If a parcellation is already defined for the subject:
      • Case parcellation image: set the parcellation image defined in the case space coordinate
    • If a parcellation needs to be defined (i.e atlas registration):
      • Atlas parcellation image: set the atlas parcellation image
      • Atlas image: set the grayscale atlas image
    • Atlas parcellation orientation:


  • Advanced tissue segmentation parameters
    • Filter options: specifies smoothing parameters prior to the segmentation
    • Priors: set prior weights for priors defined in the atlas directory. Prior weights can be adjusted globally (e.g., if one class overwhelms the other it can be set a lower weight) through comma separated numbers.
    • Maximum bias degree: set bias correction polynomial degree to adjust the severity of the bias field in the image. Bias field correction can be disabled by setting it to zero.
    • Atlas warping parameters: enable/disable B-spline warping and set grid size per direction (number of control points).
  • Advanced skull-stripping parameters
    • Mask dilation (default: disabled): check button to slightly dilate the mask. Useful if the tissue segmentation doesn't perfectly mask the brain.


  • Advanced cortical thickness parameters:


  • Advanced atlas registration parameters:
User Interface

Development

Notes from the Developer(s)

Algorithms used, library classes depended upon, use cases, etc.

Dependencies

Tests

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

Known bugs

Links to known bugs in the Slicer3 bug tracker

Usability issues

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

Source code & documentation

Download release source code via svn:

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. Information on the National Centers for Biomedical Computing can be obtained from http://nihroadmap.nih.gov/bioinformatics

References

Publications related to this module go here. Links to pdfs would be useful.