Differences between revisions 48 and 49
Revision 48 as of 2016-05-11 16:03:26
Size: 20498
Editor: aerdemir
Comment:
Revision 49 as of 2018-05-18 18:13:59
Size: 16082
Comment:
Deletions are marked like this. Additions are marked like this.
Line 31: Line 31:
 * Volume of tissue of interest as a binary image aligned with original MRI coordinate system (raw, without filtering and smoothing)
Line 34: Line 33:
== Procedures ==

-- [[aerdemir]] <<DateTime(2013-12-30T15:14:36Z)>> This section may list general purpose procedures and alternatives to utilize the same input to reach the same output. Procedures optimized for specific tissues should also be provided in here.

=== When starting with volume representation ===

 * Confirm the tissue volume is a raw representation (without filtering and smoothing)
 * Generate raw surface representation of the tissue volume
  * Upload tissue volume in image segmentation software, e.g. Slicer.
  * Generate water-tight triangulated surface representation (no filtering, smoothing).
  * Save raw surface representation with the same file name as the volume representation except with the .stl extension.
 * Continue with the next section.

=== When starting with surface representation ===

 * Load raw surface representation of the tissue volume in !MeshLab.
 * Smooth raw surface representation, e.g.:
  * Under Filters->Smoothing->Laplacian Smooth, Select smoothing steps of 9 and uncheck all other boxes and apply. This will smooth down most jagged edges from the original file
  * Under Filters->Smoothing->Two Step Smooth, Select smoothing steps of 3, Feature Angle Threashold at 60, Normal smoothing steps at 20, and Vertex Fitting steps at 20 and apply. This step further levels uneven edges
  * Under Filters->Smoothing->Taubin Smooth, Select Lambda to 1, mu to 0.0, and Smoothing steps to 12, all boxes are unchecked and press apply. This step creates an overall uniform surface with few rough edges, while still keeping the shape of the initial object. Some values may vary depending on the model input, this selection works for large bones like the femur.
 * Parametrize and resample smoothed surface representation.
 * Save smooth surface representation with the same file name as the volume representation except with trailing text of 'smooth'.

=== When parametric geometry is needed ===


----

=== Slicer Procedures ===

==== Generate Triangulated Surface (STL) with Laplacian Smoothing ====

 * From the Modules drop-down menu, select 'Surface Models' -> 'Model Maker'
  * Under 'IO' tab, from 'Input Volume' drop-down menu, select desired Label Map
  * In Model drop-down menu, either 'Create and rename new Hierarchy' (e.g. default 'Models'), or select an existing Model Hierarchy.
   NOTE: all models can be generated under the same or separate model hierarchies
  * Under 'Create Model' tab, specify a desired 'Model Name' for the select Label Map.
  * If no smoothing is desired, under 'Model Maker Parameters', set 'Smooth' to zero.
  * If no decimation is desired (nodes at every voxel corner), under 'Model Maker Parameters', set 'Decimate' to zero.
  * Click Apply button.

----

=== MeshLab Procedures ===

==== Input/Output ====

IMPORT STL:
== Overview ==

 1. Load the desired STL into Meshlab
 2. Perform smoothing procedures on the STL using the component specific procedures described below.
  * Save the STL regularly to avoid losing previous work through program crashes.
 3. Perform Paired Mesh distance maping between the RAW and processepd STLs to ensure that there have been no major changes to the mesh.
 4. Check and Repair the STL as needed
 5. Export the STL. This is now considered to be an explicit surface representation of the tissue of interest processed with volume preserving smoothing.
 6. Repeat this process for all components.

== Data Input Procedures ==

IMPORT STL to MeshLab:
Line 83: Line 47:
 1. Select desired STL file(s) (multiple contiguous by holding 'Shift', multiple non-contiguous by holding 'Ctrl').
 1. Click 'Import STL'.

EXPORT STL:
 1. Select desired mesh to export from the Layer hierarchy (display by selecting 'stack of planes' icon above 3D viewport).
 1. File -> 'Export Mesh As...'.
 1. Name file as desired, with the '.stl' extension.
 1. Click 'Save'

==== Remeshing, Simplification and Reconstruction ====

===== Surface Reconstruction: VCG =====

 1. Select desired mesh from the Layer hierarchy panel.
 2. Select desired STL file(s) (multiple contiguous by holding 'Shift', multiple non-contiguous by holding 'Ctrl').
 3. Click 'Import STL'.

== Data Output Procedures ==

