Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Updated for 8.8(.1) - added images with the new logo, removed a reference to pre-trained neuron classifiers, and made other minor edits

The Classifier View in Aivia allows you to create and apply custom object classifications on analyzed data. The classifier uses a random forest algorithm to identify unique features (i.e. measurements) for classification. The view mode can be found on toggled using the Classifier View icon Image Added in the zoombar, which is directly above the image.

This page will walk you through the steps needed for classifying objects using the classifier view Classifier View.



Panel

On this page:

Table of Contents


Apply a classifier

Aivia comes pre-loaded with three classifiers for neuron classification. You can also load a classifier from a file and apply classification on classify new data by pressing the load classifier Image Removed icon on the Classifier view toolar Load Classifier icon Image Added in the Classifier View toolbar

To apply a classifier, select the classifier to run from the Classifier dropdown menu and click the Apply button in the lower right corner of the gallery. If the data has existing classifications, applying a classifier will remove the existing classifications and create new ones.

On apply, the classifier will look at each object and assign a class. If you have Color by Class turned on in the Display Object Set Settings, the color colors of the objects will change to correspond to its their assigned categorycategories. An example of classified output is shown on the right.

You can also view the objects by class in the Spreadsheet panel as subsets.



Image Modified

Example of classification output with Color by Class turned on (Neuron reconstruction courtesy of NeuroMorpho.org)


Create a classifier

You can create a new classifier from scratch by clicking on the Create New Classifier Classifier icon Image Modified button in  in the Classifier View toolbar. Make sure you have loaded an image and have analysis data prior to using the Classifier tool. When you click the Create New Classifier button, the Classifier Creation dialog will be shown (see right).

Select the object type

In the dialog, enter a name for your classifier into the Name field and select the type of objects you wish to classify using the Object Type dropdown menu. Aivia currently supports the classification of seven types of objects:


Object TypeDescription
NeuronClassify whole 3D neuron neurons (based on full neuron reconstruction with soma, dendrites, and spines included)
MeshFeaturesClassify 3D object surfaces
Soma

Classify 3D somasomas

DendriteClassify 3D dendritic arbors (based on overall dendrite branching)
DendriteSemgentClassify 3D dendritc dendritic branches/segments as individual objects
SpineClassify 3D spine objects (based on spine head and neck)
OutlineClassify 2D objects for each time - point


When you are done, click Create to return to the Classifier view View and start with a blank classifier.



Image Removed
Image Added



Create a class

In order to create a functional object classifier, you will need to have a minimum of two (2) classes defined with examples of objects given in for each class. To create a class, click on the + button to the right of the Class dropdown menu in the classifier bar.

When you create a class, a new header is shown in the gallery with the name highlighted. Type in a new name and press Enter to finish creating a class. Do this for each class you wish to add to the classifier.

Select measurements

Starting in Aivia 7.5, you can specify which measurements to use when generating the classification rules by clicking on the Select measurement Measurements icon Image Modified icon on  in the toolbar.

When you click on the icon, a new dialog opens. Click on the checkbox for each measurement you want to include. If the measurement has not been calculated on the image, it will be automatically calculated when you apply the classifier. When you are finished selecting the measurements, click Finish to confirm and save your changes.

Intensity measurements can be selected on the additional tabs in the
Select Measurement Classifier Measurements window. Once you have selected the intensity measurements, click on the Channel Input Selection button located just below the toolbar to the caret next to Input And Output to expand the menu where you may specify the input channels to measure from the image as well as the object set to classify.


Image Removed
Channel input selection

Image Added

Input And Output section (expanded)




Image RemovedImage Added

Select measurement Classifier Measurements window



Teaching

Teach the classifier

The classifier is generated through a "teaching" process by providing examples of objects for each defined class. The Classifier tool uses a random forest algorithm to identify unique (and most recurrent) measurements for separating the classes.

Depending on the Object Type chosen, the Classifier tool will automatically generate the appropriate list of measurements to be used for classification. Depending on the size of the image, there may be a short delay in Aivia while the measurements are being generated.

To teach the classifier, first select the representative objects by clicking on its thumbnail their thumbnails in the gallery or by selecting them directly on the image. You can select multiple objects by holding down the Ctrl or Shift key on your keyboard while clicking in the gallery or on the image. Alternately, you can also use the Toggle Multi-Selection option Image Modifiedoption to  to select multiple objects one-by-one.

There are two ways to assign an object to a class for teaching:

  • Drag-and-drop the selected thumbnails directly to the header of one of the classes in the gallery 
  • Select the class to assign to using the Class dropdown menu below the gallery and clicking click the Assign button.

Once selected, you can drag-and-drop the selected thumbnails directly to the header of one of the classes in the gallery. Alternately, you can select the class to assign to using the Class dropdown menu below the gallery and clicking the Assign button.

On assignment to a class, the selected thumbnails will appear in the gallery of its their assigned class.

When you are done providing the examples for the classifier, press the Teach button to generate the classifier.


Tip

You need to provide at least one (1) example object for every class you have created in the Classifier View. Additionally, a minimum of two (2) classes are required




Review classifier quality

You can review the quality of the classifier by looking at the quality indicator to the left of the Teach button. A full green bar indicates the classifier is good (meaning that the classifier has sufficient unique features to separate each class), whereas a red bar indicates the classifier is poor. You can view the classifier accuracy value by hovering over the bar.

You can review the classification quality for each class by looking at the indicator bar to the left of the class header in the gallery.

Save the classifier

After applying the classifier, make sure to save the classifier by clicking the Save Classifier button Image Modified. This will allow you to load the classify and apply it to other images in the future.


Additional options

The Detect Novelties checkbox allows you to incorporate novelty detection to your classifier. With novelty detection turned on, the classifier will generate an additional novelty score for each object. If the an object's novelty score is higher than the specified Novelty Threshold, it will be assigned to a novel class in addition to an existing class.

This option lets you identify outliers in your data that may potentially belong to an unknown phenotype.




Filter by label (Content by label)
showLabelsfalse
max5
spacescom.atlassian.confluence.content.render.xhtml.model.resource.identifiers.SpaceResourceIdentifier@fd58
showSpacefalse
sortmodified
reversetrue
typepage
cqllabel in ( "how_to" , "pixel-classifier" ) and type = "page" and space = "AW"
labelslive_import how_to


Page Properties
hiddentrue


Related issues