Modules:Models-Documentation-3.4

From SlicerWiki

Jump to: navigation, search
Home < Modules:Models-Documentation-3.4

Return to Slicer 3.4 Documentation

Gallery of New Features

Module Name

Models

Module Panel

General Information

Module Type & Category

Type: Interactive

Category: Base

Authors, Collaborators & Contact

  • Alex Yarmarkovich, Isomics, SPL
  • Nicole Aucoin, BWH
  • Contact: Alex Yarmarkovich, alexy@bwh.harvard.edu

Module Description

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

Usage

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. Note: only one model at a time can be correctly rendered with less than 100% opacity. This is a not a slicer limitation, it's a property hardware accelerated 3D graphics.
  • 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 grouped under a model hierarchy node.
  • Model Hierarchies are useful to create mrml scenes for anatomical atlases, for example one found in the SPL/PNL Brain Atlas.
  • SceneSnapshots record the status of the Model Hierarchy Tree.
  • 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).

User operations in the Model Hierarchy Tree widget

Action Result
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 off 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.

Model Display

  • Allows to adjust the visualization properties of individual models or model hierarchies.
  • Color, Scalar fields, opacity and material properties can be set.
  • Clipping enables clipping for that particular structure
  • Backface culling is turned on by default. This means that all the faces pointing away from the view point of the camera, are not rendered. This feature needs to be turned off if the inside of a model is viewed, either when clipping or when moving the camera inside an object.

Save Model

  • Is used to save a model.
  • It is important to remember to provide the extension, typically .vtk (e.g. MyModel.vtk)

Examples, Use Cases & Tutorials

loading and viewing data].

Quick Tour of Features and Use

  • Load: Load models into Slicer3
  • Display: Adjust modles display parameters
  • Clipping: Enable/Adjust modles clipping by the slice planes
  • Model Hierarchy: Create/Change groupings of models, ajust their

display properties.

  • Infol: General information about models
  • Save: Saves models onto disk

Development

Dependencies

Other modules or packages that 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.

Follow this link to the ChangeTracker source code in ViewVC.

Documentation generated by doxygen.

More Information

Acknowledgment

References

Personal tools