Difference between revisions of "Documentation/3.4"

From Slicer Wiki
Jump to: navigation, search
m
 
(69 intermediate revisions by 17 users not shown)
Line 1: Line 1:
Note: This page is currently under construction
+
<noinclude>{{documentation/versioncheck}}</noinclude>
 +
{{documentation/versionlist}}
  
 
=Introduction=
 
=Introduction=
Line 7: Line 8:
  
 
=How-To Tutorials=
 
=How-To Tutorials=
[http://wiki.na-mic.org/Wiki/index.php/Slicer3:Training Slicer3 tutorial page]
+
*[[Slicer3.4:Training|Slicer 3.4 tutorial]]
 +
*[http://wiki.na-mic.org/Wiki/index.php/Slicer3:Training Slicer3.2 tutorial page]
  
 
=Feature Request and Problem Reports=
 
=Feature Request and Problem Reports=
 
We have an [http://www.na-mic.org/Bug/my_view_page.php issues tracker] for Slicer 3. You need to create an account for filing reports. We keep track of both feature requests and bug reports. Make sure to use the pull-down in the upper right to select Slicer 3.
 
We have an [http://www.na-mic.org/Bug/my_view_page.php issues tracker] for Slicer 3. You need to create an account for filing reports. We keep track of both feature requests and bug reports. Make sure to use the pull-down in the upper right to select Slicer 3.
 +
=System Requirements=
 +
* ''Hardware:'' The hardware requirements are driven by the kind of analysis you wish to perform.  For large data sets we suggest the 64 bit linux build on a machine with several gig of memory (e.g. a 1000 slice CT is half a gig of memory just to load plus there are temporary copies in memory during any processing steps).  Note that Windows often does not make the full system memory available to applications. 
 +
* ''Disk Space:'' In addition to the installation directory (about 200 meg depending on platform), operations like installing downloaded extensions, caching internet data downloads, and running external programs will require additional memory; the exact amount depends on the operations you perform.  To be safe, an extra gig or more of free disk space is a good idea for "typical" uses such as neuro MR analysis.
 +
* ''Directory Settings:'' There are several user-selectable directory paths.  Please confirm that these paths point to locations with sufficient storage space for your intended use. 
 +
** ''View->Application Settings->Module Settings->Temporary Directory'' is used as scratch space when running modules.  By default this points to a new temp directory in your home directory.
 +
** ''View->Application Settings->Module Settings->Extensions Install Path'' is where newly downloaded extension modules will be saved.
 +
** ''View->Application Settings->Remote Data Handling Settings->Cache Directory'' is where downloaded data is stored for possible re-use.  This defaults to the same as the Temporary Directory.
  
=List of Modules in need of documentation=
+
=List of Modules=
== Requirements for modules to be added to the release==
+
==Overview==
{| border="00" cellpadding="5" cellspacing="0"
+
*The documentation on this page has been created for Slicer 3.4 and discusses the features and capabilities of menu items and panels. It is intended to be used as a live reference manual. This is a wiki. You are welcome to add to the content and improve it.
|-
+
*In addition to the hundereds of smaller changes and improvements to Slicer in general, there are two substantial new addtions to Slicer 3.4:
| rowspan="2"|
+
**A new infrastructure to find and add plug-ins from a repository. See [[Documentation-3.4#Modules_for_Downloading|here]] for more information.
* The module is '''feature complete''' for the tasks advertised on 2-4-2009
+
**A new database using XNAT desktop. See [[Documentation-3.4#XNAT_Desktop|here]] for more information.
* 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.4#Modules|Slicer wiki]]. Please use the template provided [[Documentation-3.4#Modules|'''here''']] to structure your page.  
 
*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 '''Acknowledgment''' tab of the module. Please see the '''Models module''' for and example. The people listed in the acknowledgement will be the primary people for support and maintenance relative of the module.
 
** '''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.)
 
* If your module has [[Documentation-3.2|documentation in Slicer 3.2]], please copy/paste/update into the 3.4 version
 
| 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]]
 
|}
 
  
 
==Main GUI==
 
==Main GUI==
 
*[[Modules:MainApplicationGUI-Documentation-3.4| Main Application GUI]] (Wendy Plesniak)
 
*[[Modules:MainApplicationGUI-Documentation-3.4| Main Application GUI]] (Wendy Plesniak)
*[[Modules:EventBindings-3.4| List of Hotkeys and Keyboard Shortcuts]] (Wendy Plesniak)
+
*[[Modules:EventBindings-3.4| "Hot-keys" and Keyboard Shortcuts]] (Wendy Plesniak)
*[[Modules:Loading-Data-3.4| How to load data]] (Steve Pieper)
+
*[[Modules:DataModule-3.4| Loading Scenes and Individual Datasets through the Data Module]] (W Plesniak)
*[[Modules:Saving-Documentation-3.4| Save Scene and Data Module]] (Wendy Plesniak)
+
*[[Modules:Loading-Data-3.4| Data Loading Details]] (Steve Pieper)
 +
*[[Modules:Saving-Documentation-3.4| Saving Scenes and Data]] (Wendy Plesniak)
 +
*[[Modules:SceneSnapshots-3.4| Creating and Restoring Scene Snapshots]] (Alex Yarmarkovich & Steve Pieper)
 +
*[[Modules:ExtensionsManagementWizard-Documentation-3.4| Extensions Management Wizard]] (Terry Lorber)
  
 
==Modules==
 
==Modules==
Line 42: Line 41:
 
[[Slicer3:Module_Documentation-3.4_Template|Slicer3:Module_Documentation-3.4_Template]]
 
[[Slicer3:Module_Documentation-3.4_Template|Slicer3:Module_Documentation-3.4_Template]]
 
*See above for info to be put into the Help and Acknowledgment Tabs
 
*See above 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]]
+
*To put your lab's logo into a module, see [[Slicer3:Execution_Model_Documentation#Adding_Module_Logos_to_Slicer3|here]] for plugin module, and [[Slicer3:Loadable_Modules:HOWTO#Adding_logo_to_your_module|here]] for loadable module.
===Core and Loadable Modules===
+
===Core===
 +
 
 
*[[Modules:Welcome-Documentation-3.4| Welcome Module]] (Wendy Plesniak, Steve Pieper, Sonia Pujol, Ron Kikinis)
 
*[[Modules:Welcome-Documentation-3.4| Welcome Module]] (Wendy Plesniak, Steve Pieper, Sonia Pujol, Ron Kikinis)
 
 
  
 
*[[Modules:Volumes-Documentation-3.4| Volumes Module]] (Alex Yarmarkovich, Steve Pieper)
 
*[[Modules:Volumes-Documentation-3.4| Volumes Module]] (Alex Yarmarkovich, Steve Pieper)
 
**[[Modules:Volumes:Diffusion Editor-Documentation-3.4| Diffusion Editor]] (Kerstin Kessel)
 
**[[Modules:Volumes:Diffusion Editor-Documentation-3.4| Diffusion Editor]] (Kerstin Kessel)
 
*[[Modules:Models-Documentation-3.4| Models Module]] (Alex Yarmarkovich)
 
*[[Modules:Models-Documentation-3.4| Models Module]] (Alex Yarmarkovich)
 
 
 
*[[Modules:Fiducials-Documentation-3.4| Fiducials Module]]  (Nicole Aucoin)
 
*[[Modules:Fiducials-Documentation-3.4| Fiducials Module]]  (Nicole Aucoin)
 
*[[Modules:Data-Documentation-3.4| Data Module]] (Alex Yarmarkovich)
 
*[[Modules:Data-Documentation-3.4| Data Module]] (Alex Yarmarkovich)
 
*[[Modules:Slices-Documentation-3.4|Slices Module]] (Jim Miller)
 
*[[Modules:Slices-Documentation-3.4|Slices Module]] (Jim Miller)
*[[Modules:Transforms-Documentation-3.4| Transforms Module]] (Alex Yarmarkovich)
 
 
*[[Modules:Color-Documentation-3.4| Color Module]] (Nicole Aucoin)
 
*[[Modules:Color-Documentation-3.4| Color Module]] (Nicole Aucoin)
 
 
 
*[[Modules:Editor-Documentation-3.4| Interactive Editor]] (Steve Pieper)
 
*[[Modules:Editor-Documentation-3.4| Interactive Editor]] (Steve Pieper)
 
*[[Modules:ROIModule-Documentation-3.4|ROI Module]] (Alex Yarmarkovich)
 
*[[Modules:ROIModule-Documentation-3.4|ROI Module]] (Alex Yarmarkovich)
 
*[[Modules:VolumeRendering-Documentation-3.4| Volume Rendering Module]] (Alex Yarmarkovich)
 
*[[Modules:VolumeRendering-Documentation-3.4| Volume Rendering Module]] (Alex Yarmarkovich)
  
==Other Modules==
+
Additional modules may appear in this section of the menu if they are not otherwise categorized by the developer.
 +
 
 +
==Specialized Modules==
  
 
Please adhere to the naming scheme for the module documentation:
 
Please adhere to the naming scheme for the module documentation:
 
*[ [Modules:MyModuleNameNoSpaces-Documentation-3.4|My Module Name With Spaces] ] (First Last Name)
 
*[ [Modules:MyModuleNameNoSpaces-Documentation-3.4|My Module Name With Spaces] ] (First Last Name)
 +
 +
*[[Modules:PETCTFusion-Documentation-3.5|PETCTFusion]] (Wendy Plesniak)
 +
 
===Wizards===
 
===Wizards===
 
*[[Modules:ChangeTracker-Documentation-3.4|ChangeTracker]] (Andriy Fedorov)
 
*[[Modules:ChangeTracker-Documentation-3.4|ChangeTracker]] (Andriy Fedorov)
Line 75: Line 73:
 
*[[Modules:QDECModule-Documentation-3.4| QDEC Module]] (Nicole Aucoin)
 
*[[Modules:QDECModule-Documentation-3.4| QDEC Module]] (Nicole Aucoin)
 
*[[Modules:QueryAtlas-Documentation-3.4|Query Atlas Module]] (Wendy Plesniak)
 
*[[Modules:QueryAtlas-Documentation-3.4|Query Atlas Module]] (Wendy Plesniak)
 +
===Registration===
 +
*[[Slicer3:Registration#Registration_in_3D_Slicer|Updated Registration Tools Overview & links to documentation, examples and tutorials]]
 +
 +
===Segmentation===
 +
*[[Modules:EMSegment-Command-Line|EM Segment Command-Line]] (Brad Davis, Will Schroeder)
 +
*[[Modules:EMSegment-Simple|EM Segment Simple]] (Brad Davis, Will Schroeder)
 +
*[[Modules:EMSegment-TemplateBuilder|EM Segment Template Builder]] (Brad Davis, Will Schroeder)
 +
*[[Modules:Simple Region Growing-Documentation-3.4|Simple Region Growing]] (Jim Miller)
 +
*[[Modules:OtsuThreshold-Documentation-3.4|Otsu Threshold]] (Bill Lorensen)
 +
 +
===Statistics===
 +
*[[Modules:LabelStatistics-Documentation-3.4|Label Statistics]] (Steve Pieper)
 +
 +
===Diffusion===
 +
====DWI====
 +
*Estimation
 +
**[[Modules:DiffusionTensorEstimation-Documentation-3.4|Diffusion Tensor Estimation]] (Raul San Jose Estepar)
 +
*[[Modules:PythonExtractBaseline-Documentation-3.4|Python Extract Baseline DWI Volume]] (Julien de Siebenthal)
 +
*Filter
 +
**[[Modules:JointRicianLMMSEImageFilter-Documentation-3.4|Joint Rician LMMSE Image Filter]] (Antonio Tristán Vega, Santiago Aja Fernandez)
 +
**[[Modules:RicianLMMSEImageFilter-Documentation-3.4|Rician LMMSE Image Filter]] (Antonio Tristán Vega, Santiago Aja Fernandez, Marc Niethammer)
 +
**[[Modules:UnbiasedNonLocalMeans-Documentation-3.4|Unbiased Non Local Means filter for DWI]]  (Antonio Tristán Vega, Santiago Aja Fernandez)
 +
*[[Modules:ShiftDWIValues-Documentation-3.4|Python Shift DWI Values]] (Julien de Siebenthal)
 +
*[[Modules:RecenterScalar2DWI-Documentation-3.4|Python Recenter Scalar to DWI Volume]] (Julien de Siebenthal)
 +
 +
====DTI====
 +
*[[Modules:ResampleDTIVolume-Documentation-3.4|Resample DTI Volume]] (Francois Budin)
 +
*[[Modules:DiffusionTensorScalarMeasurements-Documentation-3.4 | Diffusion Tensor Scalar Measurements]] (Raul San Jose Estepar)
 +
*Analysis
 +
 +
===Tractography===
 +
*[[Modules:ROISeeding-Documentation-3.4 | Label Seeding]] (Raul San Jose Estepar)
 +
*[[Modules:FiducialSeeding-Documentation-3.4|Fiducial Seeding]] (Alex Yarmakovich, Steve Pieper)
 +
*[[Modules:DTIDisplay-Documentation-3.4|FiberBundles]] (Alex Yarmakovich)
 +
*[[Modules:StochasticTractography-Documentation-3.4|Python Stochastic Tractography]] (Julien de Siebenthal)
 +
 
===IGT===
 
===IGT===
 
*[[Modules:OpenIGTLinkIF-Documentation-3.4| OpenIGTLinkIF Module]] (Junichi Tokuda)  
 
*[[Modules:OpenIGTLinkIF-Documentation-3.4| OpenIGTLinkIF Module]] (Junichi Tokuda)  
 
*[[Modules:NeuroNav-Documentation-3.4| NeuroNav Module]] (Haiying Liu)
 
*[[Modules:NeuroNav-Documentation-3.4| NeuroNav Module]] (Haiying Liu)
 
*[[Modules:ProstateNav-Documentation-3.4| ProstateNav Module]] (Junichi Tokuda)
 
*[[Modules:ProstateNav-Documentation-3.4| ProstateNav Module]] (Junichi Tokuda)
 
===Batch processing===
 
*[[Modules:EMSegment-Documentation-3.4|EM Segementer batch]] (Julien Jomier, Stephen Aylward)
 
*[[Modules:GaussianBlur-Documentation-3.4|Gaussian blur batch]] (Julien Jomier, Stephen Aylward)
 
*[[Modules:Registration-Documentation-3.4|Registration batch]] (Julien Jomier, Stephen Aylward)
 
 
===Converters===
 
*[[Modules:CreateaDicomSeries-Documentation-3.4|Create a Dicom Series]] (Bill Lorensen)
 
*[[Modules:DicomToNRRD-3.4|Dicom to NRRD]] (Xiaodong Tao)
 
*[[Modules:OrientImages-Documentation-3.4|Orient Images]] (Bill Lorensen)
 
 
===Demonstration===
 
*[[Modules:ExecutionModelTour-Documentation-3.4|Execution Model Tour]] (Daniel Blezek, Bill Lorensen)
 
*[[Modules:ScriptedModuleExample-Documentation-3.4| Scripted Module Example]] (Steve Pieper)
 
 
 
===Filtering===
 
===Filtering===
 
*[[Modules:CheckerboardFilter-Documentation-3.4|Checkerboard Filter]] (Bill Lorensen)
 
*[[Modules:CheckerboardFilter-Documentation-3.4|Checkerboard Filter]] (Bill Lorensen)
Line 104: Line 123:
 
**[[Modules:AddImages-Documentation-3.4|Add Images]] (Bill Lorensen)
 
**[[Modules:AddImages-Documentation-3.4|Add Images]] (Bill Lorensen)
 
**[[Modules:SubtractImages-Documentation-3.4|Subtract Images]] (Bill Lorensen)
 
**[[Modules:SubtractImages-Documentation-3.4|Subtract Images]] (Bill Lorensen)
 +
**[[Modules:CastImage-Documentation-3.4|Cast Image]] (Nicole Aucoin)
 
*Denoising
 
*Denoising
 
**[[Modules:GradientAnisotropicFilter-Documentation-3.4| Gradient Anisotropic Filter]]  (Bill Lorensen checked this in)
 
**[[Modules:GradientAnisotropicFilter-Documentation-3.4| Gradient Anisotropic Filter]]  (Bill Lorensen checked this in)
 
**[[Modules:CurvatureAnisotropicDiffusion-Documentation-3.4|Curvature Anisotropic Diffusion]] (Bill Lorensen)
 
**[[Modules:CurvatureAnisotropicDiffusion-Documentation-3.4|Curvature Anisotropic Diffusion]] (Bill Lorensen)
 
**[[Modules:GaussianBlur-Documentation-3.4|Gaussian Blur]] (Julien Jomier, Stephen Aylward)  
 
**[[Modules:GaussianBlur-Documentation-3.4|Gaussian Blur]] (Julien Jomier, Stephen Aylward)  
**[[Modules:MedianFilter-Documentation-3.4|Median Filter]] (Bill Lorensen)
+
**[[Modules:MedianFilter-Documentation-3.6|Median Filter]] (Bill Lorensen)
 
*Morphology
 
*Morphology
 
**[[Modules:VotingBinaryHoleFilling-Documentation-3.4|Voting Binary Hole Filling]] (Bill Lorensen)
 
**[[Modules:VotingBinaryHoleFilling-Documentation-3.4|Voting Binary Hole Filling]] (Bill Lorensen)
Line 125: Line 145:
 
*[[Slicer3:Model_Into_Label_Volume_Documentation-3.4| Model into Label Volume]] (Nicole Aucoin)
 
*[[Slicer3:Model_Into_Label_Volume_Documentation-3.4| Model into Label Volume]] (Nicole Aucoin)
  
===Python Modules===
+
===Batch processing===
 +
*[[Modules:EMSegmentBatch-Documentation-3.4|EM Segmenter batch]] (Julien Jomier, Brad Davis)
 +
*[[Modules:GaussianBlurBatch-Documentation-3.4|Gaussian Blur batch]] (Julien Jomier, Stephen Aylward)
 +
*[[Modules:RegisterImagesBatch-Documentation-3.4|Register Images batch]] (Julien Finet, Stephen Aylward)
 +
*[[Modules:ResampleVolumeBatch-Documentation-3.4|Resample Volume batch]] (Julien Finet)
 +
 
 +
===Converters===
 +
*[[Modules:CreateaDicomSeries-Documentation-3.4|Create a Dicom Series]] (Bill Lorensen)
 +
*[[Modules:DicomToNRRD-3.4|Dicom to NRRD]] (Xiaodong Tao)
 +
*[[Modules:OrientImages-Documentation-3.4|Orient Images]] (Bill Lorensen)
 
*[[Modules:PythonExplodeVolumeTransform-Documentation-3.4| Python Explode Volume Transform]] (Luca Antiga, Daniel Blezek)
 
*[[Modules:PythonExplodeVolumeTransform-Documentation-3.4| Python Explode Volume Transform]] (Luca Antiga, Daniel Blezek)
 +
*[[Modules:ExtractSubvolume-Documentation-3.4| Extract Subvolume]] (Steve Pieper)
 +
 +
===Work in Progress===
 +
Various tools in development will appear here depending on the version of slicer you are using.
 +
===Developer Tools===
 
*[[Modules:PythonScript-Documentation-3.4| Python Script]] (Luca Antiga, Daniel Blezek)
 
*[[Modules:PythonScript-Documentation-3.4| Python Script]] (Luca Antiga, Daniel Blezek)
 
*[[Modules:PythonNumpyScript-Documentation-3.4| Python Numpy Script]] (Luca Antiga, Daniel Blezek)
 
*[[Modules:PythonNumpyScript-Documentation-3.4| Python Numpy Script]] (Luca Antiga, Daniel Blezek)
 +
*[[Modules:ExecutionModelTour-Documentation-3.4|Execution Model Tour]] (Daniel Blezek, Bill Lorensen)
 +
*[[Modules:ScriptedModuleExample-Documentation-3.4| Scripted Module Example]] (Steve Pieper)
  
===Registration===
+
=Extensions for Downloading=
*[[Modules:AffineRegistration-Documentation-3.4|Affine Registration]] (Daniel Blezek)
+
[[Image:SlicerOnNITRC2009.png|thumb|right|Slicer on NITRC]]
*[[Modules:DeformableB-SplineRegistration-Documentation-3.4|Deformable B-Spline Registration]] (Bill Lorensen)
+
Work is in progress to create infrastructure for searching and loading extensions. See [[Slicer3:Extensions]] for more information.
*[[Modules:DiffeomorphicDemonsAlgorithm-Documentation3.4|Diffeomorphic Demons Algorithm]] (Tom Vercauteren, Ender Konukoglu, Kilian Pohl)
+
*This will allow contributors and software developers to post their own Slicer extensions and have them compiled against the "official" versions of Slicer.
*[[Modules:LinearRegistration-Documentation-3.4|Linear Registration]] (Daniel Blezek)
+
*Users can browse these contributed extensions and install them on their own versions of Slicer.
*[[Modules:RealignVolume-Documentation-3.4|Realign Volume]] (Nicole Aucoin)
 
*[[Modules:RigidRegistration-Documentation-3.4|Rigid Registration]] (Daniel Blezek)
 
  
===Segmentation===
 
*EM Segment Command-Line (Brad Davis, Will Schroeder)
 
*EM Segment Simple (Brad Davis, Will Schroeder)
 
*EMSegmentTemplateBuilder (Brad Davis, Will Schroeder)
 
*[[Modules:Simple Region Growing-Documentation-3.4|Simple Region Growing]] (Jim Miller)
 
*[[Modules:OtsuThreshold-Documentation-3.4|Otsu Threshold]] (Bill Lorensen)
 
  
===Statistics===
+
We are currently using NITRC as a repository for contributed extensions. As a general rule, we do not test them ourselves, it is the downloaders job to ensure that they do what they want them to do.
*Calculate Volume Statistics (Tri Ngo)
+
Click [http://www.nitrc.org/search/?type_of_search=soft&words=slicer3&Search.x=0&Search.y=0&Search=Search  here] to see a listing of Slicer 3 extensions on NITRC.
*[[Modules:LabelStatistics-Documentation-3.4|Label Statistics]] (Steve Pieper)
 
  
===DWI and Tractography===
+
[[Image:Slicer-3.4.1-extension-manager-2009-10-02.png|thumb|right|Extension manager dialog box]]
====DWI====
+
To add extension modules to an installed binary of slicer:
*Estimation
 
**[[Modules:DiffusionTensorEstimation-Documentation-3.4|Diffusion Tensor Estimation]] (Raul San Jose Estepar)
 
*[[Modules:PythonExtractBaseline-Documentation-3.4|Python Extract Baseline DWI Volume]] (Julien von Siebenthal)
 
*Filter
 
**[[Modules:JointRicianLMMSEImageFilter-Documentation-3.4|Joint Rician LMMSE Image Filter]] (Antonio Tritan Vega, Santiago Aja Fernandez)
 
**[[Modules:RicianLMMSEImageFilter-Documentation-3.4|Rician LMMSE Image Filter]] (Antonio Tritan Vega, Santiago Aja Fernandez)
 
**[[Modules:UnbiasedNonLocalMeans-Documentation-3.4|Unbiased Non Local Means filter for DWI]]  (Antonio Tritan Vega, Santiago Aja Fernandez)
 
*[[Modules:ShiftDWIValues-Documentation-3.4|Python Shift DWI Values]] (Julien von Siebenthal)
 
*[[Modules:RecenterScalar2DWI-Documentation-3.4|Python Recenter Scalar to DWI Volume]] (Julien von Siebenthal)
 
  
====DTI====
+
* Use the View->Extension Manager menu option
*[[Modules:ResampleDTIVolume-Documentation-3.4|Resample DTI Volume]] (Francois Budin)
+
* The dialog will be initialized with the URL to the extensions that have been compiled to match your binary of slicer.
*[[Modules:DTIDisplay-Documentation-3.4|Display]] (Alex Yarmakovich)
+
** '''Note''' installing extensions from a different repository URL is likely to be unstable due to platform and software version differences.
*[[Modules:DiffusionTensorScalarMeasurements-Documentation-3.4 | Diffusion Tensor Scalar Measurements]] (Raul San Jose Estepar)
+
** You can select a local install directory for your downloaded extensions (be sure to choose a directory with enough free space).
*Analysis
+
* Select the extensions you wish to install and click to download them.  Installed extensions will be available when you restart slicer.
**[[Modules:FiducialSeeding-Documentation-3.4|Fiducial Seeding]] (Alex Yarmakovich, Steve Pieper)
+
* To turn modules on or off, you can use the Module Settings page of the View->Application Settings dialog.
**[[Modules:ROISeeding-Documentation-3.4 | ROI Seeding]] (Raul San Jose Estepar)
 
**[[Modules:StochasticTractography-Documentation-3.4|Python Stochastic Tractography]] (Julien von Siebenthal)
 
  
=Documented Modules=
+
=XNAT Desktop and FetchMI=
(please do not touch this section for now. Ron)
+
*Work is underway to use XNAT desktop (xnd) as a local database for Slicer. This database will exist in parallel with the other load and save mechanisms and will allow to download/upload individual files or entire scenes with all their dependent files.
==Main GUI==
+
*Users of Slicer will have to install xnd on their computer. Once set up, the FetchMI interface will allow users to upload and download mrml scenes with all the dependent files, or individual volumes, models, other components of slicer scenes.
 +
*See [http://nrg.wustl.edu/xnd/download here] for a link to the download site for xnd. See [http://www.xnat.org/xnd here] for documentation on how to install XNAT desktop on your computer.
 +
*'''On Macs and Linux you currently have to change permissions of the executable after installation.'''
 +
*In the future (summer 2009) xnd will be able to upload and download mrml scenes to xnat enterprise.
  
==Modules==
+
*FetchMI is the current interface inside slicer for exploring information stored in xnd and down and upload such data. It is a "sandbox" implementation to help us understand how users will want to use remotely stored data and metadata in the Slicer environment. Eventually, FetchMI's remote load and save will be integrated with Slicer's existing load and save interfaces, and FetchMI's data tagging functionality will be more fully developed as a new metadata authoring module.
 +
*See [[Modules:FetchMI-Documentation-3.4|here]] for more information about FETCHMI. User comments and suggestions are welcome.
  
===Core and Loadable Modules===
+
=FreeSufer Integration=
  
==CLI Modules==
+
* FreeSurfer surfaces and scalar overlays can be loaded via the [[Modules:Models-Documentation-3.4|Models]] module and MGZ volumes can be loaded via the File ->  Add Data widget.
 +
* More detailed information can be found [[Modules:Freesurfer-Documentation-3.4|here]].
  
=Modules for Downloading=
+
= Requirements for modules to be added to the release=
[[Image:SlicerOnNITRC2009.png|thumb|right|Slicer on NITRC]]
+
{| border="00" cellpadding="5" cellspacing="0"
We are using NITRC as a repository for contributed modules. As a general rule, we do not test them ourselves, it is the downloaders job to ensure that they do what they want them to do.
+
|-
 
+
| rowspan="2"|  
Click [http://www.nitrc.org/search/?type_of_search=soft&words=slicer3&Search.x=0&Search.y=0&Search=Search  here] to see a listing of Slicer 3 modules on NITRC.
+
* The module is '''feature complete''' for the tasks advertised
 
+
* The module has a '''test'''. See [http://wiki.na-mic.org/Wiki/index.php/Slicer3:Execution_Model_Testing '''here'''] for more information.
Work is in progress to create infrastructure for searching an loading modules. See [[Slicer3:Loadable_Modules:Status_2009-01-20|here]] for more information.
+
* Module has '''documentation''' on the [[Documentation-3.4#Modules|Slicer wiki]]. Please use the template provided [[Documentation-3.4#Modules|'''here''']] to structure your page.
 +
*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 '''Acknowledgment''' tab of the module. Please see the '''Models module''' for and example. The people listed in the acknowledgement will be the primary people for support and maintenance relative of the module.
 +
** '''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 your logos and additional image resources to the location reference above in order to promote shared use (and to prevent duplication in the code.)
 +
| 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]]
 +
|}

Latest revision as of 07:30, 14 June 2013

Home < Documentation < 3.4


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


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

This page is a portal for documentation about Slicer 3.4. For information for software developers, please go to the Developers page (see link in navigation box to the left).

How-To Tutorials

Feature Request and Problem Reports

We have an issues tracker for Slicer 3. You need to create an account for filing reports. We keep track of both feature requests and bug reports. Make sure to use the pull-down in the upper right to select Slicer 3.

System Requirements

  • Hardware: The hardware requirements are driven by the kind of analysis you wish to perform. For large data sets we suggest the 64 bit linux build on a machine with several gig of memory (e.g. a 1000 slice CT is half a gig of memory just to load plus there are temporary copies in memory during any processing steps). Note that Windows often does not make the full system memory available to applications.
  • Disk Space: In addition to the installation directory (about 200 meg depending on platform), operations like installing downloaded extensions, caching internet data downloads, and running external programs will require additional memory; the exact amount depends on the operations you perform. To be safe, an extra gig or more of free disk space is a good idea for "typical" uses such as neuro MR analysis.
  • Directory Settings: There are several user-selectable directory paths. Please confirm that these paths point to locations with sufficient storage space for your intended use.
    • View->Application Settings->Module Settings->Temporary Directory is used as scratch space when running modules. By default this points to a new temp directory in your home directory.
    • View->Application Settings->Module Settings->Extensions Install Path is where newly downloaded extension modules will be saved.
    • View->Application Settings->Remote Data Handling Settings->Cache Directory is where downloaded data is stored for possible re-use. This defaults to the same as the Temporary Directory.

List of Modules

Overview

  • The documentation on this page has been created for Slicer 3.4 and discusses the features and capabilities of menu items and panels. It is intended to be used as a live reference manual. This is a wiki. You are welcome to add to the content and improve it.
  • In addition to the hundereds of smaller changes and improvements to Slicer in general, there are two substantial new addtions to Slicer 3.4:
    • A new infrastructure to find and add plug-ins from a repository. See here for more information.
    • A new database using XNAT desktop. See here for more information.

Main GUI

Modules

  • Please copy the template linked below, paste it into your page and customize it with your module's information.

Slicer3:Module_Documentation-3.4_Template

  • See above for info to be put into the Help and Acknowledgment Tabs
  • To put your lab's logo into a module, see here for plugin module, and here for loadable module.

Core

Additional modules may appear in this section of the menu if they are not otherwise categorized by the developer.

Specialized Modules

Please adhere to the naming scheme for the module documentation:

  • [ [Modules:MyModuleNameNoSpaces-Documentation-3.4|My Module Name With Spaces] ] (First Last Name)

Wizards

Informatics Modules

Registration

Segmentation

Statistics

Diffusion

DWI

DTI

Tractography

IGT

Filtering

Surface Models

  • Modelmaker (Nicole Aucoin)
  • Grayscale Model Maker (Bill Lorensen)

Batch processing

Converters

Work in Progress

Various tools in development will appear here depending on the version of slicer you are using.

Developer Tools

Extensions for Downloading

Slicer on NITRC

Work is in progress to create infrastructure for searching and loading extensions. See Slicer3:Extensions for more information.

  • This will allow contributors and software developers to post their own Slicer extensions and have them compiled against the "official" versions of Slicer.
  • Users can browse these contributed extensions and install them on their own versions of Slicer.


We are currently using NITRC as a repository for contributed extensions. As a general rule, we do not test them ourselves, it is the downloaders job to ensure that they do what they want them to do. Click here to see a listing of Slicer 3 extensions on NITRC.

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.

XNAT Desktop and FetchMI

  • Work is underway to use XNAT desktop (xnd) as a local database for Slicer. This database will exist in parallel with the other load and save mechanisms and will allow to download/upload individual files or entire scenes with all their dependent files.
  • Users of Slicer will have to install xnd on their computer. Once set up, the FetchMI interface will allow users to upload and download mrml scenes with all the dependent files, or individual volumes, models, other components of slicer scenes.
  • See here for a link to the download site for xnd. See here for documentation on how to install XNAT desktop on your computer.
  • On Macs and Linux you currently have to change permissions of the executable after installation.
  • In the future (summer 2009) xnd will be able to upload and download mrml scenes to xnat enterprise.
  • FetchMI is the current interface inside slicer for exploring information stored in xnd and down and upload such data. It is a "sandbox" implementation to help us understand how users will want to use remotely stored data and metadata in the Slicer environment. Eventually, FetchMI's remote load and save will be integrated with Slicer's existing load and save interfaces, and FetchMI's data tagging functionality will be more fully developed as a new metadata authoring module.
  • See here for more information about FETCHMI. User comments and suggestions are welcome.

FreeSufer Integration

  • FreeSurfer surfaces and scalar overlays can be loaded via the Models module and MGZ volumes can be loaded via the File -> Add Data widget.
  • More detailed information can be found here.

Requirements for modules to be added to the release

  • The module is feature complete for the tasks advertised
  • The module has a test. See here for more information.
  • Module has documentation on the Slicer wiki. Please use the template provided here to structure your page.
  • 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 Acknowledgment tab of the module. Please see the Models module for and example. The people listed in the acknowledgement will be the primary people for support and maintenance relative of the module.
    • 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 your logos and additional image resources to the location reference above in order to promote shared use (and to prevent duplication in the code.)
Examples for the Help and

Acknowledgment Panels

SlicerHelpExample.png
SlicerAcknowledgementExample.png