Neuron Composer

The Neuron Composer lets you create new or edit existing neuron objects (generated using the 3D Neuron Analysis recipes or Mesh Contour Editor) in 3D View manually. The Neuron Composer provides tools for editing dendrite segments, adding somas (cell bodies), and adding spines. When you complete an edit, the Neuron Composer automatically updates the neuron measurements as well as the display of the edited neurons.

Interface

The Neuron Composer is one (1) of eight (8) tools found in the 3D Tools tab of the Analysis Panel. Go to 3D View to show the 3D Tools tab. Click on the 3D Tools tab, and then click on the Neuron Composer icon to launch the tool. When you first launch the Neuron Composer, the display settings are updated to show neuron objects and color them by object label. To start editing, select a tool from the Edit Mode section at the top of the Neuron Composer GUI.

Open

Edit modes

The Edit Mode box contains the editing tools for the Neuron Composer. When you select a tool, you enter a specific edit mode that lets you modify certain parts of the neuron objects (i.e., somas, dendrites, or spines). Descriptions and functions for all editing tools in the Neuron Composer are summarized in the table below, and the options for each edit mode are explained in the subsections to follow.

Edit mode	Icon	Hotkey	Description
Predict Dendrite	Open	E	Toggles the Predict Dendrite mode for algorithm-assisted dendrite tracing
Draw Dendrite	Open	D	Toggles the Draw Dendrite tool for WYSIWYG dendrite tracing in the 3D volume
Connect Neurons	Open	C	Toggles the Connect Neurons tool for joining dendritic segments
Delete Dendrite Points	Open	F	Toggles the Delete Dendrite Points tool that removes individual dendritic points
Add Spine	Open	S	Toggles the Add Spine tool for one-click spine creation
Add Soma	Open	A	Toggles the Add Soma tool for one-click soma creation
EM Create	Open	M	Toggles the EM Create tool for point-by-point dendrite tracing
EM Update	Open		Toggles the EM Update tool for updating the segmentation of dendrite meshes following edits to dendrite trees

Predict Dendrite interface

The Predict Dendrite tool offers algorithm-assisted dendrite tracing and has the interface shown on the right. The available options and parameters for Predict Dendrite are grouped into five (5) sections—Trace Radius, Operations, Camera Modes, Clip Modes, and Clip Size—and described in the table below.

Draw Dendrite interface

The Draw Dendrite tool allows you to draw dendrites on a 3D volume with more manual control than the Predict Dendrite tool provides. The interface for the Draw Dendrite tool is shown on the right, and the options and parameters available for the tool are described in the table below.

Connect Neurons interface

The Connect Neurons tool can be used to join dendritic segments to each other as well as to somas. The Connect Neurons interface is shown on the right, and descriptions of the available options are given in the table below.

Delete Dendrite Points interface

The Delete Dendrite Points tool can be used to delete individual dendrite points and has the interface shown on the right. Descriptions of the available options are given in the table below.

Add Spine interface

The Add Spine tool allows for one-click spine creation and has the interface shown on the right. The table below contains descriptions of the available options and parameters for the tool.

Add Soma interface

The Add Soma tool allows for one-click soma creation and has the interface shown on the right. The table below contains descriptions of the available options and parameters for the tool.

EM Create interface

The EM Create tool allows you to create dendrite segments and branches point by point. The interface for the EM Create tool is shown on the right, and the available options and parameters for the tool are described in the table below.

EM Update interface

The EM Update tool allows you to update the segmentation of dendrite meshes based on the tree structure and has the interface shown on the right. The options for the EM Update tool are described in the table below.

Tool-specific hotkeys

Using Neuron Composer

To launch the Neuron Composer tool, click on the 3D Tools tab in the Analysis Panel in Aivia and select the Neuron Composer tool from the 3D Tools toolbar. This will open the Neuron Composer interface.

Trace new dendrites

The Draw Dendrite tool lets you draw new dendrites directly on the 3D volume. Click on the Draw Dendrite tool icon or press the D key on your keyboard to enter this mode. The cursor display will change to a pencil with the tip of the pencil (lower-left corner) as the tracing position.

