Difference between revisions of "Documentation/3.6"
(→QA) |
|||
Line 1: | Line 1: | ||
− | + | =Introduction= | |
− | + | Slicer 3 has undergone significant changes during the last 5 years. The 3.6 release contains significant changes both to the organization of the software and the functionality. Please see below for a list of some of the functionality that was added since 3.4. | |
− | + | *For information on how to use Slicer 3.6 please go to the tutorial pages. | |
− | + | *For information on how to obtain Slicer 3.6 please go to the Download pages. | |
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | * | ||
− | |||
− | |||
− | * | ||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
=List of Modules added or significantly revised since the 3.4 release= | =List of Modules added or significantly revised since the 3.4 release= | ||
Line 72: | Line 25: | ||
* Model Transform (Alex Yarmarkovich) | * Model Transform (Alex Yarmarkovich) | ||
− | = | + | =Main GUI= |
+ | |||
+ | *[[Image:WeakDoc.png]][[Modules:MainApplicationGUI-Documentation-3.6| Main Application GUI]] (Wendy Plesniak) | ||
+ | *[[Modules:EventBindings-3.6| "Hot-keys" and Keyboard Shortcuts]] (Wendy Plesniak) | ||
+ | *[[Modules:Loading-Data-3.6| Loading Data]] (scenes, DICOM, volumes, models, fiducials, transforms, etc.) (Wendy Plesniak) | ||
+ | *[[Modules:Saving-Documentation-3.6| Saving Data]] (scenes, volumes, models, fiducials, transforms, etc.) (Wendy Plesniak) | ||
+ | *[[Modules:SceneSnapshots-3.6| Creating and Restoring Scene Snapshots]] (Wendy Plesniak) | ||
+ | *[[Image:WeakDoc.png]][[Modules:ExtensionsManagementWizard-Documentation-3.6| Extensions Management Wizard]] '''in progress''' (Wendy Plesniak) | ||
− | |||
− | |||
==Core== | ==Core== | ||
Line 301: | Line 259: | ||
− | + | =Other information= | |
'''Non-SPL Supported Compatibility Packages''' | '''Non-SPL Supported Compatibility Packages''' | ||
* [[Modules:BioImageSuite|BioImageSuite]] Xenios Papademtrios '''Not yet 3.6''' | * [[Modules:BioImageSuite|BioImageSuite]] Xenios Papademtrios '''Not yet 3.6''' | ||
+ | |||
+ | '''QA''' | ||
+ | |||
+ | 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 | ||
+ | |||
+ | [[Image:WeakDoc.png]]: Weak or Incomplete 3.6 Documentation | ||
+ | |||
+ | |||
+ | [[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) |
Revision as of 19:33, 30 April 2010
Home < Documentation < 3.6Contents
Introduction
Slicer 3 has undergone significant changes during the last 5 years. The 3.6 release contains significant changes both to the organization of the software and the functionality. Please see below for a list of some of the functionality that was added since 3.4.
- For information on how to use Slicer 3.6 please go to the tutorial pages.
- For information on how to obtain Slicer 3.6 please go to the Download pages.
List of Modules added or significantly revised since the 3.4 release
- Interactive Editor
- Volume Rendering
- Colors (Nicole Aucoin)
- MRI Bias Field Correction (Sylvain Jaume)
- 4D Image (Viewer) (Junichi Tokuda)
- 4D Analysis (Time-intensity curve plotting and analysis) (Junichi Tokuda)
- Fast Marching segmentation (Andriy Fedorov)
- Mesh Contour Segmentation (Peter Karasev)
- Crop Volume (Subvolume extraction with ROI widget) (Andriy Fedorov)
- Measurements (rulers and angles) (Nicole Aucoin)
- Affine registration (Casey Goodlett)
- Collect Patient Fiducials (Andrew Wiles)
- IGT Tool Selector (Andrew Wiles)
- Fiducials (Nicole Aucoin)
- PETCTFusion (Wendy Plesniak)
- N4 Bias Field Correction (Andriy Fedorov)
- Robust Statistical Segmentation (Yi Gao)
- Model Transform (Alex Yarmarkovich)
Main GUI
Main Application GUI (Wendy Plesniak)
- "Hot-keys" and Keyboard Shortcuts (Wendy Plesniak)
- Loading Data (scenes, DICOM, volumes, models, fiducials, transforms, etc.) (Wendy Plesniak)
- Saving Data (scenes, volumes, models, fiducials, transforms, etc.) (Wendy Plesniak)
- Creating and Restoring Scene Snapshots (Wendy Plesniak)
Extensions Management Wizard in progress (Wendy Plesniak)
Core
Welcome Module (Wendy Plesniak, Steve Pieper, Sonia Pujol, Ron Kikinis)
- Data Module (Alex Yarmarkovich)
- Volumes Module (Alex Yarmarkovich, Steve Pieper)
- Diffusion Editor (CF Westin)
- Slices Module (Jim Miller)
Volume Rendering Module (Yanling Liu, Alex Yarmarkovich)
Editor (Steve Pieper)
- Models Module (Alex Yarmarkovich)
- Fiducials Module (Nicole Aucoin)
- Measurements (rulers and angles) (Nicole Aucoin)
ROI Module (Alex Yarmarkovich)
Transforms Module (Alex Yarmarkovich)
- Color Module (Nicole Aucoin)
Wizards
- ChangeTracker (Andriy Fedorov)
- IA FE Meshing Module (Vincent Magnotta, Curt Lisle)
Informatics Modules
- Fetch Medical Informatics Module (Wendy Plesniak, Dan Marcus)
- Query Atlas Module (Wendy Plesniak)
Registration
- Overview of all Registration Modules : go here for more detailed help on selecting your registration module.
- Fast
Transforms: manual & interactive rigid registration , (Alex Yarmarkovich)
- Fast Affine Registration: automated fast affine registration , (Jim Miller)
- Fast Rigid Registration: automated fast rigid (6 DOF) registration , (Jim Miller)
- Fast Nonrigid BSpline Registration: fast non-rigid registration , (Bill Lorensen)
- Robust
- Expert Pipeline Rigid-Affine-Nonrigid Registration: automated registration with extensive parameter options, robust initialization, variable DOF and masking options, (Casey Goodlett)
- Robust Multiresolution Affine Registration: affine registration in multi-resolution scheme, robust to large differences in initial position or image content , (Casey Goodlett)
BRAINSDemonWarp Hans Johnson (hans-johnson@uiowa.edu). Belongs to registration, robust
BRAINSFit Hans Johnson (hans-johnson@uiowa.edu) . Belongs to registration robust
BRAINSResample Hans Johnson (hans-johnson@uiowa.edu) . Belongs to registration robust
- Brain Only
- ACPC Transform: calculate a transformation to align a single brain along theh AC-PC line (Nicole Aucoin)
- Non-Raster-Image Data
- Fiducial Registration: align two sets of fiducials (translation, rigid or similarity) (Casey Goodlett)
- Surface Registration: automated surface-to-surface (model) registration (Luca Antiga, Daniel Blezek)
Segmentation
- Overview
- EM Segment Template Builder 3.6 (Kilian Pohl)
- EM Segment Command-Line (Kilian Pohl)
- EM Segment Simple (Kilian Pohl)
- Fast Marching segmentation (Andriy Fedorov)
- Otsu Threshold Segmentation (Bill Lorensen)
Simple Region Growing (Jim Miller, Harini Veeraraghavan)
- RobustStatisticsSeg Yi Gao (yigao@gatech.edu).
BRAINSROIAuto Hans Johnson (hans-johnson@uiowa.edu).
Quantification
- Label Statistics (Steve Pieper)
PET/CT Fusion Module (Wendy Plesniak)
Diffusion MRI
- Diffusion MRI
- DWI filtering
Joint Rician LMMSE Image Filter (Antonio Tristán Vega, Santiago Aja-Fernandez)
Rician LMMSE Image Filter (Antonio Tristán Vega, Santiago Aja-Fernandez, Marc Niethammer)
Unbiased Non Local Means filter for DWI (Antonio Tristán Vega, Santiago Aja-Fernandez)
- Diffusion tensor utilities
Diffusion Tensor Estimation (Raul San Jose Estepar)
Diffusion Tensor Scalar Measurements (Raul San Jose Estepar)
- Resampling
- Resample DTI Volume (Francois Budin)
- Tractography
Label Seeding (Raul San Jose Estepar)
Fiducial Seeding (Alex Yarmakovich, Steve Pieper)
FiberBundles (Alex Yarmakovich)
- Python Stochastic Tractography (Julien de Siebenthal)
ROI Select (Lauren O'Donnell)
- DWI filtering
IGT
- OpenIGTLinkIF Module (Junichi Tokuda)
- NeuroNav Module (Haiying Liu)
- ProstateNav Module (Junichi Tokuda, Andras Lasso)
- Collect Patient Fiducials (Andrew Wiles)
- IGT Tool Selector (Andrew Wiles)
Time Series
- 4D Image (Viewer) (Junichi Tokuda)
Filtering
- N4 Bias Field Correction (Andriy Fedorov), based on most recent version of ITK
MRI Bias Field Correction (Sylvain Jaume)
- Checkerboard Filter (Bill Lorensen, Jim Miller)
- Histogram Matching (Bill Lorensen, Xiaodong Tao)
Image Label Combine (Alex Yarmarkovich)
- Resample Volume (Bill Lorensen)
- Resample Scalar/Vector/DWI Volume (Francois Budin)
- Threshold Image (Nicole Aucoin)
- Otsu Threshold (Bill Lorensen)
- Arithmetic
- Add Images (Harini Veeraraghavan)
- Subtract Images (Harini Veeraraghavan)
- Cast Image (Nicole Aucoin)
- Mask Image (Nicole Aucoin) Can be used to apply a mask such as a brain mask to a grey scale image
Multiply Images (Harini Veeraraghavan)
- Denoising
- Gradient Anisotropic Filter (Bill Lorensen)
- Curvature Anisotropic Diffusion (Bill Lorensen)
- Gaussian Blur (Julien Jomier, Stephen Aylward)
- Median Filter (Xiaodong Tao)
- Morphology
- Voting Binary Hole Filling (Jim Miller)
- Grayscale Fill Hole (Bill Lorensen)
- Grayscale Grind Peak (Bill Lorensen)
Surface Models
- ModelMaker (Nicole Aucoin)
- Grayscale Model Maker (Bill Lorensen)
Mesh Contour Segmentation (Peter Karasev)
Python Surface Connectivity (Luca Antiga, Daniel Blezek)
Python Surface ICP Registration (Luca Antiga, Daniel Blezek)
Python Surface Toolbox (Luca Antiga, Daniel Blezek)
Clip Model (Alex Yarmarkovich)
- Model into Label Volume (Nicole Aucoin)
- Merge Models (Nicole Aucoin)
Model Mirror (Wendy Plesniak) (in progress)
- PolyDataToLabelmap (Xiaodong Tao, Nicole Aucoin)
Batch processing
- EM Segmenter batch (Julien Jomier, Brad Davis)
- Gaussian Blur batch (Julien Jomier, Stephen Aylward)
- Register Images batch (Julien Finet, Stephen Aylward)
- Resample Volume batch (Julien Finet)
Converters
- Crop Volume (previously ExtractSubvolumeROI) (Andriy Fedorov)
- Create a Dicom Series (Xiaodong Tao)
- Dicom to NRRD (Xiaodong Tao)
- Orient Images (Xiaodong Tao)
Python Explode Volume Transform (Luca Antiga, Daniel Blezek)
Endoscopy
- Virtual Endoscopy (Steve Pieper)
Developer Tools
- Camera Module (Sebastian Barre)
- Note: most developer tools are not documented for end users, but contain comments in the source code
Slicer Extensions
Introduction
- Slicer Extensions are a mechanism for third parties to provide modules which extend the functionality of 3d Slicer.
- Some of the extensions do not use the Slicer license. Please review carefully.
- For a subset of extensions, you can use the extension wizard in Slicer to find their webpages and to install/uninstall individual extensions. In case of problems with those modules, please talk directly to the developers of the extensions.
- The version that is available through the extension manager is chosen by the developer of that extension
Available Extensions
- Segmentation
- ABC Marcel Prastawa (prastawa@sci.utah.edu) (a.k.a. Atlas Based Classification) Not yet 3.6.
- FuzzySegmentationModule Xiaodong Tao (taox at research.ge.com) .
- Registration
- Robust
BRAINSMush Hans Johnson (hans-johnson@uiowa.edu) .
CMTK Computational Morphometry Toolkit Torsten Rohlfing (torsten@synapse.sri.com).
- HammerRegistration GuorongWu, XiaodongTao, JimMiller, DinggangShen (dgshen@med.unc.edu).
- Plastimatch Greg Sharp (gcsharp@partners.org).
- Robust
- Wizards
- ARCTIC Cedric Mathieu and Clement Vachet (cvachet@email.unc.edu) (a.k.a Automatic Regional Cortical ThICkness) .
- LesionSegmentationApplications Mark Scully (mscully@mrn.org) (a.k.a. 3DSlicerLupusLesionModule) .
SkullStripperModule Xiaodong Tao (taox@research.ge.com).
SpineSegmentation Sylvain Jaume (sylvain@csail.mit.edu).
- Tractography
- EMFiberClusteringModule Mahnaz Maddah (maddah@ge.com) (a.k.a. Quantitative Diffusion Tools).
- DWI
RicianNoiseFilter Ross Whitaker (whitaker@cs.utah.edu) .
- Time Series
- 4D Analysis (Time-series plotting and analysis including kinetic analysis of DCE MRI) Junichi Tokuda (tokuda@bwh.harvard.edu)
- Statistics
- LabelDiameterEstimation Andriy Fedorov (fedorov@bwh.harvard.edu) .
- The Vascular Modeling Toolkit in 3D Slicer, Daniel Haehn (haehn@bwh.harvard.edu)
- VmtkSlicerModule prerequisite install for all VMTK plug-ins
- VMTKCenterlines providing centerline computation of surface models
- VMTKEasyLevelSetSegmentation providing level-set segmentation of vessels, aneurysms and tubular structures using an easy interface
- VMTKLevelSetSegmentation providing level-set segmentation of vessels, aneurysms and tubular structures using different algorithms for initialization and evolution
- VMTKVesselEnhancement providing vessel enhancement filters to highlight vascular or tubular structures
Installation Instructions
- Click on the cogwheel icon to start the extensions wizard (highlighted in red)
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
- We are using NITRC as the primary repository for contributed extensions. As a general rule, we do not test the extensions ourselves. Use them at your own risk.
- Click here to see a listing of Slicer 3 extensions on NITRC.
- Extensions are compiled as part of the nightly build. In order to have your extension compiled nightly and made available to end users, please contact the Slicer team. For explanations for developers see here
ExampleCommandLine Jim Miller
ExampleLoadableGuiLessModule Steve Pieper
ExampleLoadableModule Steve Pieper
PythonSampleScriptedModule Steve Pieper
TclSampleScriptedModule Steve Pieper
Other information
Non-SPL Supported Compatibility Packages
- BioImageSuite Xenios Papademtrios Not yet 3.6
QA
Key for flagged modules below:
: Missing or stale link to 3.6 Documentation from Help Panel in software module
: Weak or Incomplete 3.6 Documentation
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
- 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 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
|
Examples for the Help and
Acknowledgment Panels |
Please adhere to the naming scheme for the module documentation:
- [[Modules:MyModuleNameNoSpaces-Documentation-3.6|My Module Name With Spaces] ] (First Last Name)