Bounding Box Labels

The Bounding box labels extension is a core extension for bounding box labeling projects. It contains the label set (taxonomy) used for labeling.

You can add a label set in two ways:

• Upload a label set with a .csv , .tsv or .json format.

• Enter the labels in manually.

In the project, you can also click a label instance to jump directly to its corresponding bounding box and open the label box for that item.

Label set modification

If you created a project without a label set, you can add one anytime by:

• Dragging and dropping a label set file.

• Using the three-dot menu.

To edit an existing label set, click the three-dot menu and select Edit label set.

The Edit label set dialog will open, allowing you to update the label classes and their configuration.

To replace the current label set, click the three-dot menu and select Replace existing label set.

You can then upload a new label set file or create it from scratch.

Permissions

By default, both reviewers and labelers can modify label sets. To restrict this capability for labelers:

1. Go to File > Settings > Administrator.

2. Disable the Label set modification option.

Custom attributes for label classes

Each label class can include multiple custom attributes (questions). The question types are limited to text and dropdown. Each question can have a default answer.

To update custom attributes in a label set:

1. Open the label set editor.

   
2. Switch to the JSON tab.

   
3. Add or modify the questions field for the desired label class.

Modifying the type or internalId of existing questions is not supported because it can affect previously applied labels unexpectedly.

Question structure

The questions field can contain multiple questions with the following properties:

1. id: ID of the question.

2. label: The question name.

3. type: The type of question. It can be TEXT or DROPDOWN.

4. config: Configuration settings for the question.

   1. required: Determines whether the question must be answered. It can be true or false.

   2. defaultValue: The default answer for the question.

      1. For TEXT questions, it can be any text.

      2. For DROPDOWN questions, it must be an options.id value.

   3. multiline: Specifies if the TEXT question allows multiple lines. It can be true or false.

   4. options: An array of options for the DROPDOWN question, each containing:

      1. id: ID of the dropdown option. It can be used in the defaultValue.

      2. label: The text label for the dropdown option.

5. internalId: Read-only unique ID used internally by Datasaur.

For a detailed example, refer to the Label Sets documentation for a sample bounding box label set with custom attributes.