Guide for labeling image data.
When you attach an image dataset to a project, Labelbox will automatically adjust the editor interface for image labeling.
Import image data
To learn how to import image data to Labelbox, visit our docs on importing images.
Max data row size
64MP is the max accepted data row size.
Supported annotation types
Below are the annotation types that you may include in your ontology for labeling image data. Classification-type annotations can be applied at the global level or nested within an object-type annotation.
|Feature||Import annotation||Export annotation|
|Bounding box||See payload||See payload|
|Cuboid||Coming soon||See payload|
|Segmentation mask||See payload||See payload|
|Polygon||See payload||See payload|
|Polyline||See payload||See payload|
|Point||See payload||See payload|
|Relationship||See payload||See payload|
|Radio classification||See payload||See payload|
|Checklist classification||See payload||See payload|
|Free-form text classification||See payload||See payload|
Create a bounding box by starting at one corner and dragging your cursor to create the shape around an object in the image.
You can also click and drag to reposition the bounding box on the image.
Create a cuboid by starting at one corner and dragging your cursor to create a box shape around an object in the image. Once you release it, it will automatically become a cuboid.
You can use the various levers on the tool to adjust its rotation along the x, y, and z axes. Along the center of the top bar, you will find buttons to switch to Rotate mode,Move mode, or Scale mode.
You can also directly input the rotation into the modal that appears in the ontology pane once the cuboid is initially drawn or selected for editing.
The fields available to edit are:
- Scale: this controls the size of the cuboid in each dimension. The unit is in pixels.
- Rotate: this controls the rotation of the cuboid along the three axes. For more details on the rotation, please refer to the diagram below.
When you are labeling an image with a segmentation mask, you have a handful of tools to help you create mask annotations more efficiently. (Note: Users of the former superpixel tool are recommended to use the new auto-segment tool.)
Empty mask error
If you receive an error message that reads, “The object is missing selected pixels. You should relabel or delete this object”, it means that the mask is considered empty.
By definition, a segmentation mask cannot have overlapping pixels. Thus, drawing a second mask fully within the first one creates an empty mask, resulting in this warning message.
You can use the auto-segment tool to generate mask predictions for individual objects in your image. The auto-segment tool is designed for instance segmentation, meaning it’s meant for fast labeling of individual objects as it is predicting one class at a time.
When a segmentation tool is selected, choose the auto-segment option from the top navigation bar, and draw a box around the object you want to label. For best results, draw the boundary of the box close to the object edges. You can also adjust the brightness and contrast settings in the Adjustments menu in the top navigation bar to further improve results. Creating more contrast between the object you are labeling and its background will help the model detect the object with greater accuracy.
The auto-segment tool currently uses a proprietary model to generate predictions. Alternate models cannot yet be used with the auto-segment tool.
Use the pen tool to outline the item in the image. Hold the cursor down to draw freehand or let the cursor go to draw straight lines between points. The pen tool is only available when creating segmentation annotations. Click the pen icon with the plus sign to use the pen tool.
You can use the erase tool to clean up the edges of a segmentation mask. Click the pen icon with the minus sign to use the erase tool.
You can use the fill tool to easily label backgrounds or, otherwise, assign a segmentation annotation to all other pixels in the image that have not already been labeled. The fill tool is only enabled for segmentation annotations.
Click the droplet icon to use the fill tool.
Create a polygon annotation by clicking to create each point in the shape. Click the first point to close the polygon.
Use the polyline tool to label lines in an image. Click on the last point to complete the shape.
Use the point tool to label precise locations on the image.
To create a relationship between annotations, select a relationship tool and hover over the annotation where you want the relationship to start to reveal the annotation's anchor points. Click an anchor point to create the starting point of the relationship, then bring your mouse over to the annotation you want to relate it to, hovering over it to reveal its anchor points. Finally, click one of the anchor points to complete the relationship.
Right-click a relationship to change its direction, make it bi-directional, or delete it from the asset.
Updated 4 days ago