Difference between revisions of "Documentation/Nightly/Modules/TractographyDisplay"

From Slicer Wiki
Jump to: navigation, search
(Prepend documentation/versioncheck template. See http://na-mic.org/Mantis/view.php?id=2887)
m (Text replacement - "https?:\/\/(?:www|wiki)\.slicer\.org\/slicerWiki\/index\.php\/([^ ]+) " to "https://www.slicer.org/wiki/$1 ")
 
(6 intermediate revisions by 2 users not shown)
Line 8: Line 8:
 
{{documentation/{{documentation/version}}/module-introduction-start|{{documentation/modulename}}}}
 
{{documentation/{{documentation/version}}/module-introduction-start|{{documentation/modulename}}}}
 
{{documentation/{{documentation/version}}/module-introduction-row}}
 
{{documentation/{{documentation/version}}/module-introduction-row}}
This work is part of the National Alliance for Medical Image Computing (NA-MIC), funded by the National Institutes of Health through the NIH Roadmap for Medical Research, Grant U54 EB005149. Information on NA-MIC can be obtained from the [http://www.na-mic.org/ NA-MIC website].<br>
+
 
Author: Isaiah Norton, Goldby Lab<br>
+
Title: Tractography Display
Author: Demian Wassermann, SPL<br>
+
 
Contributor1: Steve Pieper, Isomics Inc.<br>
+
Author(s)/Contributor(s): Demian Wassermann, Isaiah Norton, Lauren O'Donnell, Steve Pieper, Alex Yarmarkovich (SPL, LMI, BWH, SlicerDMRI)
Contributor2: Alex YarmarKovich, Isomics Inc.<br>
+
 
Contact:  Demian Wassermann, <email>demian@bwh.harvard.edu</email><br>
+
License: 3D Slicer Contribution and Software License Agreement
 +
 
 +
Acknowledgements: The SlicerDMRI developers gratefully acknowledge funding for this project provided by NIH NCI ITCR U01CA199459 (Open Source Diffusion MRI Technology For Brain Cancer Research), NIH P41EB015898 (National Center for Image-Guided Therapy) and NIH P41EB015902 (Neuroimaging Analysis Center), as well as the National Alliance for Medical Image Computing (NA-MIC), funded by the National Institutes of Health through the NIH Roadmap for Medical Research, Grant U54 EB005149.
 +
 
 +
Contact:  slicer-users@bwh.harvard.edu
 +
 
 +
Website: http://slicerdmri.github.io/
 +
 
 
{{documentation/{{documentation/version}}/module-introduction-row}}
 
{{documentation/{{documentation/version}}/module-introduction-row}}
 
{{documentation/{{documentation/version}}/module-introduction-logo-gallery
 
{{documentation/{{documentation/version}}/module-introduction-logo-gallery
 +
|Image:SlicerDMRIScreenshot.jpg|SlicerDMRI
 
|Image:Logo-splnew.jpg|Surgical Planning Laboratory
 
|Image:Logo-splnew.jpg|Surgical Planning Laboratory
 +
|Image:NAC-logo.png|NAC
 +
|Image:Tracts display.png|Tractography displayed in line, tube and glyphs
 +
|Image:Tracts on slices.png|Tractography displayed on slices
 
}}
 
}}
 
{{documentation/{{documentation/version}}/module-introduction-end}}
 
{{documentation/{{documentation/version}}/module-introduction-end}}
Line 23: Line 34:
 
<!-- ---------------------------- -->
 
<!-- ---------------------------- -->
 
{{documentation/{{documentation/version}}/module-section|Module Description}}
 
{{documentation/{{documentation/version}}/module-section|Module Description}}
Allows the user to manipulate several different characteristics of the traced white matter tracts. Examples are: change of color; display of the fractional anisotropy along the tract; display of the tracts as tubes or lines; interactive selection of the tracts; and cropping.
+
Allows the user to modify the display of diffusion tractography. Examples are: change of color, display of the fractional anisotropy along the tract, display of the tracts as tubes or lines, interactive selection of the tracts, and cropping.
  
 
<!-- ---------------------------- -->
 
<!-- ---------------------------- -->
Line 36: Line 47:
 
{{documentation/{{documentation/version}}/module-section|Tutorials}}
 
{{documentation/{{documentation/version}}/module-section|Tutorials}}
 
Links to tutorials that use this module
 
Links to tutorials that use this module
 
+
* Slicer4 Diffusion Tensor Imaging Tutorial: https://www.slicer.org/wiki/Documentation/Nightly/Training#Slicer4_Diffusion_Tensor_Imaging_Tutorial <!-- ---------------------------- -->
<!-- ---------------------------- -->
 
 
{{documentation/{{documentation/version}}/module-section|Panels and their use}}
 
{{documentation/{{documentation/version}}/module-section|Panels and their use}}
  
Line 44: Line 54:
 
{|style="width: 100%"
 
{|style="width: 100%"
 
|
 
|
*  
+
* Simple Display
** Line: Display the tracts as lines
+
** Solid Tube Color: Display the tracts as tubes in solid color, if checked
** Tube: Display the tracts as tubes
+
** Lines: Display the tracts as lines
*** Slice Intersection: Show the tracts in the 2D view
+
** Tubes: Display the tracts as tubes
** Glyph: Display glyphs representing the diffusion tensors along the tracts
+
** Tubes Slice: Show the tracts in the 2D view (Tubes Slice)
 +
** Glyphs: Display glyphs representing the diffusion tensors along the tracts
 +
** Tubes: Specify the solid tube color
 
** Percentage of Fibers Shown: Select how many of the total tracts in the bundle are shown. Useful for performance.
 
** Percentage of Fibers Shown: Select how many of the total tracts in the bundle are shown. Useful for performance.
* Fiber Bundle Selection: Perform interactive selection and cropping of the tracts
+
* Fiber Bundle Selection: Perform selection and cropping of the tracts
 
** ROI for Fiber Selection: Select a ROI to use as an interactor with the tracts
 
** ROI for Fiber Selection: Select a ROI to use as an interactor with the tracts
** Disable/Positive/Negative ROI: Set the selection mode to '''Select everything'''; '''Select the tracts traversing the ROI'''; '''Select the tracts not traversing the ROI'''
+
** Disable/Positive/Negative ROI: Set the selection mode to ''Select everything'', ''Select the tracts traversing the ROI'' or ''Select the tracts not traversing the ROI''
** Create Bundle From ROI: Create a new fiber bundle which contains only the selected ones
+
** Interactive ROI: Allow the fiber selection and cropping in an interactive way
 +
** ROI Visibility: Display the ROI
 +
** Extract Bundle From ROI: Extract a new fiber bundle which contains only the selected ones
 
** Update Bundle From ROI: Update the current fiber bundle leaving only the selected ones
 
** Update Bundle From ROI: Update the current fiber bundle leaving only the selected ones
* Advance Display: For the lines, tubes and glyphs
+
*** Confirm update: Confirm update given the ROI
 +
** Enable Interactive Edit: Allow to edit the ROI in an interactive way
 +
* Advanced Display: For the lines, tubes and glyphs
 
** Visibility: Toggle the visibility of the bundle
 
** Visibility: Toggle the visibility of the bundle
 
** Opacity: Change the transparency level of the bundle
 
** Opacity: Change the transparency level of the bundle
** Color By: Change the way the bundle is colored; either by a tensor-derived property or by a group id
+
** Fiber Bundle Coloring: Change the way the bundle is colored, one of "Of Tensor Property", "Of Scalar Value", "Color Fibers By Mean Orientation", "Color Fibers By Segment Orientation", "Of Fiber Cluster Group ID" or "Solid Color".
** Solid Color: Color the bundle of a single solid color
+
*** Auto W/L: Adjust the window level automatically
 +
** Material Properties: Adjust Color, Opacity, Ambient, Diffuse, Specular, Power and Backface Culling of the displayed tracts.
 +
*** Preview: Color preview given the adjusted properties
 +
*** Presents: Select one of the predefined property sets
 +
 
 
<!--
 
<!--
 
| align="right" |
 
| align="right" |
Line 67: Line 87:
 
|}
 
|}
 
-->
 
-->
 +
 +
<!-- ---------------------------- -->
 +
{{documentation/{{documentation/version}}/module-section|Similar Modules}}
 +
* Models
  
 
<!-- ---------------------------- -->
 
<!-- ---------------------------- -->
 
{{documentation/{{documentation/version}}/module-section|References}}
 
{{documentation/{{documentation/version}}/module-section|References}}
Publications related to this module go here. Links to pdfs would be useful.
+
*  http://slicerdmri.github.io/
For extensions: link to the source code repository and additional documentation
 
  
 
<!-- ---------------------------- -->
 
<!-- ---------------------------- -->
 
{{documentation/{{documentation/version}}/module-section|Information for Developers}}
 
{{documentation/{{documentation/version}}/module-section|Information for Developers}}
{{documentation/{{documentation/version}}/module-developerinfo}}
+
* https://github.com/SlicerDMRI
  
 
<!-- ---------------------------- -->
 
<!-- ---------------------------- -->
 
{{documentation/{{documentation/version}}/module-footer}}
 
{{documentation/{{documentation/version}}/module-footer}}
 
<!-- ---------------------------- -->
 
<!-- ---------------------------- -->

Latest revision as of 13:15, 27 November 2019

Home < Documentation < Nightly < Modules < TractographyDisplay


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


Introduction and Acknowledgements

Title: Tractography Display

Author(s)/Contributor(s): Demian Wassermann, Isaiah Norton, Lauren O'Donnell, Steve Pieper, Alex Yarmarkovich (SPL, LMI, BWH, SlicerDMRI)

License: 3D Slicer Contribution and Software License Agreement

Acknowledgements: The SlicerDMRI developers gratefully acknowledge funding for this project provided by NIH NCI ITCR U01CA199459 (Open Source Diffusion MRI Technology For Brain Cancer Research), NIH P41EB015898 (National Center for Image-Guided Therapy) and NIH P41EB015902 (Neuroimaging Analysis Center), as well as the National Alliance for Medical Image Computing (NA-MIC), funded by the National Institutes of Health through the NIH Roadmap for Medical Research, Grant U54 EB005149.

Contact: slicer-users@bwh.harvard.edu

Website: http://slicerdmri.github.io/

SlicerDMRI  
Surgical Planning Laboratory  
NAC  
Tractography displayed in line, tube and glyphs  
Tractography displayed on slices  


Module Description

Allows the user to modify the display of diffusion tractography. Examples are: change of color, display of the fractional anisotropy along the tract, display of the tracts as tubes or lines, interactive selection of the tracts, and cropping.

Use Cases

Most frequently used for these scenarios:

  • Use Case 1: Change the scalar quantity displayed along the tract, like Fractional Anisotropy or Color By Orientation
  • Use Case 2: Display the tracts as lines or tubes
  • Use Case 3: Interactive selection or cropping of a certain bundle.

Tutorials

Links to tutorials that use this module

Panels and their use

2011-11-12-CroppingWholeBrainTractography.png

  • Simple Display
    • Solid Tube Color: Display the tracts as tubes in solid color, if checked
    • Lines: Display the tracts as lines
    • Tubes: Display the tracts as tubes
    • Tubes Slice: Show the tracts in the 2D view (Tubes Slice)
    • Glyphs: Display glyphs representing the diffusion tensors along the tracts
    • Tubes: Specify the solid tube color
    • Percentage of Fibers Shown: Select how many of the total tracts in the bundle are shown. Useful for performance.
  • Fiber Bundle Selection: Perform selection and cropping of the tracts
    • ROI for Fiber Selection: Select a ROI to use as an interactor with the tracts
    • Disable/Positive/Negative ROI: Set the selection mode to Select everything, Select the tracts traversing the ROI or Select the tracts not traversing the ROI
    • Interactive ROI: Allow the fiber selection and cropping in an interactive way
    • ROI Visibility: Display the ROI
    • Extract Bundle From ROI: Extract a new fiber bundle which contains only the selected ones
    • Update Bundle From ROI: Update the current fiber bundle leaving only the selected ones
      • Confirm update: Confirm update given the ROI
    • Enable Interactive Edit: Allow to edit the ROI in an interactive way
  • Advanced Display: For the lines, tubes and glyphs
    • Visibility: Toggle the visibility of the bundle
    • Opacity: Change the transparency level of the bundle
    • Fiber Bundle Coloring: Change the way the bundle is colored, one of "Of Tensor Property", "Of Scalar Value", "Color Fibers By Mean Orientation", "Color Fibers By Segment Orientation", "Of Fiber Cluster Group ID" or "Solid Color".
      • Auto W/L: Adjust the window level automatically
    • Material Properties: Adjust Color, Opacity, Ambient, Diffuse, Specular, Power and Backface Culling of the displayed tracts.
      • Preview: Color preview given the adjusted properties
      • Presents: Select one of the predefined property sets


Similar Modules

  • Models

References

Information for Developers