Difference between revisions of "Documentation/4.3/Extensions/CleaverExtension"

From Slicer Wiki
Jump to: navigation, search
(Wiki page complete.)
Line 28: Line 28:
 
Contact2: Brig Bagley, <email>brig@sci.utah.edu</email><br>
 
Contact2: Brig Bagley, <email>brig@sci.utah.edu</email><br>
  
−
{{documentation/{{documentation/version}}/module-introduction-row}}
+
{|
−
 
+
|[[Image:Sci.png|thumb|340px|SCI Institute]]
−
{{documentation/{{documentation/version}}/module-introduction-logo-gallery
+
|[[Image:CleaverCIBC.png|thumb|340px|Cleaver - CIBC]]
−
|{{collaborator|logo|ge}}|{{collaborator|longname|ge}}
+
|[[Image:uofu.jpg|thumb|340px|University of Utah]]
−
|{{collaborator|logo|kitware}}|{{collaborator|longname|kitware}}
+
|}
−
|{{collaborator|logo|namic}}|{{collaborator|longname|namic}}
 
−
}}
 
−
 
 
−
{{documentation/{{documentation/version}}/module-introduction-end}}
 
  
 
<!-- ---------------------------- -->
 
<!-- ---------------------------- -->
Line 49: Line 45:
 
{{documentation/{{documentation/version}}/module-section|Use Cases}}
 
{{documentation/{{documentation/version}}/module-section|Use Cases}}
 
{|
 
{|
−
|[[Image:SkullStripperInput-3-6.png|thumb|340px|Input T1 Image]]
+
|[[Image:FrogSlices.jpeg|thumb|540px|Input Frog image slices]]
−
|[[Image:SkullStripperOutput-3-6.png|thumb|340px|Brain mask as contour]]
+
|[[Image:SlicerFrogOutput.png|thumb|375px|Frog Surface]]
−
|[[Image:SkullStripperSurface-3-6.png|thumb|375px|Brain surface]]
 
 
|}
 
|}
−
 
−
<!-- ---------------------------- -->
 
−
{{documentation/{{documentation/version}}/module-section|Tutorials}}
 
  
 
<!-- ---------------------------- -->
 
<!-- ---------------------------- -->
Line 62: Line 54:
 
{|
 
{|
 
|
 
|
−
|[[Image:SkullStripper-3-6.png|thumb|280px|Module UI]]
+
|[[Image:SlicerGui.png|thumb|280px|Module UI]]
 
|}
 
|}
 +
*Input Volume 1-8 : Import up to 8 different volumes (NRRD) of the same dimension for Cleaver to mesh.
 +
*Output Model1-10 : Create up to 10 new models for Cleaver to write mesh data to. If none or too few are specified for the output, the console will provide the locations of the VTK mesh files and MRML scene file to load.
 +
*Use Padding : Often a good option to allow if material transitions exist at the volume boundaries.
 +
*Alpha Short : The minimum distance on an edge cut after which Cleaver does not warp a vertex.
 +
*Alpha Long : The maximum distance on an edge cut after which Cleaver will create a sub-tetrahedron (Cleave the current tet).
 +
*Verbose : Whether the console is to output detailed information on the cleaving steps.
 +
*Output format:
 +
**VTKtet : The default option that creates VTK mesh files with the output volume tets.
 +
**VTKfac : These VTK files define meshes that signify transitions between materials.
 +
**tetgen : This output can be read into the TetGen Program.
 +
**scirun : This output can be read into SCI's SciRun program.
 +
**matlab : This output can be read into MATLAB.
 +
*Restore Defaults : Restores the default options.
 +
*AutoRun : Runs the program automatically when a change is made (does not work with CleaverExtension).
 +
*Apply : Runs the CLI with the above options within Slicer. See output in the console.
 +
*Cancel : Stop the current process.
  
 
<!-- ---------------------------- -->
 
<!-- ---------------------------- -->
−
{{documentation/{{documentation/version}}/module-section|Similar Modules}}
+
{{documentation/{{documentation/version}}/module-section|Tutorials}}
−
 
+
*Both volumes and models are provided and created, respectively. When running in VTKtet output mode, the tet models are automatically loaded into Slicer.<br>
 +
{|
 +
|[[Image:Screenshot1.jpeg|thumb|700px|Example2]]
 +
|}<br>
 +
*Volumes are imported, then the program is run in VTKtet output mode. The output MRML is then loaded and clipped.<br>
 +
{|
 +
|[[Image:Screenshot2.jpeg|thumb|700px|Example3]]
 +
|}<br>
 +
*Volumes are imported, then the program is run in VTKfac output mode. The output MRML is then loaded and clipped.<br>
 +
{|
 +
|[[Image:Screenshot3.jpeg|thumb|700px|Example4]]
 +
|}<br>
 +
*An illustration of noting the output files of CleaverExtension when no models are provided. These can then be loaded into Slicer manually.<br>
 +
{|
 +
|[[Image:Screenshot4.jpeg|thumb|700px|Example1]]
 +
|}<br>
 
<!-- ---------------------------- -->
 