Before tracing a dendrite, make sure the channel displaying the dendrite is visible. Depending on the intensity of the dendrite and the density of objects in the volume, you may need to adjust the lookup table or add a clipping plane to isolate the desired dendrite. The Draw Dendrite tool uses ray tracing to find the closest opaque (i.e., non-background) signal directly in the line of sight of the displayed volume. To trace, hold down the left mouse button while dragging the mouse cursor along the dendrite.

Each point the Draw Dendrite tool finds along the dendrite is shown as a sphere in the volume. As you trace along the dendrite, additional spheres (dendrite points) are added to the trace. To finalize the trace, release the left mouse button; Aivia will connect the detected dendrite points to form a single dendritic segment and attempt to clean up the trace by removing any points that overlap the constructed trace. 

The video on the right shows an example of using the Draw Dendrite tool to trace dendrites.

For even finer control over the placement of dendrite points, you may use the EM Create tool, which is designed for creating and editing dendrite traces for 3D electron microscopy images. It is recommended that this tool be used while stepping through the image slice-by-slice with an ortho plane. You may click on the Set View Defaults button in the EM Create interface to set the recommended display settings for this editing tool.

When Create Dendrite is enabled in the EM Create tool, left-click on the image to place a dendrite point. Once you have placed all dendrite points on the current trace that you would like to add, click on Build Dendrite or press B to finalize the dendrite segment. You can also branch off of existing dendrite segments in EM Create mode by first enabling Branch From Dendrite, then selecting the dendrite point to branch from (the selected point will turn yellow), placing dendrite points in the branch segment, and finally clicking on Build Dendrite or pressing B to finalize the branch.

Adjust dendrite radius

You can adjust the Trace Radius by moving the slider or entering a new value into the textbox. Increasing the Trace Radius results in thicker dendrite traces and increases the search radius for finding dendrite points. This option is useful for tracing dendrites with discontinuous signals. The radius parameter is relative to your computer display and not to the physical width of the dendrite in the image.

Enhance trace

The Enhance Trace option overrides the dendrite radius by aligning the drawn segment to the center of the dendrite and adjusting the radius locally at each dendrite point detected based on intensity in the volume. For best results, make sure the contrast between the dendrite segment and the background is as high as possible.

Predictive modes

The Predict Dendrite tool lets you partially or fully accept/reject predicted dendritic segments on the 3D volume and can auto-connect traces to existing dendrite segments or somas. Click on the Predict Dendrite tool icon or press the E key on your keyboard to enter this mode. If your dataset has somas and you want to include them in the analysis, we suggest you first detect the soma(s) of interest using the Add Soma tool and then use the Predict Dendrite tool. 

To start a predicted trace, either click on the 3D volume or click on an existing dendrite point to branch or extend from. Predictions will then be shown as yellow lines on the 3D volume.

To accept a full prediction, click on the predicted trace. If a connection to an existing dendrite segment or soma is predicted, the trace will be automatically built and connected when the prediction is accepted; otherwise, the accepted prediction will turn blue, and another prediction will be generated from the end of the accepted prediction. 

To accept a portion of a prediction, hold Ctrl and left-click on the end of the portion you would like to accept. The section you have accepted will turn blue, and the point where you clicked to cut off the prediction will serve as the seed for the next prediction.

As an alternative to partially or fully accepting a prediction, you can click on another location in the 3D volume to serve as the next seed point; Aivia will attempt to find the best path between the newly selected point and the previous seed point and then display it as a blue trace. You can also select an existing dendrite point to connect the current trace to, and a path will be predicted to the selected dendrite point and built.

When no trace is predicted from the last seed point, the seed point will turn red.

Camera modes

Camera modes give you options for automatic camera positioning as you trace. In Follow mode, the camera position and angle of view is automatically adjusted, but in Pan-Only mode the angle of view is not changed. You may deselect Follow and Pan-Only modes to turn off automatic camera movement.

Clip modes

There are three (3) clip modes for clipping to the portion of the image being traced. In Latest mode, the clipping box contains the current prediction and last confirmed path segment. In Grow mode, the clipping box contains the current prediction and all segments in the current trace. In Object Set mode, the clipping box contains the current prediction and all objects in the output object set. You can adjust the size of the clipping box using the Clip Size textbox.

Connect dendrites

You can connect any point on an existing dendrite to any point on a different dendrite or a soma using the Connect Neurons tool. Click on the Connect Neurons icon or press the C key on your keyboard to activate the edit mode. There are three (3) types of connections: