Classification Configuration

Classifications are individual values that can be selected from a customizable list and assigned to the entities for which they are configured. For example, if annotating images of produce, a classification of ripeness could be added to each individual produce item as it is annotated. Alternatively, in video annotation, you could create a classification that allows you to record whether an entity has entered or exited the frame of the video. There is no limit on the number of classifications or the number of classification values that can be presented to the annotator allowing for endless possibilities.

Adding Classifications

To add a new classification you must already have configured an entity type for your project. Access the Adding Entity Type pop-up for the entity in question by clicking Edit next to the entity in the Ontology tab for the project. From the Adding Entity Type pop-up, scroll down and click the + Add a new classification hyperlink and a nested Adding Classification pop-up will appear. The work on your entity type is saved behind the Adding Classification pop-up and can be revisited and further refined once your classification configuration for the entity is complete. Much of the configuration options for the classifications are identical to that of the entity configuration you have been working on thus far, thus the structure of the Adding Classification pop-up should be largely familiar.

Basic Info

As with entity configuration, the first subsection of the Adding Classification pop-up is Basic Info and should be relatively straightforward.

Name

The Name field is used to designate a unique name for the desired entity. The Name field is required.

Description

The Description field is used to designate a unique name for the desired entity. The Description field is optional.

Type

The Type field is used to designate which type of selection method you would like to be presented to the annotator for this classification. Use the dropdown box to select from either, Single Selection, Multiple Selection, or Text Input.

Single Selection

With Single Selection, the annotator will only be able to select a single one of the values you define in the next section for each of these entities they annotate via a radial button.

Multiple Selection

With Multiple Selection, the annotator will be able to select as many of the values you define in the next section for each of these entities they annotate via checkboxes.

Text Input

With Text Input, the annotator will be presented with a fillable text box allowing for custom inputs for each of these entities they annotate.

Required Classifications

To the right of the Type dropdown box, there should be a checkbox labeled "Classification is required". Selecting this checkbox will require the annotator to complete this classification for each of these entities they annotate. If left unchecked, the annotator will be able to complete their annotation of these entities without having to fill out the classification section. 

Values

Default Value

Use the binary radial button options to select whether or not the classification should have a default value. Please note that utilizing the default value setting will likely increase task efficiency but has the potential to introduce annotator bias. Enabling this setting works slightly differently depending on the classification type selected above.

Single Selection

A radial button will appear next to each of the values in the table below, allowing you to designate which of the values should be set as default.

Multiple Selection

As with Single Selection, a radial button will appear next to each of the values in the table below, allowing you to designate which of the values should be set as default. Currently, Multiple Selection only supports one default value to be set, but annotators can still select additional values as needed.

Text Input

A textbox should appear with the pre-populated text "Enter default text here". Replace this text with your desired default value.

Adding Values

The first classification is auto-populated with the default value name "Value 1". Click the Rename hyperlink to rename this value to something appropriate for your classification.

To add additional values click the + Add new value hyperlink and again, rename the default value name to something appropriate for your classification. Using this same process add as many values as are required for your project.

Preview

As you have adjusted these settings, you should have noticed that the Preview section of the pop-up has been dynamically updating to reflect the changes you have made. This section shows the exact options the annotator will be presented with when reviewing the classification section of the annotated entities in question. Use this preview to confirm that the selections are consistent with what you want the annotator the see.

Finalizing the Classification

Once you are satisfied with your configuration changes, click the Done button to finalize your classification and return to the Entity Type Configuration pop-up. You can always revisit the Adding Classification pop-up to make further refinements and changes by selecting the Edit hyperlink next to the classification in question within the Entity Type Configuration settings. Alternatively, from the same settings pop-up, you may select the Delete hyperlink to remove the classification entirely. You may also repeat this entire process to create additional classification options for the annotator to complete.

Copy an Existing Classification

If the classification you are creating is not the first classification for the entity in question, you can use an existing classification as the basis for the new one if you would like. To do this, from the Adding Entity Type pop-up for the entity in question, locate the Copy an existing classification dropdown box under the Classifications section of the pop-up. Once you select this dropdown box, you should see a list of the existing classification formatted as EntityName-ClassificationName. Select the existing classification you would like to use as the basis for your new classification from this list. A new instance of the Adding Classification pop-up will appear with all of the configurations from the selected existing classification auto-populated into each respective field. Follow the above steps to modify this secondary classification as needed.