<!-- ---------------------------- -->
 
{{documentation/{{documentation/version}}/module-section|References}}
 
{{documentation/{{documentation/version}}/module-section|References}}
−
* Bronson J., Levine, J., Whitaker R., "Lattice Cleaving: Conforming Tetrahedral Meshes of Multimaterial Domains with Bounded Quality". Proceedings of the 21st International Meshing Roundtable (San Jose, CA, Oct 7-10, 2012).
+
* Bronson J., Levine, J., Whitaker R., "Lattice Cleaving: Conforming Tetrahedral Meshes of Multimaterial Domains with Bounded Quality". Proceedings of the 21st International Meshing Roundtable (San Jose, CA, Oct 7-10, 2012).<br>
  
  
 
<!-- ---------------------------- -->
 
<!-- ---------------------------- -->
 
{{documentation/{{documentation/version}}/module-section|Information for Developers}}
 
{{documentation/{{documentation/version}}/module-section|Information for Developers}}
−
For technical questions or problems, please use contacts in the introduction. <br><br>
+
For technical questions or problems, please use contacts in the introduction. <br>
−
{{documentation/{{documentation/version}}/module-developerinfo}}
 
  
 
<!-- ---------------------------- -->
 
<!-- ---------------------------- -->

Revision as of 20:07, 17 June 2014

Home < Documentation < 4.3 < Extensions < CleaverExtension


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



Introduction and Acknowledgements


Extension: CleaverExtension

Cleaver - A MultiMaterial Tetrahedral Meshing Library and Application


Acknowledgments:

Cleaver is an Open Source software project that is principally funded through the SCI Institute's NIH/NIGMS CIBC Center. Please use the following acknowledgment and send us references to any publications, presentations, or successful funding applications that make use of NIH/NIGMS CIBC software or data sets.
"This project was supported by the National Institute of General Medical Sciences of the National Institutes of Health under grant number P41GM103545."

Developed at the SCI Institute, University of Utah.

Project Webpage

Author: Jonathan Bronson
Contributor1: Josh Levine (Co-Author)
Contributor2: Ross Whitaker (Co-Author)
Contributor3: Brig Bagley (Developer)

Contact1: Jonathan Bronson, <email>bronson@sci.utah.edu</email>
Contact2: Brig Bagley, <email>brig@sci.utah.edu</email>

SCI Institute
Cleaver - CIBC
University of Utah

Module Description

CleaverExtension is a Slicer CLI Module that takes a set of NRRD Volumes and creates a set of tetrahedral meshes to import into the Slicer MRML.

Based on the "Lattice Cleaving" algorithm (see References), this method is theoretically guaranteed to produce valid meshes with bounded dihedral angles, while still conforming to multimaterial material surfaces. Empirically these bounds have been shown to be significant.

Use Cases

Input Frog image slices
Frog Surface

Panels and their use

Module UI
  • Input Volume 1-8 : Import up to 8 different volumes (NRRD) of the same dimension for Cleaver to mesh.
  • Output Model1-10 : Create up to 10 new models for Cleaver to write mesh data to. If none or too few are specified for the output, the console will provide the locations of the VTK mesh files and MRML scene file to load.
  • Use Padding : Often a good option to allow if material transitions exist at the volume boundaries.
  • Alpha Short : The minimum distance on an edge cut after which Cleaver does not warp a vertex.
  • Alpha Long : The maximum distance on an edge cut after which Cleaver will create a sub-tetrahedron (Cleave the current tet).
  • Verbose : Whether the console is to output detailed information on the cleaving steps.
  • Output format:
    • VTKtet : The default option that creates VTK mesh files with the output volume tets.
    • VTKfac : These VTK files define meshes that signify transitions between materials.
    • tetgen : This output can be read into the TetGen Program.
    • scirun : This output can be read into SCI's SciRun program.
    • matlab : This output can be read into MATLAB.
  • Restore Defaults : Restores the default options.
  • AutoRun : Runs the program automatically when a change is made (does not work with CleaverExtension).
  • Apply : Runs the CLI with the above options within Slicer. See output in the console.
  • Cancel : Stop the current process.

Tutorials

  • Both volumes and models are provided and created, respectively. When running in VTKtet output mode, the tet models are automatically loaded into Slicer.
Example2

  • Volumes are imported, then the program is run in VTKtet output mode. The output MRML is then loaded and clipped.
Example3

  • Volumes are imported, then the program is run in VTKfac output mode. The output MRML is then loaded and clipped.
Example4

  • An illustration of noting the output files of CleaverExtension when no models are provided. These can then be loaded into Slicer manually.
Example1

References

  • Bronson J., Levine, J., Whitaker R., "Lattice Cleaving: Conforming Tetrahedral Meshes of Multimaterial Domains with Bounded Quality". Proceedings of the 21st International Meshing Roundtable (San Jose, CA, Oct 7-10, 2012).


Information for Developers

For technical questions or problems, please use contacts in the introduction.

Retrieved from "https://www.slicer.org/w/index.php?title=Documentation/4.3/Extensions/CleaverExtension&oldid=38210"