Modules:GrayscaleModelMaker-Documentation-3.6

From Slicer Wiki
Jump to: navigation, search
Home < Modules:GrayscaleModelMaker-Documentation-3.6

Return to Slicer 3.6 Documentation


Module Name

Grayscale Model Maker

CT Study, Skin. Threshold=-300 Hounsfield
CT Study, Bone. Threshold=200 Hounsfield

General Information

Module Type & Category

Type: CLI

Category: Surface Models

Authors, Collaborators & Contact

  • Authors: Bill Lorensen, Nicole Aucoin
  • Contact: bill.lorensen at gmail.com

Module Description

Program title Grayscale Model Maker
Program description

Create 3D surface models from grayscale data. This module uses Marching Cubes to create an isosurface at a given threshold. The resulting surface consists of triangles that separate a volume into regions below and above the threshold. The resulting surface can be smoothed and decimated. This module works on continuous data while the module Model Maker works on labeled (or discrete) data.


Program version 3.0
Program documentation-url http://www.slicer.org/slicerWiki/index.php/Modules:GrayscaleModelMaker-Documentation-3.6

Usage

Use Cases, Examples

This module is especially appropriate for these use cases:

  • Use Case 1: when have a continuous data set as input (ie grey scale volume)

Examples of the module in use:

  • Example 1: to create a model of the skin or bone from a volume
  • Example 2

Tutorials

  • Tutorial 1
    • Data Set 1

Quick Tour of Features and Use

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

  • IO
    • Input Volume : Volume containing the input grayscale data.
    • Output Geometry : Output that contains geometry model.


  • Grayscale Model Maker Parameters
    • Threshold [----threshold] [--t]: Grayscale threshold of isosurface. The resulting surface of triangles separates the volume into voxels that lie above (inside) and below (outside) the threshold. Default value: 100.0
    • Model Name [----name] [--n]: Name to use for this model. Default value: Model
    • Smooth [----smooth] : Number of smoothing iterations. If 0, no smoothing will be done. Default value: 15
    • Decimate [----decimate] : Target reduction during decimation, as a decimal percentage reduction in the number of polygons. If 0, no decimation will be done. Default value: 0.25
    • Split Normals? [----splitnormals] : Splitting normals is useful for visualizing sharp features. However it creates holes in surfaces which affect measurements Default value: true
    • Compute Point Normals? [----pointnormals] : Calculate the point normals? Calculated point normals make the surface appear smooth. Without point normals, the surface will appear faceted. Default value: true


User Interface


Development

Source code & documentation

Source Code: GrayscaleModelMaker.cxx

XML Description: GrayscaleModelMaker.xml

Test: GrayscaleModelMakerTest.cxx

More Information

Acknowledgment

This work is part of the National Alliance for Medical Image Computing (NAMIC), funded by the National Institutes of Health through the NIH Roadmap for Medical Research, Grant U54 EB005149. Information on the National Centers for Biomedical Computing can be obtained from National Centers for Biomedical Computing.

References

Model smoothing is done using the windowed sinc algorithm: http://www.vtk.org/doc/nightly/html/classvtkWindowedSincPolyDataFilter.html#details