Modules:ModelMaker-Documentation-3.6 - Revision history

Nicole: /* Quick Tour of Features and Use */

2011-02-03T21:59:03Z

Quick Tour of Features and Use

Nicole: /* Model Maker */

2010-05-17T21:18:41Z

Model Maker

Nicole: /* Known bugs */

2010-05-17T20:53:59Z

Known bugs

Nicole: /* Quick Tour of Features and Use */

2010-05-17T20:52:47Z

Quick Tour of Features and Use

Nicole: /* Use Cases, Examples */

2010-05-17T20:43:02Z

Use Cases, Examples

Nicole at 20:35, 17 May 2010

2010-05-17T20:35:06Z

Nicole: /* Model Maker */

2010-05-17T20:30:30Z

Model Maker

Nicole: Created page with 'Return to Slicer 3.6 Documentation Gallery of New Features NOTOC ===Model Maker=== ModelMaker {| |[[Image:Mode…'

2010-03-26T23:28:57Z

Created page with 'Return to Slicer 3.6 Documentation Gallery of New Features __NOTOC__ ===Model Maker=== ModelMaker {| |[[Image:Mode…'

New page

[[Documentation-3.6|Return to Slicer 3.6 Documentation]]

[[Announcements:Slicer3.6#Highlights|Gallery of New Features]]

__NOTOC__
===Model Maker===
ModelMaker

{|
|[[Image:ModelMakerModule.png|thumb|280px|The Model Maker GUI]]

|}

== General Information ==
===Module Type & Category===

Type: CLI

Category: Model Generation

===Authors, Collaborators & Contact===
* Author1: Nicole Aucoin: Brigham and Women's Hospital
* Contributor1: Bill Lorensen, GE
* Contact: Nicole Aucoin, nicole@bwh.harvard.edu

===Module Description===
The Modelmaker is used to create 3D surface models from segmented image data, called label maps. Label maps can be the result of automated segmentation or interactive editing.

== Usage ==

Select an input volume from the label map volumes that are present in the scene. Create a new model hierarchy node. Pick a label, range of labels, or all, from which to generate a surface model. Press Apply.

===Use Cases, Examples===

This module is especially appropriate for these use cases:

* Use Case 1: After using the Editor module to segment a volume, use this module to generate a 3D surface of one segment.
* Use Case 2:

Examples of the module in use:

* Example 1
* Example 2

===Tutorials===

Links to tutorials explaining how to use this module:

* Tutorial 1
** Data Set 1

===Quick Tour of Features and Use===

* '''Model Maker panel:'''
**''Parameters Set'': The standard CLI parameter node, created automatically when the values of the GUI widgets are changed from the defaults.
* '''I/O panel:'''
**The Input Volume drop down menu is populated with the label map volumes that are present in the scene
**Models are imported into Slicer under a model hierarchy node, and their colors are set by the color table associated with the input label map volume. The model hierarchy node '''must be created''' before running the model maker, by selecting ''Create New ModelHierarchy'' from the Models drop down menu. If you're running from the command line, a model hierarchy node in a new mrml scene will be created for you (Jan/09).
* '''Create Multiple panel:'''
**Any text entered in the ''Model Prefix'' box will be the starting string for the created model's file names. The label number and the color name will also be part of the file name.
**If you want to create all models that correspond to all values in a labelmap volume, click the ''Generate All Models'' and ''Joint Smoothing'' boxes
**''Joint Smoothing'' will ensure that all resulting models fit together smoothly, like jigsaw puzzle pieces. Otherwise the models will be smoothed independently and may overlap.
**If you specify a list of Labels, it will override any start/end label settings. If you click ''Generate All Models'' it will override the list of labels and any start/end label settings.
* '''Model Maker Parameters panel:'''
**You can set the number of smoothing iterations, target reduction in number of polygons (decimal percentage). Use 0 and 1 if you wish no smoothing nor decimation.
**You can control the type of smoothing done on the models by selecting a ''Filter Type''.
**You can set the flags to split normals or generate point normals in this pane as well.
***''Split Normals'' is useful for visualizing sharp features. However it creates holes in surfaces which affects measurements.
***''Point Normals'' is turned on if you wish to calculate the normal vectors for the points.
**You can save a copy of the models after intermediate steps (marching cubes, smoothing, and decimation if not joint smoothing, otherwise just after decimation); these models are not saved in the mrml file, turn off deleting temporary files first in the tcl window, and then load them manually:
[$::slicer3::CommandLineModuleGUI_Model_Maker GetLogic] DeleteTemporaryFilesOff
* '''Anatomical Information panel:'''
**Here you can specify an external file linking label values with anatomical names. This was the original method of linking label map values to resultant model colors and names, but it has been superseded by an internal linkage between the input label map volume and it's color node. If you wish to specify a file for a volume node that does not have a color node associated with it. It must be a comma separated file, extension .csv, in the format:
anatomyName1,label1
anatomyName2,label2
where anatomyName is a string, and label is an integer. If the volume node has a color node associated with it, that will override the anatomy label file.
**You can choose to not generate models from labels that do not have names by selecting the ''Skip Un-Named labels'' flag.

== Development ==

===Notes from the Developer(s)===

The model maker is a pipeline of algorithms that start from the input label map, creates a binary label map with just the label(s) of interest set to 1, everything else to 0, generates a marching cubes model, runs triangle reduction and triangle smoothing algorithms. The pipeline was optimized for 1mm brain MRI data. For other geometries, adjustments of the parameters might be necessary.

The model maker is compiled as both a command line executable passed arguments via the command line, and as a binary plug in that communicates through shared memory with Slicer3.

===Dependencies===

The Volumes and Models modules are required for this module's use.

===Tests===

On the [http://www.cdash.org/CDash/index.php?project=Slicer3 Dashboard], these tests verify that the module is working on various platforms:

* Slicer3EditorModelMakerTest [http://viewvc.slicer.org/viewcvs.cgi/trunk/Modules/Editor/Testing/TestEditorModelMaker.tcl Modules/Editor/Testing/TestEditorModelMaker.tcl]
* ModelMakerTest [http://viewvc.slicer.org/viewcvs.cgi/trunk/Applications/CLI/Testing/ModelMakerTest.cxx ModelMakerTest.cxx]
* ModelMakerGenerateAllOneLabelTest [http://viewvc.slicer.org/viewcvs.cgi/trunk/Applications/CLI/Testing/ModelMakerTest.cxx ModelMakerTest.cxx]
* ModelMakerGenerateAllThreeLabelsTest [http://viewvc.slicer.org/viewcvs.cgi/trunk/Applications/CLI/Testing/ModelMakerTest.cxx ModelMakerTest.cxx]
* ModelMakerStartEndTest [http://viewvc.slicer.org/viewcvs.cgi/trunk/Applications/CLI/Testing/ModelMakerTest.cxx ModelMakerTest.cxx]
* ModelMakerLabelsTest [http://viewvc.slicer.org/viewcvs.cgi/trunk/Applications/CLI/Testing/ModelMakerTest.cxx ModelMakerTest.cxx]

===Known bugs===

Follow this [http://na-mic.org/Mantis/main_page.php link] to the Slicer3 bug tracker.

===Usability issues===

Follow this [http://na-mic.org/Mantis/main_page.php link] to the Slicer3 bug tracker. Please select the '''usability issue category''' when browsing or contributing.

===Source code & documentation===

Source Code:
*[http://viewvc.slicer.org/viewcvs.cgi/trunk/Applications/CLI/ModelMaker.cxx ModelMaker.cxx]
*[http://viewvc.slicer.org/viewcvs.cgi/trunk/Applications/CLI/ModelMaker.xml ModelMaker.xml]

Doxygen Documentation:
*[http://www.na-mic.org/Slicer/Documentation/Slicer3-doc/html/ModelMaker_8cxx.html ModelMaker.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.

===References===

@@ Line 76: / Line 76: @@
 ***'''Split Normals''' is useful for visualizing sharp features. However it creates holes in surfaces which affects measurements.
 ***'''Point Normals''' is turned on if you wish to calculate the normal vectors for the points.
 **'''Save Intermediate Models''': You can save a copy of the models after each of the intermediate steps (marching cubes, smoothing, and decimation if not joint smoothing, otherwise just after decimation). These intermediate models are not saved in the mrml file, you have to load them manually after turning off deleting temporary files in the tcl window (Window -> Tcl Interactor) using the following command:
    [$::slicer3::CommandLineModuleGUI_Model_Maker GetLogic] DeleteTemporaryFilesOff

@@ Line 9: / Line 9: @@
 {|
 |[[Image:Slicer3.6ModelMakerGUI.jpg|thumb|280px|The Model Maker GUI]]
-|[[Image:Slicer3.6ModelMakerOutput.jpg|thumb|280px|Output from running with Slicer3/Libs/MRML/Testing/TestData/helixMask3Labels.nrrd with the non semantic color look up table]]
+|[[Image:Slicer3.6ModelMakerOutput.jpg|thumb|280px|Output from running using default parameters on Slicer3/Libs/MRML/Testing/TestData/helixMask3Labels.nrrd with the non semantic color look up table]]
 |}

@@ Line 8: / Line 8: @@
 {|
-|[[Image:ModelMakerModule.png|thumb|280px|The Model Maker GUI]]
+|[[Image:Slicer3.6ModelMakerGUI.jpg|thumb|280px|The Model Maker GUI]]
-<!--
+|[[Image:Slicer3.6ModelMakerOutput.jpg|thumb|280px|Output from running with Slicer3/Libs/MRML/Testing/TestData/helixMask3Labels.nrrd with the non semantic color look up table]]
 |}

@@ Line 107: / Line 107: @@
 ===Known bugs===
 Follow this [http://na-mic.org/Mantis/main_page.php link] to the Slicer3 bug tracker.
 ===Usability issues===

@@ Line 57: / Line 57: @@
 * '''Model Maker panel:'''
 **''Parameters Set'': The standard CLI parameter node, created automatically when the values of the GUI widgets are changed from the defaults.
-* '''I/O panel:'''
+* '''IO panel:'''
-**The Input Volume drop down menu is populated with the label map volumes that are present in the scene
+**The '''Input Volume''' drop down menu is populated with the label map volumes that are present in the scene, select one from which to generate models.
-**Models are imported into Slicer under a model hierarchy node, and their colors are set by the color table associated with the input label map volume. The model hierarchy node '''must be created''' before running the model maker, by selecting ''Create New ModelHierarchy'' from the Models drop down menu. If you're running from the command line, a model hierarchy node in a new mrml scene will be created for you (Jan/09).
+**'''Models''': Models are imported into Slicer under a model hierarchy node, and their colors are set by the color table associated with the input label map volume. The model hierarchy node '''must be created''' before running the model maker, by selecting ''Create New ModelHierarchy'' from the Models drop down menu. If you're running from the command line, a model hierarchy node in a new mrml scene will be created for you (Jan/09).
 * '''Create Multiple panel:'''
-**Any text entered in the ''Model Prefix'' box will be the starting string for the created model's file names. The label number and the color name will also be part of the file name.
+**'''Model Name''': Any text entered in the entry box will be the starting string for the created model file names. The label number and the color name will also be part of the file name.
-**If you want to create all models that correspond to all values in a labelmap volume, click the ''Generate All Models'' and ''Joint Smoothing'' boxes
+**''Generate All Models'': select this option if you want to create all models that correspond to all values in a labelmap volume (using the '''Joint Smoothing''' option below is useful with this option).
 * '''Model Maker Parameters panel:'''
-**You can set the number of smoothing iterations, target reduction in number of polygons (decimal percentage). Use 0 and 1 if you wish no smoothing nor decimation.
+**'''Labels''': If you specify a list of Labels, it will override any start/end label settings.  If you click ''Generate All Models'' it will override the list of labels and any start/end label settings.
-**You can control the type of smoothing done on the models by selecting a ''Filter Type''.
+**'''Start Label''': if you want to specify a continuous range of labels from which to generate models, enter the lower label here.
 **You can set the flags to split normals or generate point normals in this pane as well.
-***''Split Normals'' is useful for visualizing sharp features. However it creates holes in surfaces which affects measurements.
+***'''Split Normals''' is useful for visualizing sharp features. However it creates holes in surfaces which affects measurements.
-***''Point Normals'' is turned on if you wish to calculate the normal vectors for the points.
+***'''Point Normals''' is turned on if you wish to calculate the normal vectors for the points.
-**You can save a copy of the models after each of the intermediate steps (marching cubes, smoothing, and decimation if not joint smoothing, otherwise just after decimation). These intermediate models are not saved in the mrml file, you have to load them manually after turning off deleting temporary files in the tcl window (Window -> Tcl Interactor) using the following command:
+**'''Save Intermediate Models''': You can save a copy of the models after each of the intermediate steps (marching cubes, smoothing, and decimation if not joint smoothing, otherwise just after decimation). These intermediate models are not saved in the mrml file, you have to load them manually after turning off deleting temporary files in the tcl window (Window -> Tcl Interactor) using the following command:
    [$::slicer3::CommandLineModuleGUI_Model_Maker GetLogic] DeleteTemporaryFilesOff
-**You can choose to not generate models from labels that do not have names by selecting the ''Skip Un-Named labels'' flag.
+* '''Debug Panel''':
 |[[Image:Slicer3.6ModelMakerGUI.jpg|thumb|280px|The Model Maker GUI]]
 |}

@@ Line 36: / Line 36: @@
 * Use Case 1: After using the Editor module to segment a volume, use this module to generate a 3D surface of one segment.
-* Use Case 2:
+* Use Case 2: When creating models from an image in which the label of interest touches the boundaries of the image, the resulting model has no vertices defined for the surfaces that touch image boundaries. Use the CropVolume module and extend the ROI beyond the image boundary. CropVolume will initialize voxels outside the image with 0s, essentially creating a padding around the volume.
 Examples of the module in use:
-* Example 1
+* Example 1: After segmenting a whole region of the body, you can generate all the surface models at once by selecting the '''Generate All Models''' option.
 * Example 2

Modules:ModelMaker-Documentation-3.6 - Revision history

Nicole: /* Quick Tour of Features and Use */

Nicole: /* Model Maker */

Nicole: /* Known bugs */

Nicole: /* Quick Tour of Features and Use */

Nicole: /* Use Cases, Examples */

Nicole at 20:35, 17 May 2010

Nicole: /* Model Maker */

Nicole: Created page with 'Return to Slicer 3.6 Documentation Gallery of New Features __NOTOC__ ===Model Maker=== ModelMaker {| |[[Image:Mode…'

Nicole: Created page with 'Return to Slicer 3.6 Documentation Gallery of New Features NOTOC ===Model Maker=== ModelMaker {| |[[Image:Mode…'