Difference between revisions of "Modules:Models-Documentation"

From Slicer Wiki
Jump to: navigation, search
Line 40: Line 40:
 
**.stl STL
 
**.stl STL
  
=Model Hierarchy=
+
== Model Hierarchy ==
  
Model hierarchies allow you to group together models. When using the ModelMaker module, multiple models created from one label map are returned grouped under a model hierarchy node.
+
Model hierarchies allow you to group together models. When using the  
 +
ModelMaker module, multiple models created from one label map are  
 +
returned grouped under a model hierarchy node.
  
*Model Hierarchy Tree: create hierarchy nodes, drag and drop models to be part of hierarchies
+
It is useful to create mrml scenes for anatomical atlases, for example
*Model Hierarchy Display: for a grouped hierarchy of models, set the collective display properties (see explanations in the Display section above).
+
one found in [[/Wiki/images/7/7f/Spl_pnl_brain_atlas_2007_slicer3.zip | Brain Atlas]]
 +
 
 +
 
 +
* Model Hierarchy Tree allows the following: create hierarchy nodes,  
 +
drag and drop models and hierarchies to be part of hierarchies, control
 +
color and visibility of models and hierarchies, search, delete, and
 +
rename model hierarchies.
 +
 
 +
* Model Hierarchy Display: for a grouped hierarchies of models and
 +
models themselves, set the collective display properties (see  
 +
explanations in the Display section above).
 +
 
 +
 
 +
 
 +
'''The following user operations are supported in the Model Hierarchy Tree'''
 +
 
 +
 
 +
* ''Scene->Right-mouse-click->Insert New Hierarchy Node''
 +
Create new Hierarchy node at the root of the Scene
 +
 
 +
* ''Scene->Right-mouse-click->Insert <Selected Hierarchy Node>''
 +
Re-parents a previously selected hierarchy or model node under the root
 +
of the Scene
 +
 
 +
* ''Scene->Right-mouse-click->Show All''
 +
Turns on the visibility of all hierarchy or model nodes in the scene
 +
* Scene->Right-mouse-click->Show None
 +
Turns ff the visibility of all hierarchy or model nodes in the scene
 +
 
 +
* ''Scene->Right-mouse-click->Search''
 +
Displays a dialog where you can type a part of a node name. The node is
 +
selected if found.
 +
 
 +
 
 +
* ''Hierarchy->Leftt-mouse-click''
 +
Selects a hierarchy node and brings it’s the display properties editor
 +
 
 +
* ''Hierarchy->Right-mouse-click->Insert New Hierarchy Node''
 +
Create new Hierarchy node under this hierarchy node
 +
 
 +
* ''Hierarchy ->Right-mouse-click->Insert <Selected Hierarchy Node>''
 +
Re-parents a previously selected hierarchy or model node under this
 +
hierarchy node
 +
 
 +
* ''Hierarchy->Right-mouse-click->Delete''
 +
Deletes this hierarchy node
 +
 
 +
* ''Hierarchy->Right-mouse-click->Rename''
 +
Displays a dialog where you can type a new node name
 +
 
 +
* ''Hierarchy->Right-mouse-click->Select for Re-parenting''
 +
Select this node for re-parenting later
 +
 
 +
* ''Hierarchy->Right-mouse-click->Visibility''
 +
Toggles the visibility of this hierarchy node. Note, that the visibility
 +
change propagates to all children of the hierarchy
 +
 
 +
* ''Hierarchy->Right-mouse-click->Color''
 +
Displays a color selection dialog where you can select a new color.
 +
Note, that the color that is used for model display is determined by the
 +
first collapsed hierarchy parent node. Only if all parent hierarchies
 +
are open, the model’s own color is used for its display.
 +
 
 +
 
 +
* ''Model->Left-mouse-click''
 +
Selects a model node and brings it’s the display properties editor
 +
 
 +
* ''Model->Right-mouse-click->Select for Re-parenting''
 +
Select this node for re-parenting later
 +
 
 +
* ''Model->Right-mouse-click->Visibility''
 +
Toggles the visibility of this model node
 +
 
 +
* ''Model->Right-mouse-click->Color''
 +
Displays a color selection dialog where you can select a new color.
 +
Note, that the color that is used for model display is determined by the
 +
first collapsed hierarchy parent node. Only if all parent hierarchies
 +
are open, the model’s own color is used for its display.

Revision as of 15:33, 23 February 2008

Home < Modules:Models-Documentation

Back to Documentation

Introduction

This module is used for loading, saving, changing the appearance of, and organizing 3d surface models. The module is a core module for Slicer 3.

Load

  • Load Model allows the user to load a single model, of any type that Slicer recognizes. This includes VTK polydata, BYU, XML polydata, STL files and FreeSurfer surface files.
  • Load Model directory will load all the VTK models (*.vtk) that are located in in the selected directory
  • Load FreeSurfer Overlay will load a FreeSurfer scalar overlay file and associate it with the currently active model. The active model must be a FreeSurfer surface model (e.g. from files named *.pial, *.orig, etc)

