Bounding box

A Bounding box is an Object-type annotation that contains 4 coordinates on a rectangular border.

Import

When you import Bounding box annotations via the Model-assisted labeling or Import ground truth workflow, your JSON file must contain the following information for each Bounding box.

Parameter

Asset type

Required

Description

uuid

Image, Tiled imagery

Yes

A user-generated UUID for each annotation. If you import an annotation to a Data Row and there is already an imported annotation with the same uuid on that Data Row, the latest import will override the previous one. The uuid must be 128 bits (32 characters). The following formats are supported:

  • A0EEBC99-9C0B-4EF8-BB6D-6BB9BD380A11

  • {a0eebc99-9c0b-4ef8-bb6d-6bb9bd380a11}

  • a0eebc999c0b4ef8bb6d6bb9bd380a11

  • a0ee-bc99-9c0b-4ef8-bb6d-6bb9-bd38-0a11

  • {a0eebc99-9c0b4ef8-bb6d6bb9-bd380a11}

schemaId

Image, Tiled imagery

Yes

The ID of the schema that contains all of the information needed for rendering your annotation.

dataRow.id

Image, Tiled imagery

Yes

The ID of the Data Row where you want to attach the imported annotations.

polygon.x

Image, Tiled imagery

Yes

x-coordinate for a single point on the Polygon annotation. For Tiled imagery, this value is the longitude.

polygon.y

Image, Tiled imagery

Yes

y-coordinate for a single point on the Polygon annotation. For Tiled imagery, this value is the latitude.

{
    "uuid": "efca0c21-5206-4da6-8cb5-d6ca43649cfa",
    "schemaId": "ck67grts29n7x0890atmeiahw",
    "dataRow": {
         "id": "cjxav4aa07r1g0dsq70t9eveg"
     },
     "bbox": {
         "top": 153,
         "left": 34,
         "height": 204,
         "width": 67
     }
}
{
    "uuid": "efca0c21-5206-4da6-8cb5-d6ca43649cfa",
    "schemaId": "ck67grts29n7x0890atmeiahw",
    "dataRow": {
         "id": "cjxav4aa07r1g0dsq70t9eveg"
     },
     "bbox": {
         "top": 153,
         "left": 34,
         "height": 204,
         "width": 67
     }
}

Export

When you export your Bounding box annotations from Labelbox, the export file will contain the following information for each Bounding box.

Parameter

Asset type

Description

schemaId

Image, Video, Tiled imagery

The ID of the schema containing all of the information needed for rendering your annotation.

featureId

Image, Video, Tiled imagery

ID of the annotation.

title

Image, Video, Tiled imagery

Name of the annotation in the ontology.

color

Image, Video, Tiled imagery

Color of the annotation in the ontology.

bbox.top

Image, Video

y-coordinate of Bounding box top-left corner.

bbox.left

Image, Video

x-coordinate of Bounding box top-left corner.

bbox.height

Image, Video

Height of Bounding box in pixels.

bbox.width

Image, Video

Width of Bounding box in pixels.

instanceURI

Image

Annotation information hosted on Labelbox servers.

keyframe

Video

When keyframe is true, it means that a labeler created or made an adjustment to the annotation on that frame. When keyframe is false, it means the annotation was auto-populated or interpolated on that frame.

type

Tiled imagery

Annotation type. Value should by rectangle.

geometry.coordinates

Tiled imagery

Longitude and latitude, in that order.

{
    "featureId": "ck9bmeej61emf0yf5bgjb4tjw",
    "schemaId": "ck9blmq1lnlxw08895jy7zsk4",
    "title": "Blue bird",
    "value": "blue_bird",
    "color": "#FF8000",
    "bbox": {
        "top": 186,
        "left": 192,
        "height": 300,
        "width": 519
    }
}
{
    "featureId": "ck9bmeej61emf0yf5bgjb4tjw",
    "schemaId": "ck9blmq1lnlxw08895jy7zsk4",
    "title": "Car 1",
    "value": "car_1",
    "color": "#1CE6FF",
    "keyframe": false,
    "bbox": {
        "top": 1164,
        "left": 2538,
        "height": 222,
        "width": 119
    }
}
{
    "featureId": "ckossvopo00013h68phgicget",
    "schemaId": "ckosstz24fhch0yag6h6k6vem",
    "title": "bbox",
    "value": "bbox",
    "color": "#1CE6FF",
    "type": "rectangle",
    "geometry": {
        "coordinates": [
            [
                [
                    151.20171129670584,
                    -33.86658193385505
                ],
                [
                    151.20171129670584,
                    -33.86615404807865
                ],
                [
                    151.20256960353075,
                    -33.86615404807865
                ],
                [
                    151.20256960353075,
                    -33.86658193385505
                ],
                [
                    151.20171129670584,
                    -33.86658193385505
                ]
            ]
        ]
    }
}

Did this page help you?