Difference between revisions of "Slicer3:Model Into Label Volume Documentation-3.4"

From Slicer Wiki
Jump to: navigation, search
Line 24: Line 24:
 
== Usage ==
 
== Usage ==
  
Select a model node and a reference volume node from the MRML Scene.
+
Select a model node and a reference volume node from the MRML Scene, press the Apply Button.  
 
 
Optionally, you can select a label value that will be inserted into the new label volume, as well as a name for the new label volume. If you don't select a label value, 2 will be used. If you leave the Label Volume Name field blank, a new name will be created from the name of the model and the name of the reference volume.
 
 
 
If you choose to set the use intensity flag, the voxel values in the reference volume will be copied to the output label map. This will result in a colorful label map until you reset the color node associated with the new label volume, but is useful for calculating statistics at the model intersection with the reference volume.
 
 
 
If you choose to set the subdivide model flag, before the intersection is done, the model will be subdivided so that it contains more vertices from which to calculate the intersection with the reference volume. Useful with sparse reference volumes.
 
 
 
The default labels color look up table will be assigned to the new label map volume.  
 
  
 
===Examples, Use Cases & Tutorials===
 
===Examples, Use Cases & Tutorials===
Line 45: Line 37:
 
List all the panels in your interface, their features, what they mean, and how to use them. For instance:
 
List all the panels in your interface, their features, what they mean, and how to use them. For instance:
  
* '''Settings panel:''' this module has a single panel, see the Usage section above for details.
+
* '''Settings panel:''' this module has a single panel, all options are controlled here.
 +
**'''Model''': Select a model node from the scene.
 +
**'''Reference Volume''': Select a volume node from the scene. This volume will be cloned into a label map volume and used as the output volume. The default labels color look up table will be assigned to the new label map volume.
 +
**'''Label Value''': Optionally, you can select a label value that will be inserted into the new label volume, If you don't select a label value, 2 will be used.
 +
**'''Label Volume Name''': Optionally, you can select a name for the new label volume. If you leave the Label Volume Name field blank, a new name will be created from the name of the model and the name of the reference volume: ''ModelName-VolumeName''.
 +
**'''Use Intensity''': If you choose to set the use intensity flag, the voxel values in the reference volume will be copied to the output label map. This will result in a colorful label map until you reset the color node associated with the new label volume, but is useful for calculating statistics at the model intersection with the reference volume.
 +
**'''Subdivide Model''': If you choose to set the subdivide model flag, before the intersection is done, the model will be subdivided (using the vtkButterflySubdivisionFilter) so that it contains more vertices from which to calculate the intersection with the reference volume. Useful with sparse reference volumes.
  
 
== Development ==
 
== Development ==
 +
 +
This module results in an outline of the model appearing in the new label volume. An enhancement is under discussion to fill in the model.
  
 
===Dependencies===
 
===Dependencies===
Line 56: Line 56:
  
 
Follow this [http://na-mic.org/Mantis/main_page.php link] to the Slicer3 bug tracker.  
 
Follow this [http://na-mic.org/Mantis/main_page.php link] to the Slicer3 bug tracker.  
 
 
  
 
===Usability issues===
 
===Usability issues===

Revision as of 19:29, 12 February 2009

Home < Slicer3:Model Into Label Volume Documentation-3.4

Return to Slicer 3.4 Documentation

Model Into Label Volume

ModelIntoLabelVolume

Screenshot of the GUI

General Information

Module Type & Category

Type: Interactive, scripted in Tcl.

Category: Model Generation

Authors, Collaborators & Contact

  • Nicole Aucoin: Brigham and Women's Hospital
  • Contact: Nicole Aucoin, nicole@bwh.harvard.edu

Module Description

Intersect a model with a reference volume and create an output label map volume with the model vertices labeled with the given label value.

Usage

Select a model node and a reference volume node from the MRML Scene, press the Apply Button.

Examples, Use Cases & Tutorials

  • This module is especially useful once fibre tracts have been generated for a DTI case. Intersect the tract model with the FA reference volume.

Quick Tour of Features and Use

List all the panels in your interface, their features, what they mean, and how to use them. For instance:

  • Settings panel: this module has a single panel, all options are controlled here.
    • Model: Select a model node from the scene.
    • Reference Volume: Select a volume node from the scene. This volume will be cloned into a label map volume and used as the output volume. The default labels color look up table will be assigned to the new label map volume.
    • Label Value: Optionally, you can select a label value that will be inserted into the new label volume, If you don't select a label value, 2 will be used.
    • Label Volume Name: Optionally, you can select a name for the new label volume. If you leave the Label Volume Name field blank, a new name will be created from the name of the model and the name of the reference volume: ModelName-VolumeName.
    • Use Intensity: If you choose to set the use intensity flag, the voxel values in the reference volume will be copied to the output label map. This will result in a colorful label map until you reset the color node associated with the new label volume, but is useful for calculating statistics at the model intersection with the reference volume.
    • Subdivide Model: If you choose to set the subdivide model flag, before the intersection is done, the model will be subdivided (using the vtkButterflySubdivisionFilter) so that it contains more vertices from which to calculate the intersection with the reference volume. Useful with sparse reference volumes.

Development

This module results in an outline of the model appearing in the new label volume. An enhancement is under discussion to fill in the model.

Dependencies

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

Known bugs

Follow this link to the Slicer3 bug tracker.

Usability issues

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

Source code & documentation

Customize following Source Code.

As this is a module scripted in TCL, there is no C++ doxygen documentation.


More Information

Acknowledgment

Work on this module was funded through NA-MIC.

References