Display

  • Model Select: Select the model that you want to modify from a list
  • Visibility: Turn a model on or off in the 3D window
  • Scalar visibility: If the model has a scalar field you can make it visible or not using this check box.
  • Set Active Scalar: Select from the list of currently loaded scalar overlays. Most models will have normals, Freesurfer surface models can have multiple scalar overlay files associated with them (e.g. lh.sulc, lh.curv).
  • Scalar Color Map Select: select the color mapping used to map from the scalar overlay's values (usually in the range of 0.0 to 1.0) to colors. There are built in color maps that can be browsed in the Colors module. The most commonly used color map for FreeSurfer scalar overlays is the GreenRed one. Legacy color maps from Slicer2 include Grey, Iron, Rainbow, etc. Those color maps with "labels" in their names are usually discrete and don't work well for the continuous scalar overlay ranges.
  • Clipping: Set clipping on or off for this model. Once it is on, go to the Clipping pane to set the options.
  • Backface Culling: Set back face culling on or off for this model.
  • Opacity: Set how transparent this model is
  • Set Color: Set the base color for this model. Only visible if the Scalar Visibility is off.
  • Material Properties: This collection of options allows you to change the appearance of the model. Some presets can be selected at the bottom of this pane. A preview sphere lets you adjust the values with immediate feedback.
    • Ambient: controls the base lighting for the model
    • Diffuse: controls the amount of light scattered from the model
    • Specular: controls the highlights on the model
    • Power: sets the specular power

Clipping

  • Red Slice Clipping: set to use the Red slice plane to clip this model in positive or negative space.
  • Yellow Slice Clipping: set to use the Yellow slice plane to clip this model in positive or negative space.
  • Green Slice Clipping: set to use the Green slice plane to clip this model in positive or negative space.
  • Clip Type: when more than one slice plane is used, this option controls if it's the union or intersection of the positive and/or negative spaces that is used to clip the model.

Save

  • Model To Save: select a model from the list.
  • Save Model: opens a file browser to let you select the location to which to save the file. The valid extensions and file types that can be used are:
    • .vtk poly data
    • .vtp xml poly data
    • .stl STL

Model Hierarchy

Model hierarchies allow you to group together models. When using the ModelMaker module, multiple models created from one label map are returned grouped under a model hierarchy node.

It is useful to create mrml scenes for anatomical atlases, for example one found in Brain Atlas


  • Model Hierarchy Tree allows the following: create hierarchy nodes,

drag and drop models and hierarchies to be part of hierarchies, control color and visibility of models and hierarchies, search, delete, and rename model hierarchies.

  • Model Hierarchy Display: for a grouped hierarchies of models and

models themselves, set the collective display properties (see explanations in the Display section above).


The following user operations are supported in the Model Hierarchy Tree


  • Scene->Right-mouse-click->Insert New Hierarchy Node

Create new Hierarchy node at the root of the Scene

  • Scene->Right-mouse-click->Insert <Selected Hierarchy Node>

Re-parents a previously selected hierarchy or model node under the root of the Scene

  • Scene->Right-mouse-click->Show All

Turns on the visibility of all hierarchy or model nodes in the scene

  • Scene->Right-mouse-click->Show None

Turns ff the visibility of all hierarchy or model nodes in the scene

  • Scene->Right-mouse-click->Search

Displays a dialog where you can type a part of a node name. The node is selected if found.


  • Hierarchy->Leftt-mouse-click

Selects a hierarchy node and brings it’s the display properties editor

  • Hierarchy->Right-mouse-click->Insert New Hierarchy Node

Create new Hierarchy node under this hierarchy node

  • Hierarchy ->Right-mouse-click->Insert <Selected Hierarchy Node>

Re-parents a previously selected hierarchy or model node under this hierarchy node

  • Hierarchy->Right-mouse-click->Delete

Deletes this hierarchy node

  • Hierarchy->Right-mouse-click->Rename

Displays a dialog where you can type a new node name

  • Hierarchy->Right-mouse-click->Select for Re-parenting

Select this node for re-parenting later

  • Hierarchy->Right-mouse-click->Visibility

Toggles the visibility of this hierarchy node. Note, that the visibility change propagates to all children of the hierarchy

  • Hierarchy->Right-mouse-click->Color

Displays a color selection dialog where you can select a new color. Note, that the color that is used for model display is determined by the first collapsed hierarchy parent node. Only if all parent hierarchies are open, the model’s own color is used for its display.


  • Model->Left-mouse-click

Selects a model node and brings it’s the display properties editor

  • Model->Right-mouse-click->Select for Re-parenting

Select this node for re-parenting later

  • Model->Right-mouse-click->Visibility

Toggles the visibility of this model node

  • Model->Right-mouse-click->Color

Displays a color selection dialog where you can select a new color. Note, that the color that is used for model display is determined by the first collapsed hierarchy parent node. Only if all parent hierarchies are open, the model’s own color is used for its display.