Modules:Models-Documentation

From Slicer Wiki
Jump to: navigation, search
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.

  • Model Hierarchy Tree: create hierarchy nodes, drag and drop models to be part of hierarchies
  • Model Hierarchy Display: for a grouped hierarchy of models, set the collective display properties (see explanations in the Display section above).