Note: There is no “undo” in MeshLab, and the program crashes often. It is recommended to export the stl after every successful step in the process, to avoid having to repeat steps later!

EXPORT STL from Meshlab
 1. Select desired mesh to export from the Layer Dialog panel (see viewing options for directions to display the layer dialog)
 2. File -> 'Export Mesh As...'.
 3. Name file as desired, with the '.stl' extension.
 4. Click 'Save'


== Viewing Options ==

 * Select the 'Show Layer Dialog' option.
{{attachment:layer_dialog.png}}
  * During the smoothing process, the layer dialog panel shows the progress, and allows the viewer to select, display, or hide different versions of the mesh. Select the eye toggle next to the mesh name to hide or display it. The body highlighted in yellow is the “current mesh”. Any procedures performed will be applied to the current mesh.
{{attachment:layer_dialog_2.png}}
 * Select the 'Flat Lines' option to view the mesh lines on the model surface.
{{attachment:flat_lines.png}}

== General Procedures ==

=== Smoothing Procedures (LVTIT) ===
The protocols for using various smoothing features in MeshLab are described here. Component specific procedures section, below, provides guidelines for which smoothing parameters to use for each tissue type.

==== Laplacian Smoothing [L] ====

 1. Select desired mesh from the Layer Dialog panel.
 1. Filters > 'Smoothing, Fairing and Deformation' > 'Laplacian Smooth'
 1. Set smoothing steps to 20 (or other value as per Component-Specific Procedures)
 1. Click Apply
 1. Save your work!

==== Surface Reconstruction: VCG [v] ====

 1. Select desired mesh from the Layer Dialog panel.
Line 101: Line 90:
1. Save your work!
Line 110: Line 100:
===== Iso Parameterization =====

 1. Select desired mesh from the Layer pane.
==== Taubin Smoothing [T] ====

 1. Select desired mesh from the Layer Dialog panel.
 1. Filters -> 'Smoothing, Fairing and Deformation' -> 'Taubin Smoothing'
 1. Select 'Preview' to interactively display current smoothing parameters.
 1. Click 'Apply'.

USEFUL FOR:
 * Smoothing vertices/nodes at sharply curved model edges.
 * Correcting twisted triangles at focal points following 'Iso Parameterization'.

NOTES:
 * Suggested settings: Lambda = 0.5, mu = -0.5
 * Lambda values > 1.5 cause the mesh to jaggedly explode.

==== Iso Parameterization [I] ====
There are 2 stages to Iso Parameterization:

===== Stage 1: Iso Parameterization =====

 1. Select desired mesh from the Layer Dialog panel.
Line 125: Line 133:
===== Iso Parameterization Remeshing ===== ===== Stage 2: Iso Parameterization Remeshing =====
Line 132: Line 140:
==== Smoothing ====

===== Taubin Smoothing =====

 1. Filters -> 'Smoothing, Fairing and Deformation' -> 'Taubin Smoothing'
 1. Select 'Preview' to interactively display current smoothing parameters.
 1. Click 'Apply'.

USEFUL FOR:
 * Smoothing vertices/nodes at sharply curved model edges.
 * Correcting twisted triangles at focal points following 'Iso Parameterization'.

NOTES:
 * Suggested settings: Lambda = 0.5, mu = -0.5
 * Lambda values > 1.5 cause the mesh to jaggedly explode.

==== Paired Mesh Distance Mapping (Hausdorff distance) ====
=== Paired Mesh Distance Mapping (Hausdorff distance) ===
Line 166: Line 158:
----

=== Blender Procedures ===

==== Input/Output ====

IMPORT STL:
 1. File -> Import -> 'Stl (.stl)'.
 1. Select desired STL file(s) (multiple contiguous by holding 'Shift', multiple non-contiguous by holding 'Ctrl').
 1. Click 'Import STL'.

EXPORT STL:
 1. Select the desired mesh to export from the hierarchical Outliner editor pane (default: upper right).
 1. File -> Export -> 'Stl (.stl)'
 1. Specify a desired folder and filename (extension: .stl).
 1. Click 'Export STL'.

