Difference between revisions of "Documentation/3.6"

From Slicer Wiki
Jump to: navigation, search
m (Text replacement - "slicerWiki/index.php" to "wiki")
 
(36 intermediate revisions by 14 users not shown)
Line 1: Line 1:
 +
<noinclude>{{documentation/versioncheck}}</noinclude>
 
[[image:Slicer3-6Announcement-v2.png| right |3.6 Icon]]
 
[[image:Slicer3-6Announcement-v2.png| right |3.6 Icon]]
 +
 +
{{documentation/versionlist}}
 +
 
=Introduction=
 
=Introduction=
  
Line 13: Line 17:
 
*For information on how to obtain Slicer 3.6 please go to the [http://www.slicer.org/pages/Special:SlicerDownloads Download Pages].
 
*For information on how to obtain Slicer 3.6 please go to the [http://www.slicer.org/pages/Special:SlicerDownloads Download Pages].
 
*For sample data see [[SampleData|here]]
 
*For sample data see [[SampleData|here]]
 +
*For documentation on other versions of Slicer see [[Documentation|here]]
 +
*For a [[Slicer-3-6-FAQ|FAQ]] see here
 +
*[[Slicer3:Build_Instructions|Slicer version 3 build instructions]] for developers
 +
*<big>For an overview on how to load your data, see [[Slicer-3.6-Load-Overview|here]]</big>
  
 
=Main GUI=
 
=Main GUI=
Line 30: Line 38:
 
*[[Modules:Data-Documentation-3.6| Data Module]] (Alex Yarmarkovich)  
 
*[[Modules:Data-Documentation-3.6| Data Module]] (Alex Yarmarkovich)  
 
*[[Modules:Volumes-Documentation-3.6| Volumes Module]] (Alex Yarmarkovich, Steve Pieper)  
 
*[[Modules:Volumes-Documentation-3.6| Volumes Module]] (Alex Yarmarkovich, Steve Pieper)  
**[[Modules:Volumes:Diffusion Editor-Documentation-3.6| Diffusion Editor]] (CF Westin)
+
**[[Modules:Volumes:Diffusion Editor-Documentation-3.6| Diffusion Editor]] (Kerstin Kessel)
 
*[[Modules:Slices-Documentation-3.6|Slices Module]] (Jim Miller)  
 
*[[Modules:Slices-Documentation-3.6|Slices Module]] (Jim Miller)  
 
*[[Modules:VolumeRendering-Documentation-3.6| Volume Rendering Module]] (Yanling Liu, Alex Yarmarkovich)
 
*[[Modules:VolumeRendering-Documentation-3.6| Volume Rendering Module]] (Yanling Liu, Alex Yarmarkovich)
Line 51: Line 59:
 
==Registration==
 
==Registration==
 
*[[Slicer3:Registration|'''Overview of all Registration Modules''' ]]: This page provides guidance for selecting the module that is optimal for your task.
 
*[[Slicer3:Registration|'''Overview of all Registration Modules''' ]]: This page provides guidance for selecting the module that is optimal for your task.
 +
*[http://www.slicer.org/wiki/Slicer-3-6-FAQ '''Registration FAQ''']
 
*Fast Registration
 
*Fast Registration
 
**[[Modules:Transforms-Documentation-3.6|Transforms]]:  manual & interactive rigid registration , (Alex Yarmarkovich)
 
**[[Modules:Transforms-Documentation-3.6|Transforms]]:  manual & interactive rigid registration , (Alex Yarmarkovich)
Line 63: Line 72:
 
** [[Modules:BRAINSResample|BRAINSResample]] Hans Johnson (hans-johnson@uiowa.edu).
 
** [[Modules:BRAINSResample|BRAINSResample]] Hans Johnson (hans-johnson@uiowa.edu).
 
*Brain Only Registration
 
*Brain Only Registration
**[[Modules:ACPCTransform-Documentation-3.6|ACPC Transform]]: calculate a transformation to align a single brain along theh AC-PC line (Nicole Aucoin)
+
**[[Modules:ACPCTransform-Documentation-3.6|ACPC Transform]]: calculate a transformation to align a single brain along the AC-PC line (Nicole Aucoin)
 
*Non-Raster-Image Data Registration
 
*Non-Raster-Image Data Registration
 
**[[Modules:TransformFromFiducials-Documentation-3.6|Fiducial Registration]]: align two sets of fiducials (translation, rigid or similarity)  (Casey Goodlett)
 
**[[Modules:TransformFromFiducials-Documentation-3.6|Fiducial Registration]]: align two sets of fiducials (translation, rigid or similarity)  (Casey Goodlett)
 
**[[Modules:PythonSurfaceICPRegistration-Documentation-3.6|Surface Registration]]: automated surface-to-surface (model) registration (Luca Antiga, Daniel Blezek)
 
**[[Modules:PythonSurfaceICPRegistration-Documentation-3.6|Surface Registration]]: automated surface-to-surface (model) registration (Luca Antiga, Daniel Blezek)
 +
* [[Modules:AtlasCreator|Atlas Creator]]: create a statistical atlas (Daniel Haehn, Kilian Pohl)
  
 
==Segmentation==
 
==Segmentation==
 
*[[Modules:SegmentationOverview3.6|Overview]]
 
*[[Modules:SegmentationOverview3.6|Overview]]
**[[Modules:EMSegmentTemplateBuilder3.6|EM Segment Template Builder 3.6]] (Kilian Pohl) 
+
**[[Modules:EMSegmenter-3.6|EM Segmenter]] (Kilian Pohl)   
**[[Modules:EMSegment-Command-Line3.6|EM Segment Command-Line]] (Kilian Pohl)   
+
**[[Modules:FastMarchingSegmentation-Documentation-3.6|Fast Marching Segmentation]] (Andriy Fedorov)
**[[Modules:EMSegment-Simple3.6|EM Segment Simple]] (Kilian Pohl)
 
**[[Modules:FastMarchingSegmentation-Documentation-3.6|Fast Marching segmentation]] (Andriy Fedorov)
 
 
**[[Modules:OtsuThresholdSegmentation-Documentation-3.6|Otsu Threshold Segmentation]] (Bill Lorensen)
 
**[[Modules:OtsuThresholdSegmentation-Documentation-3.6|Otsu Threshold Segmentation]] (Bill Lorensen)
 
**[[Modules:Simple Region Growing-Documentation-3.6|Simple Region Growing]] (Jim Miller, Harini Veeraraghavan)   
 
**[[Modules:Simple Region Growing-Documentation-3.6|Simple Region Growing]] (Jim Miller, Harini Veeraraghavan)   
**[[Modules:RobustStatisticsSeg-Documentation-3.6|RobustStatisticsSeg]] Yi Gao (yigao@gatech.edu).
+
**[[Modules:RobustStatisticsSeg-Documentation-3.6|Robust Statistics Segmentation]] Yi Gao (yigao@gatech.edu).
 
**[[Modules:BRAINSROIAuto-Documentation-3.6|BRAINSROIAuto]] Hans Johnson (hans-johnson@uiowa.edu).
 
**[[Modules:BRAINSROIAuto-Documentation-3.6|BRAINSROIAuto]] Hans Johnson (hans-johnson@uiowa.edu).
 +
**[[Modules:GrowCutSegmentation-Documentation-3.6|Grow Cut Segmentation]] (Harini Veeraraghavan)
  
 
==Quantification==
 
==Quantification==
Line 99: Line 108:
 
**[[Modules:StochasticTractography-Documentation-3.6|Python Stochastic Tractography]] (Ryan Eckbo)   
 
**[[Modules:StochasticTractography-Documentation-3.6|Python Stochastic Tractography]] (Ryan Eckbo)   
 
**[[Modules:ROISelect-Documentation-3.6|ROI Select]] (Lauren O'Donnell)
 
**[[Modules:ROISelect-Documentation-3.6|ROI Select]] (Lauren O'Donnell)
 +
* Pipeline
 +
**[[GTRACT_V4 | GTRACT CLI tools]] (Vincent Magnotta)
  
 
==IGT==
 
==IGT==
Line 111: Line 122:
  
 
==Filtering==
 
==Filtering==
*[[Modules:N4ITKBiasFieldCorrection-Documentation-3.6|N4 Bias Field Correction]] (Andriy Fedorov), based on most recent version of ITK
+
*[[Modules:N4ITKBiasFieldCorrection-Documentation-3.6|N4 Bias Field Correction]] (Andriy Fedorov)
 
*[[Modules:MRIBiasFieldCorrection-Documentation-3.6|MRI Bias Field Correction]] (Sylvain Jaume)
 
*[[Modules:MRIBiasFieldCorrection-Documentation-3.6|MRI Bias Field Correction]] (Sylvain Jaume)
 
*[[Modules:CheckerboardFilter-Documentation-3.6|Checkerboard Filter]] (Bill Lorensen, Jim Miller)
 
*[[Modules:CheckerboardFilter-Documentation-3.6|Checkerboard Filter]] (Bill Lorensen, Jim Miller)
Line 169: Line 180:
 
* For a subset of extensions, you can use the extension wizard in Slicer to find their webpages and to install/uninstall individual extensions.  
 
* For a subset of extensions, you can use the extension wizard in Slicer to find their webpages and to install/uninstall individual extensions.  
 
* The version that is available through the extension manager is chosen by the developer of that extension
 
* The version that is available through the extension manager is chosen by the developer of that extension
* Not all extensions are available on all platforms. See here for the [[Documentation-3.6:ExtensionStatus|Extension Status]]
+
* Not all extensions are available on all platforms. See here for the [[Documentation-3.6:ExtensionStatus|extension status]].
* In case of problems with those modules, please talk directly to the developers of the extensions.
+
* In case of problems with extensions, please talk directly to the developers of the extensions.
 +
* Information for developers can be found [[Slicer3:Extensions|here]].
 +
 
  
 
'''Available Extensions'''
 
'''Available Extensions'''
  
 
* Import/Export
 
* Import/Export
** [[Image:MissingOrStaleDoc.png]][[Modules:PlastimatchDICOMRT|Plastimatch > DICOM RT Import]] Greg Sharp (gcsharp@partners.org).
+
** [[Modules:PlastimatchDICOMRT|Plastimatch > DICOM-RT Import]] Greg Sharp (gcsharp@partners.org).
 
* Segmentation
 
* Segmentation
 
** [[Modules:ABC-Documentation-3.5|ABC]] Marcel Prastawa (prastawa@sci.utah.edu) (a.k.a. Atlas Based Classification) '''Not yet 3.6'''.  
 
** [[Modules:ABC-Documentation-3.5|ABC]] Marcel Prastawa (prastawa@sci.utah.edu) (a.k.a. Atlas Based Classification) '''Not yet 3.6'''.  
Line 181: Line 194:
 
** [[Modules:SpineSegmentation-Documentation-3.6|SpineSegmentation]] Sylvain Jaume (sylvain@csail.mit.edu).  
 
** [[Modules:SpineSegmentation-Documentation-3.6|SpineSegmentation]] Sylvain Jaume (sylvain@csail.mit.edu).  
 
** [[Modules:SkullStripperModule|SkullStripperModule]] '''(in progress)''' Xiaodong Tao (taox AT research.ge.com).  
 
** [[Modules:SkullStripperModule|SkullStripperModule]] '''(in progress)''' Xiaodong Tao (taox AT research.ge.com).  
 +
** [[Modules:SPECTRE-Documentation-3.6|SPECTRE]] '''(in progress)''' Nicole Aucoin (nicole@bwh.harvard.edu), Min Chen (mchen55@jhu.edu)
 
* Registration
 
* Registration
 
**Robust
 
**Robust
 
*** [[Modules:CMTK|CMTK]] Torsten Rohlfing (torsten@synapse.sri.com) (a.k.a. Computational Morphometry Toolkit)   
 
*** [[Modules:CMTK|CMTK]] Torsten Rohlfing (torsten@synapse.sri.com) (a.k.a. Computational Morphometry Toolkit)   
 
*** [[Modules:HammerRegistration|HammerRegistration]] GuorongWu, XiaodongTao, JimMiller, DinggangShen (dgshen@med.unc.edu).  
 
*** [[Modules:HammerRegistration|HammerRegistration]] GuorongWu, XiaodongTao, JimMiller, DinggangShen (dgshen@med.unc.edu).  
*** [[Modules:Plastimatch|Plastimatch > B-spline deformable registration]] Greg Sharp (gcsharp@partners.org).
+
** [[Modules:Plastimatch|Plastimatch > B-spline deformable registration]] Greg Sharp (gcsharp@partners.org).
 +
** [[Modules:PlastimatchLANDWARP|Plastimatch > Landmark-based registration]] Nadya Shusharina (nshusharina@partners.org).
 +
** [[Modules:PlastimatchXFORMWARP|Plastimatch > Warping with transform]] Nadya Shusharina, Greg Sharp (gcsharp@partners.org)
 
* Wizards
 
* Wizards
 
** [[Modules:ARCTIC-Documentation-3.6|ARCTIC]] Cedric Mathieu and Clement Vachet (cvachet@email.unc.edu) (a.k.a Automatic Regional Cortical ThICkness) .  
 
** [[Modules:ARCTIC-Documentation-3.6|ARCTIC]] Cedric Mathieu and Clement Vachet (cvachet@email.unc.edu) (a.k.a Automatic Regional Cortical ThICkness) .  
** [[Modules:LesionSegmentationApplications-Documentation-3.6|LesionSegmentationApplications]] Mark Scully (mscully@mrn.org) (a.k.a. 3DSlicerLupusLesionModule) .
+
** [[Modules:LesionSegmentationApplications-Documentation-3.6|LesionSegmentationApplications]] Mark Scully (mark-scully[at]uiowa[dot]edu) (a.k.a. 3DSlicerLupusLesionModule) .
 
* Tractography
 
* Tractography
 
** [[Modules:EMDTIClustering-Documentation-3.6|EMFiberClusteringModule]] Mahnaz Maddah (mmaddah@alum.mit.edu) (a.k.a. Quantitative Diffusion Tools).
 
** [[Modules:EMDTIClustering-Documentation-3.6|EMFiberClusteringModule]] Mahnaz Maddah (mmaddah@alum.mit.edu) (a.k.a. Quantitative Diffusion Tools).
Line 233: Line 249:
 
*[[Modules:Cameras-Documentation-3.6| Camera Module]] (Sebastian Barre)
 
*[[Modules:Cameras-Documentation-3.6| Camera Module]] (Sebastian Barre)
 
*Note: most developer tools are not documented for end users, but contain comments in the source code
 
*Note: most developer tools are not documented for end users, but contain comments in the source code
 
*[[Modules:EMSegmentBatch-Documentation-3.6|EM Segmenter batch]] (Julien Jomier, Brad Davis)
 
 
*[[Modules:GaussianBlurBatch-Documentation-3.6|Gaussian Blur batch]] (Julien Jomier, Stephen Aylward)
 
*[[Modules:GaussianBlurBatch-Documentation-3.6|Gaussian Blur batch]] (Julien Jomier, Stephen Aylward)
 
*[[Modules:RegisterImagesBatch-Documentation-3.6|Register Images batch]] (Julien Finet, Stephen Aylward)
 
*[[Modules:RegisterImagesBatch-Documentation-3.6|Register Images batch]] (Julien Finet, Stephen Aylward)
Line 247: Line 261:
  
 
[[Slicer-3.6-QA|Slicer 3.6 QA table]]
 
[[Slicer-3.6-QA|Slicer 3.6 QA table]]
 
'''Modules'''
 
*Please copy the template linked below, paste it into your page and customize it with your module's information.
 
[[Slicer3:Module_Documentation-3.6_Template|Slicer3:Module_Documentation-3.6_Template]]
 
*See Requirements for Modules for info to be put into the Help and Acknowledgment Tabs
 
*To put your lab's logo into a module, see [[Slicer3:Execution_Model_Documentation#Adding_Module_Logos_to_Slicer3|here]]
 
 
Please adhere to the naming scheme for the module documentation:
 
*[ [Modules:MyModuleNameNoSpaces-Documentation-3.6|My Module Name With Spaces] ] (First Last Name)
 
 
'''Requirements for Modules'''
 
{| border="00" cellpadding="5" cellspacing="0"
 
|-
 
| rowspan="2"|
 
* The module is '''feature complete''', it does everything that it advertises it can do
 
* The module has a '''test'''. See [http://wiki.na-mic.org/Wiki/index.php/Slicer3:Execution_Model_Testing '''here'''] for more information.
 
* Module has '''documentation''' on the [[Documentation-3.5#Modules|Slicer wiki]]. Please use the template provided [[Documentation-3.6#Modules|'''here''']] to structure your page. Please keep in mind that our users are not computer scientists with a background in computer vision.
 
*Please add a pointer to the documentation on the Slicer wiki to the the '''Help''' tab of the module. See the '''Editor module''' in Slicer for an example.
 
* The contributor (and their manager/advisor), the lab (with labs/institution logo) and the funding source (with grant number, logo optional) are listed in the '''Acknowledegment''' tab of the module. Please see the '''Models module''' for an example. The people listed in the acknowledgement will be the primary people for support and maintenance relative of the module. [[Slicer3:Execution_Model_Documentation#Adding_Module_Logos_to_Slicer3|See here for more information.]]
 
** '''Style Guide:''' All acknowledgment icons should be 100x100 pixels, preferably in png format.
 
** '''Accessing logos:''' Icons for BIRN, NAC, NA-MIC and IGT are included in Slicer3/Base/GUI//vtkSlicerBaseAcknowledgementLogoIcons.cxx/h and resources for them are in Slicer3/Base/GUI/Resources/vtkSlicerBaseAcknowledgementLogos_ImageData.h. The API for vtkSlicerModuleGUI provides access to these icons.
 
** '''Adding logos:''' Please add additional image resources and logo icons to these files as required in order to promote shared use (and to prevent duplication in the code.)
 
* Many modules are better suited to be [[Documentation-3.4#Extensions_for_Downloading|downloadable extensions]].  The same module creation guidelines apply, but the actual implementation is done outside of the slicer source code repository.
 
* Follow [[Documentation-3.5-Rons-Rules|'''Ron's rules for tools''']]
 
| style="background: #e5e5e5" align="center"| Examples for the Help and
 
Acknowledgment Panels
 
|-
 
| style="background: #ebeced"|[[Image:SlicerHelpExample.png|center|200px]][[Image:SlicerAcknowledgementExample.png|center|200px]]
 
|}
 
 
Please adhere to the naming scheme for the module documentation:
 
*[[Modules:MyModuleNameNoSpaces-Documentation-3.6|My Module Name With Spaces] ] (First Last Name)
 
 
=Documentation Draft notes=
 
Key for flagged modules below:
 
 
[[Image:MissingOrStaleDoc.png]]: No 3.6 Documentation
 
 
[[Image:MissingOrStaleDocLink.png]]: Missing or stale link to 3.6 Documentation from Help Panel in software module. If you're not sure how/where to add the link and module description:
 
* for command line modules, see other xml files (such as that for the GradientAnisotropicDiffusion Module) for an example of how to add documentation and links to wiki help.
 
* for interactive modules, see other modules in Base/GUI for an example.
 
 
[[Image:WeakDoc.png]]: Weak or Incomplete 3.6 Documentation
 

Latest revision as of 17:05, 21 November 2019

Home < Documentation < 3.6


For the latest Slicer documentation, visit the read-the-docs.


3.6 Icon

Nightly 4.10 4.8 4.6 4.5 4.4 4.3 4.2 4.1 4.0 3.6 3.5 3.4 3.2 ALL VERSIONS

Introduction

3D Slicer is a flexible platform that can be easily extended to enable development of both interactive and batch processing tools for a variety of applications.

3D Slicer provides image registration, processing of DTI (diffusion tractography), an interface to external devices for image guidance support, and GPU-enabled volume rendering, among other capabilities. 3D Slicer has a modular organization that allows the easy addition of new functionality and provides a number of generic features not available in competing tools. Finally, 3D Slicer is distributed under a non-restrictive BSD license.

The interactive visualization capabilities of 3D Slicer include the ability to display arbitrarily oriented image slices, build surface models from image labels, and high performance volume rendering. 3D Slicer also supports a rich set of annotation features (fiducials and measurement widgets, customized colormaps). To the best of our knowledge, no individual segmentation tool provides such powerful visualization capabilities for the user as 3D Slicer. (These paragraphs were provided by A. Fedorov and C. Lisle)

The 3.6 release of 3D Slicer contains significant changes both to the organization of the software and to the functionality. Please check the 3.6 Announcement page for a list of those changes. The community contributing to Slicer 3.6 is acknowledged here.

Main GUI

Modules

Core

Wizards

Informatics Modules

Registration

Segmentation

Quantification

Diffusion MRI

IGT

Time Series

Filtering

Surface Models

Converters

Endoscopy

Slicer Extensions

Introduction

  • Slicer Extensions are the "on-ramp" to the Slicer "highway". They provide are a mechanism for anybody, including third parties, to provide modules which extend the functionality of 3d Slicer.
  • While the Slicer license is suggested, it is not required for extensions. Please review the documentation of the extension carefully.
  • For a subset of extensions, you can use the extension wizard in Slicer to find their webpages and to install/uninstall individual extensions.
  • The version that is available through the extension manager is chosen by the developer of that extension
  • Not all extensions are available on all platforms. See here for the extension status.
  • In case of problems with extensions, please talk directly to the developers of the extensions.
  • Information for developers can be found here.


Available Extensions

  • VMTKLevelSetSegmentation providing level-set segmentation of vessels, aneurysms and tubular structures using different algorithms for initialization and evolution

Installation Instructions

  • Click on the cogwheel icon to start the extensions wizard (highlighted in red)

Extensions Wizard


Extension manager dialog box

To add extension modules to an installed binary of slicer:

  • Use the View->Extension Manager menu option
  • The dialog will be initialized with the URL to the extensions that have been compiled to match your binary of slicer.
    • Note installing extensions from a different repository URL is likely to be unstable due to platform and software version differences.
    • You can select a local install directory for your downloaded extensions (be sure to choose a directory with enough free space).
  • Select the extensions you wish to install and click to download them. Installed extensions will be available when you restart slicer.
  • To turn modules on or off, you can use the Module Settings page of the View->Application Settings dialog.


Info for Developers

For explanations for developers see  here

Other information

Developer Tools


Non-SPL Supported Compatibility Packages


QA Table

Slicer 3.6 QA table