NeuroTessMesh User Interface¶
In this section we’ll describe the different panels and configuration options in the main dialog.
NeuroTessMesh Application Toolbar¶
The application bar presents several icons to perform actions such as opening datasets, and showing or hiding configuration panels. The user can see the menu entries to associate each icon with function (Fig. 2).
File¶
The first four icons loads an scene or neuron morphology. The neuron morphology must be described following the SWC format Scenes composed of severan neurons must be described using an XML specific format (described in the file formats section).
- Open BlueConfig: Opens neuron morphology in BlueConfig format.
- Open XML scene: Opens a scene composed of several neurons.
- Open SWC: Opens a neuron morphology in SWC format.
- Open HDF5: Opens neuron morphology in HDF5 format.
Configuration¶
Tessellation params:
- Subdivision level: Maximum level of subdivisions for the visualization. The valid values are in the range of 1 and 30.
- Distance threshold: Further distance to witch the subdivision is applied. The valid values are 0 to 1, 1 being the camera maximum visibility distance.
- Tangent smoothing: Scales the modulus of the orientation vectors applied to smooth the neurite trajectories. The valid values are 0 to 1, 0 being no smoothing and 1 the maximum smoothing.
Tessellation criteria: Select the tessellation criteria applied in the subdivision.
- Homogeneous: Same level of subdivision for all the mesh.
- Camera distance: The level of subdivisions is higher near the camera.
Render panel¶
Color: Selects the background color for the scene view.
Render piece selection: Select the parts (full, only soma, only neurites) of the neuron to visualize. This selection can be done independently for each of the following types of neurons.
- Neuron
- Selected neuron
The Selected, and Unselected neurons refer to the entities selected via ZeroEQ selection in other applications.
- Render coloring: Selects the coloring method for the current scene. There are four coloring methods:
- Selection: Color neurons by selection.
- Morphology: Color neurons by morphology type.
- Layer: Color neurons by layer.
- Function: Color neurons by function type.
The render coloring method selected will affect the colors shown in the neuron list and edit panel. The color for each possible value can be modified by clicking in the colored box right next to the value name.
Edit and save panel¶
The edit and save panel list the neurons in the scene colored by the selected coloring method in the render panel. The neurons are listed in this panel using the pattern (id) (morphological type) in its naming.
Show additional information: adds the function and layer information to the neuron name (if available).
Select Neuron: select the target neuron from a list of the neurons in the current scene.
Parameters: different parameters to modify the reconstructed neuronal mesh.
- Radius factor: scales the radius of the initial sphere used to generate the soma. [0-1].
- Neurite [n] factor: factor that multiplies the distance from the neurite n to the soma. 0: Distance=0 (on the soma surface). 1: Current distance*2
Save button: save the actual mesh reconstruction to “obj” file.
Scene camera controls¶
- The camera can be manipulated using the mouse. The movements are:
- Rotation: mouse left button + mouse movement.
- Translation: mouse scroll button (middle button) + mouse movement.
- Zoom: mouse scroll to zoom in and out.
Recorder¶
The recording feature can be activated using the Tools menu or by clicking the Recorder icon in the toolbar. The user will be presented with the recorder configuration dialog (Fig. 7).
The recorder will generate a Matroska MKV video if the media application ffmpeg is detected and available, if not the generated output will be individual frames. The frames per second of the output can be specified here. The user can specify the input of the recording, being the main application window or just the 3D viewport.
In the advanced configuration dialog (Fig. 8) the user can modify additional options as which worker (video or frames) to use to generate the output. The advanced configuration dialog can be enabled by checking the Advanced recorder options checkbox in the Tools menu).
Using the advanced configuration an area of the application can be selected for recording as input.
If the output is a video the user can specify the location of the generated file using the Select button. If the output is a sequence of frames the user can specify the destination directory using the Select button in the dialog.
The dimensions of the output are shown and can be modified with the scale options.
While the recorder is working the associated toolbar button will remain down and the icon will change every second with an image of a “Stop” button with REC letters written inside it. The user must click it again to stop the recording. The recorder can also be stopped using the Recorder button in the Tools menu or the keyboard shortcut Ctrl + R.
Note
If the output is a video the filename of the output file will end with “_temporal” while recording. Once the recording has finished it will change to the selected output name in the configuration dialog. The application will warn if the user tries to exit the application while a recording is being made.
Warning
To record a video the system must have ffmpeg installed, preferably with Nvidia hardware acceleration. If ffmpeg is not available in the system only the images worker will be available in the recorder.
Keys and shortcuts¶
- Open BlueConfig: Ctrl + Shift + B
- Open XML Scene: Ctrl + Shift + X
- Open SWC: Ctrl + Shift + S
- Exit application: Ctrl + Shift + Q
- Home (reset view): Ctrl + H
- Update on idle: Ctrl + I
- Show FPS on idle update: Ctrl + S
- Show wireframe: Ctrl + W
- Render options: Ctrl + B
- Edit and save: Ctrl + M
- Configuration: Ctrl + C
- Toggle Recorder: Ctrl + R