Bounding Box Labels
Last updated
Last updated
A core extension to 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:
Upload a label set with a .csv
, .tsv
or .json
format
Type the labels in manually
You can now click on a label instance to automatically jump to the corresponding bounding box and open the labelbox for that item.
If you've created a project but forgot to add a label set, no worries. 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 for your Labelers, you can adjust it in File > Settings > Administrator and toggle off the option.
Each label class in the label set can have multiple custom attributes (questions). The question types are limited to Text and Dropdown only. Each question can also have a default answer.
To modify the custom attributes within the label set, follow these steps:
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.
Switch to the JSON tab.
Add or modify the questions
field as needed for each label class.
💡 We do not support the modification of the type
and internalId
value 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:
id: ID of the question.
label: The question name.
type: The type of question. It can be TEXT
or DROPDOWN
.
config: Configuration settings for the question
required: Determines whether the question must be answered. It can be true
or false
.
defaultValue: The default answer for the question
For TEXT
questions, it can be any text.
For DROPDOWN
questions, it must be an options.id
value.
multiline: Specifies if the TEXT
question allows multiple lines. It can be true
or false
.
options: An array of options for the DROPDOWN
question, each containing:
id: ID of the dropdown option. It can be used in the defaultValue
.
label: The text label for the dropdown option.
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.