Modules:IA FEMesh-Documentation-3.6

Return to Slicer 3.6 Documentation

Gallery of New Features

IA_FEMesh

IA-FEMesh

User Interface

Output

Caption

General Information

Module Type & Category

Type: Interactive

Category: Wizard

Authors, Collaborators & Contact

• Nicole Grosland: The University of Iowa - Affiliation & logo, if desired
• Vincent Magnotta: The University of Iowa - Affiliation & logo, if desired
• Kiran Shivanna: The University of Iowa - Affiliation & logo, if desired
• Steve Pieper: Isomics - Affiliation & logo, if desired
• Curt Lisle: KnowledgeViz
• Contact: Nicole Grosland (grosland@engineering.uiowa.edu) or Vincent Magnotta (vincent-magnotta@uiowa.edu)

Module Description

This module allows the creation and editing of volumetric meshes. Polygonal surfaces in VTK or STL format are imported to begin the process. Then a unique and intuitive bounding surface (called Building Blocks) are created interactively by the user and used to guide automated meshing algorithms. The module includes visualization and analysis reports of the quality of mesh elements. Meshes can be written out in Abaqus or VTK format for later processing.

Usage

Use Cases, Examples

The user interface for IA_FEMesh is organized as a set of tabs, with each tab corresponding to a group of related activities. Often the user will move back and forth between the tabs during the meshing process. The tabs organize related operations yet allow free movement, depending on the users needs. The tabs and associated operations are listed below:

• Surface: This tab allows input and saving of surface files used to define the object which will be meshed.
• Building Block: After a 3D object surface is input, the user interactively creates, modifies, and views a control surface used to guide meshing algorithms. Under this tab, operations for editing, copying, deleting, and splitting building blocks provide the tools for rapid building block creation. The operations can be applied to all or a selected subset of building blocks.
• Mesh Creation:This tab contains the algorithms for projecting points along the building block walls down onto the selected surface mesh. A solid mesh is created using transfinite or elliptical interploation.
• Mesh Quality: After a mesh is created, tools inside this tab allow for interactive viewing, exploration, and mesh improvement algorithms to be run if desired.
• Material Properties: Meshes are composed of multiple surface and/or volume elements. Individual elements or groups of elements are selected and given material properties with the tools inside this tab. Material properties stay with the mesh and are output when the mesh is saved as an external file.
• Boundary Conditions: Multi-step boundary conditions, including external forces, can be defined by the GUI tools defined under this tab. A user can create an Abaqus input file and visually preview if conditions have been specified correctly before beginning an external finite element simulation.

Tutorials

Links to tutorials explaining how to use this module:

• Meshing Tutorial
  • Tutorial Data Set
• Users Guide

Quick Tour of Features and Use

A list panels in the interface, their features, what they mean, and how to use them. For instance:

Input panel: First input Second input Parameters panel: First parameter Second parameter Output panel: First output Second output Viewing panel:

User Interface

Development

Notes from the Developer(s)

Algorithms used, library classes depended upon, use cases, etc.

Dependencies

• ITK
• VTK
• KWWidgets

Tests

On the Dashboard, these tests verify that the module is working on various platforms:

• MimxitkImageToVtkUnstructuredGridTest itkImageToVtkUnstructuredGridTest.cxx
• MimxAddUnstructuredHexahedronGridCellTest MainAddUnstructuredHexahedronGridCellTest.cxx
• MimxDeleteUnstructuredHexahedronGridCellTest MainDeleteUnstructuredHexahedronGridCellTest.cxx
• MimxSplitUnstructuredHexahedronGridCellTest MainSplitUnstructuredHexahedronGridCellTest.cxx
• MimxMirrorUnstructuredHexahedronGridCellTest MainMirrorUnstructuredHexahedronGridCellTest.cxx
• MimxBoundingBoxFromUnstructuredGridTest MainBoundingBoxFromUnstructuredGridTest.cxx
• MimxEquivalancePointsTest MainEquivalancePointsTest.cxx
• MimxExtractSurfaceTest MainExtractSurfaceTest.cxx
• MimxBoundingBoxFromBoundsTest MainBoundingBoxFromBoundsTest.cxx
• MimxExtractStructuredGridEdgeTest MainExtractStructuredGridEdgeTest.cxx
• MimxExtractStructuredGridFaceTest MainExtractStructuredGridFaceTest.cxx
• MimxGeometryFilterTest MainGeometryFilterTest.cxx
• MimxBoundingBoxToStructuredGridsTest MainBoundingBoxToStructuredGridsTest.cxx
• MimxMorphStructuredGridTest MainMorphStructuredGridTest.cxx
• MimxUnstructuredToStructuredGridTest MainUnstructuredToStructuredGridTest.cxx
• MimxMergePointsTest MainMergePointsTest.cxx
• MimxRecalculateInteriorNodesTest MainRecalculateInteriorNodesTest.cxx