==== Useful Shortcuts ====

 * 'n': show 3D Viewport Panel Options
 * 'Tab': switch between 'Object Mode' (default) and 'Edit Mode'
 * 'p' (-> : split selected surface mesh triangles into two complementary sets
 * 'a': toggle, select all/none
 * 'c': 'Circle Select'
  * Left-click: select
  * Middle mouse button, scroll wheel (click): deselect
  * Middle mouse button, scroll wheel (scroll): change size of circular selection area
 * 'Esc': cancel current active tool

==== 3D Viewport Interaction ====

 * Left mouse button:
  * ['Object Mode']: position cursor
  * ['Edit Mode']: select specified sub-geometry (node/edge/face)
   * IF TOOL IS ACTIVE: apply active tool
   * ('Ctrl'+_): lasso select
   * ('Ctrl'+'Shift'+_): lasso deselect
 * Middle mouse button, scroll wheel (click): rotate 3D view
  * ('Ctrl'+_) zoom in/out (continuous)
  * ('Shift'+_) pan
 * Middle mouse button, scroll wheel (scroll): zoom in/out (discrete steps)
 * Right mouse button:
  * [Object Mode]: select object
  * [Edit Mode]: activate/deactivate tool (default tool: translate selection)

==== Triangulated surface mesh (STL) splitting ====

In order to determine tissue thickness for thin structures (e.g. cartilage, ligament, tendon) using !MeshLab, the manifold (water-tight) triangulated surface mesh must be split into to non-manifold, complementary shells. The procedure to do this is as follows:

 1. Import desired STL(s).
 1. Ensure you are in 'Object Mode' (shown in drop-down menu underneath the 3D Viewport).
 1. Selected the desired STL with one of the following options:
  1. In the 'Outliner' panel (default: upper right), showing the scene graph and datablocks hierarchy, left-click the desired STL.
  1. In the 3D View, right-click on the desired STL interactively.
 1. Hit 'Tab' to change to 'Edit Mode'.
 1. Make sure 'Face Select' mode is selected:
  * in the 3D Viewport menu (underneath), left-click the icon showing a cube with one orange face (in a group of three icons, in the ).
 1. Press 'a' to deselect all faces (automatically selected by default when entering 'Edit Mode').
 1. SELECT DESIRED SET OF CONTIGUOUS TRIANGLES:
  * Right-click a single triangular face on the desired side of the thin model component.
  * In 3D Viewport menu -> Select -> 'Linked Flat Faces':
  * Adjust Sharpness (angle: degrees) until the desired set of contiguous triangular faces are obtained (determine the max. angle that includes the largest region of one side of the thin structure, without spilling over onto the opposite face of the structure).
  * MODIFY SELECTION, IF NEEDED:
   1. Add/select 'holes' (unselected triangles) in contiguously selected region: use 'Circle Select' or 'Lasso Select'
   1. Tidy boundary of select contiguous triangles: use 'Circle Select'
 1. PARTITION STL MESH:
  * Press 'p' ('Separate').
  * From Pop-up menu -> 'Selection P'

----

=== General Procedures ===

==== General Procedure: NO Smoothing (RAW) ====

 1. '''Slicer:'''
  1. Load desired segmented label map/image volume.
  1. Generate triangulated surface (STL) from desired component using (Smooth = 0, Decimate = 0, 'Post Merge Simplification').
  1. Save STL to file using naming convention ([[Specifications/DataManagement]]).

==== General Procedure: Smoothing (LVTIT) ====

 1. '''Slicer:'''
  1. Load desired segmented label map/image volume.
  1. Generate triangulated surface (STL) from desired component using 'Laplacian Smoothing' [L] (Smooth = 20, Decimate = 0, 'Post Merge Simplification'), to provide maximum mesh volume prior to following processing steps, which tend to shrink the volume.
  1. Save STL to file using naming convention ([[Specifications/DataManagement]]).
 1. '''Meshlab:'''
  1. Load STL generated in prior step.
  1. Perform 'Surface Reconstruction: VCG' [V] ('Voxel Side'(world unit) = 0.35-0.7, for cartilage MRI, resolution = 0.35 x 0.35 x 0.7 mm), to smooth out step-i-ness of mesh.
  1. Perform 'Taubin Smoothing' [T] (Lambda = 0.5, mu = -0.53), to make discretized triangules more uniform in areas of high curvature or triangle node density.
  1. Perform 'Iso Parametrization' [I].
  1. Perform 'Iso Parametrization Remeshing' (Sampling rate = 3-20).
  1. Perform 'Taubin Smoothing' [T] (Lambda = 0.5, mu = -0.53), to untwist potentially collapsed triangles at focal points from iso parametrization.

----

=== Component-Specific Procedures ===

==== Registration Markers ====

'General Procedure: NO Smoothing' (RAW):

 1. Slicer: Smooth = 0, Decimate = 0, 'Post Merge Simplification'

==== Bones ====
=== Checking and Repairing the STL ===
After performing the smoothing procedures, it must be checked that the STL is manifold and watertight.

==== Repair Boundary and Non-Manifold Edges: ====
 1. Select Render > Show Non Manif Edges
 1. Select Render> Show Boundary Edges
  * Boxes will pop up showing how many of each of these items exist, and they will be highlighted on the mesh. If these numbers are all zero, skip to check for non manifold edges. If the numbers are non-zero, but you cannot see the highlighted regions on the mesh, select Filters>Selection>Dilate Selection, to help the regions stand out more.
 1. For each of the highlighted regions:
  * Use ‘select faces in rectangular region’ tool and select all the faces touching the highlighted region.
   * IMPORTANT! Press alt while using the selection tool so that it will only select the faces on the top layer.
   * Press shift to deselect using the tool
  * Select 'Delete current set of selected faces and vertices' Ignore holes for now.
 1. Select Render > Show Non Manif Vertices.
  * A box will pop up showing how many non manifold vertices exist, at this point they should be orphan nodes. If this number is zero, skip to close holes.
 1. Select Filters > Cleaning and Repairing > Remove unreferenced vertex
 1. Select Filters>Remeshing, Simplification, and Reconstruction > Close Holes. Leave default options and click Apply.
 1. Save changes.

==== Check Directions of Surface Normals: ====

 1. Select Render > Show Face Normals . This will draw a line from the center of all the faces in the direction of the normal. The 3D meshing process will work better if the surface normals all point outward.
 1. Select Filter > Normals, Curvatures, and Orientation > Re-Orient all faces coherently


== Component-Specific Procedures ==

=== Registration Markers ===

NO Smoothing. Keep the STL in the RAW format

=== Bones ===
Line 274: Line 192:
 1. [L]aplacian Smoothing: Smooth = 20, Decimate = 0, 'Post Merge Simplification'  1. [L]aplacian Smoothing: Smoothing steps = 20
Line 285: Line 203:
 1. [L]aplacian Smoothing: Smooth = 20, Decimate = 0, 'Post Merge Simplification'  1. [L]aplacian Smoothing: Smoothing steps = 20
Line 295: Line 213:
 1. [L]aplacian Smoothing: Smooth = 20, Decimate = 0, 'Post Merge Simplification'  1. [L]aplacian Smoothing: Smoothing steps = 20
Line 303: Line 221:
==== Cartilage ==== === Cartilage ===
Line 307: Line 225:
 1. [L]aplacian Smoothing: Smooth = 20, Decimate = 0, 'Post Merge Simplification'  1. [L]aplacian Smoothing: Smoothing steps = 20
Line 319: Line 237:
 1. [L]aplacian Smoothing: Smooth = 20, Decimate = 0, 'Post Merge Simplification'  1. [L]aplacian Smoothing: Smoothing steps = 20
Line 330: Line 248:
 1. [L]aplacian Smoothing: Smooth = 20, Decimate = 0, 'Post Merge Simplification'  1. [L]aplacian Smoothing: Smoothing steps = 20
Line 338: Line 256:
==== Menisci ==== === Menisci ===
Line 342: Line 260:
 1. [L]aplacian Smoothing: Smooth = 20, Decimate = 0, 'Post Merge Simplification'  1. [L]aplacian Smoothing: Smoothing steps = 20
Line 351: Line 269:
==== Connective Tissue - Ligaments & Tendons ==== === Connective Tissue - Ligaments & Tendons ===
Line 355: Line 273:
 1. [L]aplacian Smoothing: Smooth = 20, Decimate = 0, 'Post Merge Simplification'  1. [L]aplacian Smoothing: Smoothing steps = 20
Line 366: Line 284:
 1. [L]aplacian Smoothing: Smooth = 20, Decimate = 0, 'Post Merge Simplification'  1. [L]aplacian Smoothing: Smoothing steps = 20
Line 376: Line 294:
 1. [L]aplacian Smoothing: Smooth = 20, Decimate = 0, 'Post Merge Simplification'  1. [L]aplacian Smoothing: Smoothing steps = 20
Line 386: Line 304:
 1. [L]aplacian Smoothing: Smooth = 20, Decimate = 0, 'Post Merge Simplification'  1. [L]aplacian Smoothing: Smoothing steps = 20
Line 395: Line 313:
 1. [L]aplacian Smoothing: Smooth = 20, Decimate = 0, 'Post Merge Simplification'  1. [L]aplacian Smoothing: Smoothing steps = 20
Line 401: Line 319:
=== Sample Results === == Sample Results ==
Line 415: Line 333:

-- aerdemir 2016-04-14 17:10:26 This specification is asking for input from the community. Please provide your feedback

  • by editing the /Discussion page, or

  • by responding to relevant forum entry, or

  • by sending an e-mail to Ahmet Erdemir, <erdemira@ccf.org>.


Target Outcome

Geometric reconstruction of a tissue of interest ready for meshing:

  • as a (parametric or explicit) watertight surface representation, or
  • as a solid geometry

Prerequisites

Infrastructure

  • SALOME. SALOME is an open-source software that provides a generic platform for pre- (cad, meshing) and post-processing for numerical simulation (LGPL license, see http://www.salome-platform.org/).

  • FreeCAD. FreeCAD is an open-source three-dimensional computer aided design software (GPL and LGPL licenses, see http://www.freecadweb.org/).

  • MeshLab. MeshLab is an open-source, portable, and extensible system for the processing and editing of unstructured 3D triangular meshes (GPL license, see http://meshlab.sourceforge.net/).

  • OpenFlipper. OpenFlipper is an open-source, multi-platform application and programming framework designed for processing, modeling and rendering of geometric data (LGPL license, see http://www.openflipper.org/).

  • PyGTS. PyGTS is a Python binding for the GNU Triangulated Surface (GTS) Library to construct, manipulate, and perform computations on 3D triangulated surfaces, including boolean operations (GPL license, see http://pygts.sourceforge.net/).

  • pyFormex. pyFormex provides a wide range of operations on surface meshes, such as STLs; the software can also be used as a pre- and post-processor for Finite Element analysis programs (GPL license, see http://www.nongnu.org/pyformex).

  • IA-FEMesh. IA-FEMesh is freely available, interactive, structured hexahedral mesh generation software relying on surface projection method (BSD style license, see http://www.ccad.uiowa.edu/MIMX/projects/IA-FEMesh).

  • Blender. Blender is the free and open source 3D creation suite, which supports the entirety of the 3D pipeline, including: modeling, rigging, animation, simulation, rendering, compositing, motion tracking, video editing, and game creation. (GPL license, see https://www.blender.org/).

Previous Protocols

For more details, see Specifications/ImageSegmentation.


Protocols

Input

  • Surface representation of tissue of interest in STL format in MRI coordinate system (raw, without filtering and smoothing)

Overview

  1. Load the desired STL into Meshlab
  2. Perform smoothing procedures on the STL using the component specific procedures described below.
    • Save the STL regularly to avoid losing previous work through program crashes.
  3. Perform Paired Mesh distance maping between the RAW and processepd STLs to ensure that there have been no major changes to the mesh.
  4. Check and Repair the STL as needed
  5. Export the STL. This is now considered to be an explicit surface representation of the tissue of interest processed with volume preserving smoothing.
  6. Repeat this process for all components.

Data Input Procedures

IMPORT STL to MeshLab:

  1. File -> 'Import Mesh...'

  2. Select desired STL file(s) (multiple contiguous by holding 'Shift', multiple non-contiguous by holding 'Ctrl').
  3. Click 'Import STL'.

Data Output Procedures

Note: There is no “undo” in MeshLab, and the program crashes often. It is recommended to export the stl after every successful step in the process, to avoid having to repeat steps later!

EXPORT STL from Meshlab

  1. Select desired mesh to export from the Layer Dialog panel (see viewing options for directions to display the layer dialog)
  2. File -> 'Export Mesh As...'.

  3. Name file as desired, with the '.stl' extension.
  4. Click 'Save'

Viewing Options

  • Select the 'Show Layer Dialog' option.

layer_dialog.png

  • During the smoothing process, the layer dialog panel shows the progress, and allows the viewer to select, display, or hide different versions of the mesh. Select the eye toggle next to the mesh name to hide or display it. The body highlighted in yellow is the “current mesh”. Any procedures performed will be applied to the current mesh.

layer_dialog_2.png

  • Select the 'Flat Lines' option to view the mesh lines on the model surface.

flat_lines.png

General Procedures

Smoothing Procedures (LVTIT)

The protocols for using various smoothing features in MeshLab are described here. Component specific procedures section, below, provides guidelines for which smoothing parameters to use for each tissue type.

Laplacian Smoothing [L]

  1. Select desired mesh from the Layer Dialog panel.
  2. Filters > 'Smoothing, Fairing and Deformation' > 'Laplacian Smooth'

  3. Set smoothing steps to 20 (or other value as per Component-Specific Procedures)
  4. Click Apply
  5. Save your work!

Surface Reconstruction: VCG [v]

  1. Select desired mesh from the Layer Dialog panel.
  2. Filters -> 'Remeshing, Simplification and Reconstruction' -> 'Surface Reconstruction: VCG'

  3. Set 'Voxel Side', 'world unit' to a meaningful size (i.e. relative to original image resolution; e.g. for cartilage images with a resolution of 0.35 x 0.35 x 0.7 mm, use a world unit of 0.35, 0.5, 0.7 mm).
  4. Select 'Post Merge Simplification'.
  5. Click 'Apply'.

1. Save your work!

IF STL FRAGMENTS APPEAR AT MODEL EDGES AFTER RECONSTRUCTION:

  1. TODO: Describe selecting/deleting floating STL fragments!

NOTES:

  • Increasing 'Volume Laplacian iter' decreases resulting reconstructed volume.
  • Changing 'Widening' had no visual effect.

Taubin Smoothing [T]

  1. Select desired mesh from the Layer Dialog panel.
  2. Filters -> 'Smoothing, Fairing and Deformation' -> 'Taubin Smoothing'

  3. Select 'Preview' to interactively display current smoothing parameters.
  4. Click 'Apply'.

USEFUL FOR:

  • Smoothing vertices/nodes at sharply curved model edges.
  • Correcting twisted triangles at focal points following 'Iso Parameterization'.

NOTES:

  • Suggested settings: Lambda = 0.5, mu = -0.5
  • Lambda values > 1.5 cause the mesh to jaggedly explode.

Iso Parameterization [I]

There are 2 stages to Iso Parameterization:

Stage 1: Iso Parameterization
  1. Select desired mesh from the Layer Dialog panel.
  2. Filters -> 'Remeshing, Simplification and Reconstruction' -> 'Iso Parameterization'

  3. Click 'Apply.

IF DOUBLE STEP DOESN'T WORK:

  1. Deselect 'Double Step'.
  2. Click 'Apply.

WARNINGS:

  • This can be buggy, and may cause MeshLab to crash!

  • This appears not to be deterministic, i.e. with same input mesh it may or may not work (e.g. same VCG parameters to smooth prior to isoparameterization didn't work in one attempt, but did in another).

Stage 2: Iso Parameterization Remeshing
  1. Filters -> 'Remeshing, Simplification and Reconstruction' -> 'Iso Parameterization Remeshing'

  2. Try default 'Sampling Rate' = 10.
  3. Click 'Apply'.
  4. If needed, iterate last two steps, changing the 'Sampling Rate' until desired surface triangle size is obtained.

Paired Mesh Distance Mapping (Hausdorff distance)

  1. Import desired STL(s).

COMPUTE DISTANCE MAP:

  1. Filters -> Sampling -> Hausdorff Distance.

  2. Set the 'Sampled Mesh' to the desired reference surface (i.e. the surface that the colored distance map will be displayed on, mapped at vertices).
  3. Set the 'Target Mesh' to the surface used to determine the distance map (from the reference surface vertices).
  4. Click 'Apply'.

DISPLAY DISTANCE MAP:

  1. Make sure the desired reference map is selected in the Layer hierarchy.
  2. Display -> 'Show Vert Quality Histogram'.

  3. Filters -> 'Color Creation and Processing' -> 'Color by vertex Quality'.

  4. Set 'Min' to 0.
  5. Set 'Max' to an appropriate level (suggestion: aim for distance ~zero-count transition in histogram).
  6. Select 'Preview' to interactively display currently calculated distance map on the surface.
  7. Iterate last three steps until desired color-to-distance correspondence is determined.
  8. Click 'Apply'.

Checking and Repairing the STL

After performing the smoothing procedures, it must be checked that the STL is manifold and watertight.

Repair Boundary and Non-Manifold Edges:

  1. Select Render > Show Non Manif Edges

  2. Select Render> Show Boundary Edges

    • Boxes will pop up showing how many of each of these items exist, and they will be highlighted on the mesh. If these numbers are all zero, skip to check for non manifold edges. If the numbers are non-zero, but you cannot see the highlighted regions on the mesh, select Filters>Selection>Dilate Selection, to help the regions stand out more.

  3. For each of the highlighted regions:
    • Use ‘select faces in rectangular region’ tool and select all the faces touching the highlighted region.
      • IMPORTANT! Press alt while using the selection tool so that it will only select the faces on the top layer.
      • Press shift to deselect using the tool
    • Select 'Delete current set of selected faces and vertices' Ignore holes for now.
  4. Select Render > Show Non Manif Vertices.

    • A box will pop up showing how many non manifold vertices exist, at this point they should be orphan nodes. If this number is zero, skip to close holes.
  5. Select Filters > Cleaning and Repairing > Remove unreferenced vertex

  6. Select Filters>Remeshing, Simplification, and Reconstruction > Close Holes. Leave default options and click Apply.

  7. Save changes.

Check Directions of Surface Normals:

  1. Select Render > Show Face Normals . This will draw a line from the center of all the faces in the direction of the normal. The 3D meshing process will work better if the surface normals all point outward.

  2. Select Filter > Normals, Curvatures, and Orientation > Re-Orient all faces coherently

Component-Specific Procedures

Registration Markers

NO Smoothing. Keep the STL in the RAW format

Bones

'General Procedure: Smoothing' (LVTIT) parameters for femur (FMB), tibia (TBB):

  1. [L]aplacian Smoothing: Smoothing steps = 20
  2. [V]CG Surface Reconstruction: Voxel Side (world unit) = 0.7
  3. [T]aubin Smoothing: Lambda = 0.5, mu = -0.53 (defaults)
  4. [I]soParameterization: Sampling Rate = 10
  5. [T]aubin Smoothing: Lambda = 0.5, mu = -0.53 (defaults)

oks001_MRC_FMB_LVTIT_10.png oks001_MRC_TBB_LVTIT_10.png

'General Procedure: Smoothing' (LVTIT) parameters for patella (PTB):

  1. [L]aplacian Smoothing: Smoothing steps = 20
  2. [V]CG Surface Reconstruction: Voxel Side (world unit) = 0.5
  3. [T]aubin Smoothing: Lambda = 0.5, mu = -0.53 (defaults)
  4. [I]soParameterization: Sampling Rate = 7
  5. [T]aubin Smoothing: Lambda = 0.5, mu = -0.53 (defaults)

oks001_MRC_PTB_LVTIT_07.png

'General Procedure: Smoothing' (LVTIT) parameters for fibula (FBB):

  1. [L]aplacian Smoothing: Smoothing steps = 20
  2. [V]CG Surface Reconstruction: Voxel Side (world unit) = 0.5
  3. [T]aubin Smoothing: Lambda = 0.5, mu = -0.53 (defaults)
  4. [I]soParameterization: Sampling Rate = 5
  5. [T]aubin Smoothing: Lambda = 0.5, mu = -0.53 (defaults)

oks001_MRC_FBB_LVTIT_05.png

Cartilage

'General Procedure: Smoothing' (LVTIT) parameters for femoral cartilage (FMC):

  1. [L]aplacian Smoothing: Smoothing steps = 20
  2. [V]CG Surface Reconstruction: Voxel Side (world unit) = 0.35
  3. [T]aubin Smoothing: Lambda = 0.5, mu = -0.53 (defaults)
  4. [I]soParameterization: Sampling Rate = [10,15,20] (low density, mid density, high density)
  5. [T]aubin Smoothing: Lambda = 0.5, mu = -0.53 (defaults)

oks001_MRC_FMC_LVTIT_10.png oks001_MRC_FMC_LVTIT_15.png oks001_MRC_FMC_LVTIT_20.png

'General Procedure: Smoothing' (LVTIT) parameters for tibial cartilage (TBC-M, TBC-L):

  1. [L]aplacian Smoothing: Smoothing steps = 20
  2. [V]CG Surface Reconstruction: Voxel Side (world unit) = 0.35
  3. [T]aubin Smoothing: Lambda = 0.5, mu = -0.53 (defaults)
  4. [I]soParameterization: Sampling Rate = [7,10,13] (low density, mid density, high density)
  5. [T]aubin Smoothing: Lambda = 0.5, mu = -0.53 (defaults)

oks001_MRC_TBC-M_LVTIT_07.png oks001_MRC_TBC-L_LVTIT_07.png

'General Procedure: Smoothing' (LVTIT) parameters for patellar cartilage (PTC):

  1. [L]aplacian Smoothing: Smoothing steps = 20
  2. [V]CG Surface Reconstruction: Voxel Side (world unit) = 0.35
  3. [T]aubin Smoothing: Lambda = 0.5, mu = -0.53 (defaults)
  4. [I]soParameterization: Sampling Rate = [(6),8,10,(12)] (low density, mid density, high density)
  5. [T]aubin Smoothing: Lambda = 0.5, mu = -0.53 (defaults)

oks001_MRC_PTC_LVTIT_06.png

Menisci

Modified 'General Procedure: Smoothing' (LIT) parameters for mensici (MNS-M, MSN-L):

  1. [L]aplacian Smoothing: Smoothing steps = 20
  2. [I]soParameterization: Sampling Rate = [6,8,10] (low density, mid density, high density)
  3. [T]aubin Smoothing: Lambda = 0.5, mu = -0.53 (defaults)

NOTE: Modified General Procedure preserves volume better for thin, highly curved geometry, but doesn't smooth segmentation aliasing.

oks001_MRC_MNS-M_LIT_06.png oks001_MRC_MNS-L_LIT_06.png

Connective Tissue - Ligaments & Tendons

'General Procedure: Smoothing' (LVTIT) parameters for ACL, PCL:

  1. [L]aplacian Smoothing: Smoothing steps = 20
  2. [V]CG Surface Reconstruction: Voxel Side (world unit) = 0.35
  3. [T]aubin Smoothing: Lambda = 0.5, mu = -0.53 (defaults)
  4. [I]soParameterization: Sampling Rate = [3,4,5] (low density, mid density, high density)
  5. [T]aubin Smoothing: Lambda = 0.5, mu = -0.53 (defaults)

oks001_MRC_ACL_LVTIT_03.png oks001_MRC_PCL_LVTIT_03.png

'General Procedure: Smoothing' (LVTIT) parameters for patellar ligament (PTL):

  1. [L]aplacian Smoothing: Smoothing steps = 20
  2. [V]CG Surface Reconstruction: Voxel Side (world unit) = 0.35
  3. [T]aubin Smoothing: Lambda = 0.5, mu = -0.53 (defaults)
  4. [I]soParameterization: Sampling Rate = [6,8,10] (low density, mid density, high density)
  5. [T]aubin Smoothing: Lambda = 0.5, mu = -0.53 (defaults)

oks001_MRC_PTL_LVTIT_06.png

'General Procedure: Smoothing' (LVTIT) parameters for quadriceps tendon (QAT):

  1. [L]aplacian Smoothing: Smoothing steps = 20
  2. [V]CG Surface Reconstruction: Voxel Side (world unit) = 0.35
  3. [T]aubin Smoothing: Lambda = 0.5, mu = -0.53 (defaults)
  4. [I]soParameterization: Sampling Rate = [4,6,8] (low density, mid density, high density)
  5. [T]aubin Smoothing: Lambda = 0.5, mu = -0.53 (defaults)

oks001_MRC_QAT_LVTIT_04.png

Modified 'General Procedure: Smoothing' (LVIT) parameters for MCL:

  1. [L]aplacian Smoothing: Smoothing steps = 20
  2. [V]CG Surface Reconstruction: Voxel Side (world unit) = 0.35
  3. [I]soParameterization: Sampling Rate = [6,7,8] (low density, mid density, high density)
  4. [T]aubin Smoothing: Lambda = 0.5, mu = -0.53 (defaults)

oks001_MRC_MCL_LVIT_06.png

Modified 'General Procedure: Smoothing' (LIT) parameters for LCL:

  1. [L]aplacian Smoothing: Smoothing steps = 20
  2. [I]soParameterization: Sampling Rate = [3,4,5] (low density, mid density, high density)
  3. [T]aubin Smoothing: Lambda = 0.5, mu = -0.53 (defaults)

oks001_MRC_LCL_LIT_03.png

Sample Results

Following are images of the three-dimensional knee geometry (at ~90 degree increments) generated by using the coarsest triangulated surfaces.

oks001_3D_STL_coarse_1.png oks001_3D_STL_coarse_2.png oks001_3D_STL_coarse_3.png oks001_3D_STL_coarse_4.png

Output

  • Explicit surface representation of tissue of interest; in STL format in MRI coordinate system (processed with volume preserving smoothing)
  • Parametric surface representation of tissue of interest in IGES & STP format in MRI coordinate system (processed with volume preserving smoothing)

  • Parametric solid model of tissue of interest in IGES & STP format in MRI coordinate system (processed with volume preserving smoothing)

Specifications/GeometryGeneration (last edited 2020-10-13 13:59:46 by klonowe)