Shape & Scene Outputs

This page provides a breakdown of the different Shape and Scene attributes you can use in Sama Go when editing your project taxonomy.

Checkboxes

Checkboxes allow annotators to select one or more options by checking boxes. Checkboxes work well when you want to allow annotators to choose one or more possible options, and the list of options is relatively short.

The settings for this output type are as follows:

Setting

Description

Attribute Name

The output name, which annotators will see as the heading for the output section in the annotation workspace.

Attribute Type

The output type.

Required

If this box is checked, the output section will be mandatory for the annotator to complete.

Answer options

The options that annotators can choose from when filling out the output section. Options can either be added manually or imported from a CSV file.

Each option must have a:
• Label: The text that will be shown to the annotator.
• Value: The text that will appear in the JSON output to represent that option if it is selected (e.g., a code that is used internally).

Add

Clicking this button adds a row for a new option, in which you can manually enter the label and value.



Dropdown

Dropdown is a type of scene output. It allows annotators to choose one option from a drop-down list. This output type is useful when you have many options and want to save space by hiding them until the drop-down is clicked.

The settings for this output type are as follows:

Setting

Description

Attribute Name

The output name, which annotators will see as the heading for the output section in the annotation workspace.

Attribute Type

The output type.

Required

If this box is checked, the output section will be mandatory for the annotator to complete.

Answer options

The options that annotators can choose from when filling out the output section. Options can either be added manually or imported from a CSV file.

Each option must have a:
• Label: The text that will be shown to the annotator.
• Value: The text that will appear in the JSON output to represent that option if it is selected (e.g., a code that is used internally).

Add option

Clicking this button adds a row for a new option, in which you can manually enter the label and value.



Multi-level menu

Multi-level menu allows annotators to select one answer from a series of hierarchical menus. This type of output can be useful to organize long lists of options that can be organized into multiple categories.

The settings for this output type are as follows:

Setting

Description

Attribute Name

The output name, which annotators will see as the heading for the output section in the annotation workspace.

Attribute Type

The output type.

Required

If this box is checked, the output section will be mandatory for the annotator to complete.

Answer options

The options that annotators can choose from when filling out the output section.

Each option must have a:
• Name: The text that will be shown to the annotator.
• Attribute code: The text that will appear in the JSON output to represent that option if it is selected (e.g., a code that is used internally).

Add option

Clicking this button adds a row for a new option, in which you can manually enter the label and value.

Multi-level menu attribute options

When you create a multi-level menu for your annotations, you're able to create a series of nested responses, allowing you to increase answer precision by supplying responses with additional specificity. For example, in the pictured schema, the settings will look like this:

When you first select Multi-level menu as the attribute type, you'll have no attribute groups, and will need to define them under the Root header.

📘

Note

Although the Root attribute group is present in the table and can't be renamed, it won't be displayed during annotation, and can be ignored. There is no limit to the number of attribute groups you can add.

Setting a color will modify the color of the created shape, in addition to the highlight within the shape details panel. Limiting the selection to specific shapes will prevent the multi-level menu from appearing when shapes outside the defined ones are created.



Radio buttons

Radio buttons allow annotators to select only one option from a list. This is useful when you want to force an annotator to choose a single option, or when it's impossible for two answers to be true at the same time.

The settings for this output type are as follows:

Setting

Description

Name

The output name, which annotators will see as the heading for the output section in the annotation workspace.

Type

The output type.

Required

If this box is checked, the output section will be mandatory for the annotator to complete.

Answer options

The options that annotators can choose from when filling out the output section. Options can either be added manually or imported from a CSV file.

Each option must have a:
• Label: The text that will be shown to the annotator.
• Value: The text that will appear in the JSON output to represent that option if it is selected (e.g., a code that is used internally).

Add option

Clicking this button adds a row for a new option, in which you can manually enter the label and value.

Select One

This drop-down is only used to create shape outputs. For more information, see Shape outputs.



Text area

Text area is a type of scene output. It allows annotators to enter multiple lines of text into a text box.

The settings for this output type are as follows:

SettingDescription
Attribute NameThe output name, which annotators will see as the heading for the output section in the annotation workspace.
Attribute TypeThe output type.
RequiredIf this box is checked, the output section will be mandatory for the annotator to complete.


Text field

Text field is a type of scene output. It allows annotators to enter one line of text into a text box (line breaks are not permitted).

The settings for this output type are as follows:

SettingDescription
Attribute NameThe output name, which annotators will see as the heading for the output section in the annotation workspace.
Attribute TypeThe output type.
RequiredIf this box is checked, the output section will be mandatory for the annotator to complete.