Known bugs

Links to known bugs in the Slicer3 bug tracker

• Bug 000: description

Usability issues

Follow this link to the Slicer3 bug tracker. Please select the usability issue category when browsing or contributing.

Source code & documentation

Links to the module's source code:

Source code:

• file.cxx
• file.h

Doxygen documentation:

• class1

More Information

Acknowledgment

This work is supported in part by NIH/NIBIB awards R01EB005973 and R21

References

1. Tadepalli SC, Shivanna KH, Magnotta VA, Kallemeyn NA, Grosland NM, Toward the development of virtual surgical tools to aid orthopaedic FE analyses EURASIP Journal on Advances in Signal Processing, 2009, vol. 2010.
2. Devries NA, Shivanna KH, Tadepalli SC, Magnotta VA, Grosland NM. Ia-FEMesh: anatomic fe models--a check of mesh accuracy and validity. Iowa Orthop J. 29:48-54, 2009.
3. Kallemeyn NA, Tadepalli SC, Shivanna KH, Grosland NM. An interactive multiblock approach to meshing the spine. Comput Methods Programs Biomed. 95(3):227-35, 2009.
4. Grosland NM, Shivanna KH, Magnotta VA, Kallemeyn NA, DeVries NA, Tadepalli SC, Lisle C. IA-FEMesh: an open-source, interactive, multiblock approach to anatomic finite element model development. Comput Methods Programs Biomed. 94(1):96-107, 2009.
5. Ramme AJ, Devries N, Kallemyn NA, Magnotta VA, Grosland NM. Semi-automated Phalanx Bone Segmentation Using the Expectation Maximization Algorithm. J Digit Imaging. 2008.
6. Grosland NM, Bafna R, Magnotta VA. Automated hexahedral meshing of anatomic structures using deformable registration. Comput Methods Biomech Biomed Engin. 12(1):35-43, 2009.
7. DeVries NA, Gassman EE, Kallemeyn NA, Shivanna KH, Magnotta VA, Grosland NM. Validation of phalanx bone three-dimensional surface segmentation from computed tomography images using laser scanning. Skeletal Radiol. 37(1):35-42, 2008.
8. Gassman EE, Powell SM, Kallemeyn NA, Devries NA, Shivanna KH, Magnotta VA, Ramme AJ, Adams BD, Grosland NM. Automated bony region identification using artificial neural networks: reliability and validation measurements. Skeletal Radiol. 37(4):313-9, 2008.
9. Magnotta V, Li W, Grosland N. Comparison of Displacement-Based and Force-Based Mapped Meshing. Workshop on Computational Biomechanics for Medicine at MICCAI 2008. Insight Journal, http://hdl.handle.net/10380/1490 , 2008.
10. Shivanna K, Kallemeyn N, Tadepalli S, DeVries N, Magnotta V, Grosland N. Ia-FeMesh: An Interactive All Hexahedral Mesh Generator For Discrete Anatomic Closed Surfaces. Proceedings of the 2008 Summer Bioengineering Conference, 2008.
11. Grosland NM, Lisle C, Shivanna KH, Pieper S, Magnotta VA. A Check Of Mesh Quality, American Society Of Biomechanics, August 22-27, 2007.
12. Pébay PP, Thompson D, Shepherd J, Knupp P, Lisle C, Magnotta VA, Grosland NM. New Applications of the Verdict Library for Standardized Mesh Verification Pre, Post, and End-to-End Processing, Proceedings of the 16th International Meshing Roundtable, 2007.
13. Shivanna KH, Adams BD, Magnotta VA, Grosland NM. Towards Automating Patient-Specific Finite Element Model Development. Proceedings Computational Biomechanics For Medicine, 2006.