Difference between revisions of "SNT: Reconstruction Viewer"

(Manage and Customize Neuronal Arbors)
(Manage and Customize Neuronal Arbors)
Line 67: Line 67:
 
<div align="left">
 
<div align="left">
 
<ul>  
 
<ul>  
<li style="display:inline-block;"> [[Image:reconstruction-viewer-color-mapping-individual.png|left|thumb|200px|Branch Order and Ice LUT]] </li>
+
<li style="display:inline-block;"> [[Image:reconstruction-viewer-color-mapping-individual.png|none|thumb|200px|Branch Order and Ice LUT]] </li>
 
</ul>
 
</ul>
 
</div>
 
</div>
Line 73: Line 73:
 
<div align="left">
 
<div align="left">
 
<ul>
 
<ul>
<li style="display:inline-block;"> [[Image:reconstruction-viewer-color-mapping-group.png|left|thumb|200px|No. Branch Points and Ice LUT]]  
+
<li style="display:inline-block;"> [[Image:reconstruction-viewer-color-mapping-group.png|none|thumb|200px|No. Branch Points and Ice LUT]]  
 
</ul>
 
</ul>
 
</div>
 
</div>
Line 79: Line 79:
 
<div align="left">
 
<div align="left">
 
<ul>  
 
<ul>  
<li style="display:inline-block;"> [[Image:reconstruction-viewer-color-mapping-unique.png|left|thumb|200px|Unique Color Coding]] </li>
+
<li style="display:inline-block;"> [[Image:reconstruction-viewer-color-mapping-unique.png|none|thumb|200px|Unique Color Coding]] </li>
 
</ul>
 
</ul>
 
</div>
 
</div>
Line 85: Line 85:
 
<div align="left">
 
<div align="left">
 
<ul>  
 
<ul>  
<li style="display:inline-block;"> [[Image:reconstruction-viewer-thickness-1.png|left|thumb|200px|Unique Color Coding]] </li>
+
<li style="display:inline-block;"> [[Image:reconstruction-viewer-thickness-1.png|none|thumb|200px|Thickness = 1.0]] </li>
<li style="display:inline-block;"> [[Image:reconstruction-viewer-thickness-5.png|left|thumb|200px|Unique Color Coding]] </li>
+
<li style="display:inline-block;"> [[Image:reconstruction-viewer-thickness-5.png|none|thumb|200px|Thickness = 5.0]] </li>
 
</ul>
 
</ul>
 
</div>
 
</div>

Revision as of 15:57, 13 July 2019

Home Manual Walk-throughs Screencasts Shortcuts Analysis Rec. Viewer SciView Cx3D Scripting FAQ


SNT's Reconstruction Viewer is a powerful OpenGL 3D visualization tool for both surface meshes and reconstructions

  • It can be used as a standalone program or from withing SNT
  • Features:
    • Advanced rendering supporting axes, transparency, color interpolation and path smoothing
    • Interactive scenes (controlled rotations, panning, zoom, scaling, animation, "dark"/"light" mode)
    • Tools for management and customization of scene elements
    • Ability to render both local and remote files on the same scene
    • Loading of surface meshes of several template brains (Drosophila and Allen CCF (Allen Mouse Brain Atlas))

Starting the Viewer

The Reconstruction Viewer may be used as either a standalone program or from within SNT. To open Reconstruction Viewer as a standalone program, go to Plugins › NeuroAnatomy › Reconstruction Viewer. To open the program from within SNT, use the "Open Reconstruction Viewer" option in the 3D tab of the SNT dialog. If there are any tracings currently loaded in SNT, they will be displayed in Reconstruction Viewer after opening. Note that, for performance reasons, some Path Manager changes may need to be synchronized manually from RV controls.

Scene Interaction

Reconstruction-viewer-example-scene.png

The display canvas supports multiple modes of interaction, including controlled rotations, panning, zoom, scaling, animation, and alternation between "dark" and "light" modes.

  • Panning Right-Click + Drag
  • Rotation Left-Click + Drag or Left/Right arrow keys
  • Zoom Scroll the mouse wheel or use the +/- keys
  • Animation Double Left-Click
  • Snap to Top/Side View ^ Ctrl + Left-Click
  • Toggle Axes A
  • Toggle Camera Mode C
  • Toggle Dark Mode D
  • Fit View to Visible Objects F
  • Reset View R
  • Snapshot S
  • Help H (notification) or F1 (list)

RV Controls

Scene Controls

Reconstruction-viewer-scene-controls.png

This menu provides control over the rendered scene.

  • Fit to Visible Objects Computes a bounding box containing all objects of the scene and adjusts the zoom level to ensure all objects are within the camera view.
  • Stretch-to-Fill Stretches the projection on the whole viewport.
  • Stretch-to-Fill - disabled
  • Stretch-to-Fill - enabled
  • Impose Isotropic Scale Squares the aspect ratio of the selected dimensions, leaving the others unchanged.
  • Impose Isotropic Scale - None
  • Impose Isotropic Scale -ZY
  • Reload Scene Resets the zoom level to the default, fitting and centering all scene objects into the camera view. The current rotation setting remains unchanged. Note if some drawables in the 3D scene are not being rendered properly when this option is selected, it will prompt to rebuild the scene completely.
  • Rebuild Scene Clears all objects from the scene then rebuilds them from scratch.
  • Wipe Scene Removes all objects from the scene. Note this action cannot be undone.
  • Sync Path Manager Changes If the 3D scene contains any trees that are currently stored in the Path Manager, re-render these trees to reflect any change in the path structure given by the Path Manager.

Manage and Customize Neuronal Arbors

This menu relates to the import, customization and management of rendered reconstructions.

Reconstruction-manage-arbors-menu.png
  • Import File... Imports and renders a single reconstruction file (".swc" or ".traces"). A color may be chosen on import or applied later using the "Customize" sub-menu. Note that loaded files will not be listed in the Path Manager.
  • Import Directory... Imports and renders all reconstruction files in a directory. A single color may be applied to all reconstructions or they may be colored uniquely. Note that loaded files will not be listed in the Path Manager.
  • Load from Database Allows import and rendering of reconstruction files fetched from the FlyCircuit, MouseLight and NeuroMorpho remote databases.
  • Customize A sub-menu containing color coding and rendering options for plotted reconstructions.
    • Assign Color... Assigns the chosen homogeneous color to all selected reconstructions.
    • Color Coding (Individual Cells)... Applies morphometric color mapping to selected reconstructions. The chosen LUT is used to assign a metric-based color gradient to each reconstruction.
  • Branch Order and Ice LUT
    • Color Coding (Group of Cells)... Applies morphometric color coding to a selected group of reconstruction. Note that this option uses the chosen LUT to assign a homogeneous color to each reconstruction in the group based on the chosen metric.
  • No. Branch Points and Ice LUT
    • Color Each Cell Uniquely Applies a unique and homogeneous color to each selected reconstruction. Note this option will override any previously applied color mapping to the selected reconstructions.
  • Unique Color Coding
    • Thickness... Specifies a constant thickness to be applied to the selected reconstructions. Note this value will only affect how Paths are displayed in the Reconstruction Viewer.
  • Thickness = 1.0
  • Thickness = 5.0
    • Translate... Specifies a translation to be applied to the selected reconstructions. To avoid overwriting data from a tracing session, this command is only available in the standalone viewer.
  • Remove Selected... Deletes the selected reconstructions from the scene.
  • Remove All... Deletes all reconstructions from the scene.