Bounding Box Labels

Bounding Box Labels

A core extension to the Bounding Box Labeling project, the Bounding Box Labels extension contains the label set or taxonomy used for the project. There are two ways to add a label set:

1. Upload a label set with a .csv , .tsv or .jsonformat

2. Type the labels in manually

You can now click on a label instance to automatically jump to the corresponding bounding box and open the label box for that item.

Label Set Modification

If you've created a project but forgot to add a label set, there is no need for concern. You can either drag and drop or click the three-dot button to include a new label set.

If you've initially set up a label set while creating a bounding box project but need to make edits, simply click the three-dot button and select 'Edit label set'. This will open a pop-up section where you can make your edits.

If you need to replace the current label set, you can do so by clicking the three dots and choosing 'Replace existing label set'. This will provide a drag-and-drop area where you can upload your desired label set.

By default, both Reviewers and Labelers have access to these capabilities. However, if you prefer to restrict this capability (modifying label sets) for your Labelers, you can adjust it in File > Settings > Administrator and toggle off the option.

Custom Attributes for Label Classes

Each label class in the label set can have multiple custom attributes (questions). The question types are limited to Text and Dropdown. Each question can also have a default answer.

To modify the custom attributes within the label set, follow these steps:

1. Open the label set editor via Add new label set, Edit label set, or Replace existing label set. Please check the Label Set Modification section above.

   
2. Switch to the JSON tab.

   
3. Add or modify the questions field as needed for each label class.

   💡 We do not support the modification of the type and internalId values of existing questions, as it will affect labels that are already applied in unexpected ways.

   To add questions, include a questions field in the desired label class within the JSON structure. The questions field can contains multiple data with the following structures:

   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: readonly, unique id Datasaur uses to keep track of each individual question

   For a detailed example, refer to the Label Sets section for a sample of the BBox label set with custom attributes.