Points can be used to identify joints in pose detection tasks or to help localize small objects.

Import

Python SDK

Point is a type of ObjectAnnotation

Definition

Point(x=x, y=y)

Parameter

Value

x

An integer

y

An integer

Supported data types

Data type

Supported

Image, Video, Tiled imagery

Yes

ObjectAnnotation(
  name = "point",
  value = Point(x=10, y=10),
)
ObjectAnnotation(
  name = "point_geospatial",
  value = Point(x=-99.21052827588443, y=19.405662413477728),
)

Format convertors

Method

Usage

Comments

from_shapely()

Point.from_shapely(shapely_object)

Transforms a shapely object. Learn more about shapely

NDJSON

NDJSON format is recommended if an annotation type is not yet supported in Python SDK or if you are unable to use the Python environment.

Definition

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.

point.x

Image
Tiled imagery

Yes

x-coordinate for the Point annotation. For Tiled imagery, this value is the longitude.

point.y

Image
Tiled imagery

Yes

y-coordinate for the Point annotation. For Tiled imagery, this value is the latitude.

Supported data types

Data type

Supported

Image

Yes

Tiled imagery

Yes

Video

Yes (in a segment)

Format

{
    "uuid": "532953e6-746f-4d74-945d-b4a9c2786479",
    "schemaId": "ck68grts29n800890roip3u5d",
    "dataRow": {
         "id": "cjxav5aa07r1g0dsq70t9eveg"
     },
     "point": {
         "x": 30,
         "y": 150
     }
}
{
    "uuid": uuid,
    "schemaId": schema_id,
    "dataRow": {
      "id": datarow_id
    },
    "segments": [
      {
        "keyframes": [
          {
            "frame": 5,
            "point": {
              "x": 80,
              "y": 80
            }
          },
          {
            "frame": 12,
            "point": {
              "x": 100,
              "y": 100
            }
          },
          {
            "frame": 20,
            "point": {
              "x": 125,
              "y": 125
            }
          }
        ]
      },
      {
        "keyframes": [
          {
            "frame": 22,
            "point": {
              "x": 50,
              "y": 50
            }
          },
          {
            "frame": 25,
            "point": {
              "x": 75,
              "y": 75
            }
          }
        ]
      },
      {
        "keyframes": [
          {
            "frame": 27,
            "point": {
              "x": 80,
              "y": 50
            }
          }
        ]
      }
    ]
  }
{
    "uuid": "532953e6-746f-4d74-945d-b4a9c2786479",
    "schemaId": "ck68grts29n800890roip3u5d",
    "dataRow": {
         "id": "cjxav5aa07r1g0dsq70t9eveg"
     },
     "point": {
         "x": -99.21052827588443,
         "y": 19.405662413477728
     }
}

Export

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

Python SDK

The export format of the polygon is similar to the import format.

Learn more about exporting annotations using the SDK here

JSON

You will receive a JSON file when you generate an export from the app.

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.

point.x

Image
Video

x coordinate for Point annotation.

point.y

Image
Video

y coordinate for Point annotation.

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

geometry.coordinates

Tiled imagery

Longitude and latitude, in that order.

Format

{
    "featureId": "ck9bmemy91hic10bogwc6sygv",
    "schemaId": "ck9blmq1lnlxy0889stzln2ms",
    "title": "Bird eye",
    "value": "bird_eye",
    "color": "#D4FF00",
    "point": {
        "x": 116,
        "y": 98
    },
    "instanceURI": "https://api.labelbox.com/masks/feature/ckmuuw0st00043g68jfguoplb?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ1c2VySWQiOiJjazUycnZ4MWtxYXpiMDc3MDBtcTI3eDRsIiwib3JnYW5pemF0aW9uSWQiOiJjazUycnZ4MG1wdzRnMDc2NndncXZqdGw5IiwiaWF0IjoxNjE3MDM4NDAwLCJleHAiOjE2MTk2MzA0MDB9.5YaORL6mWpPqgAb6IbWChm4MQo14obOU8LFWbfCEHR0"
}
{
    "featureId": "ckmv0r56g00023g68s2dgru6l",
    "schemaId": "cklifp8jw0tn40y5p3xtr2kk2",
    "title": "right_ear",
    "value": "right_ear",
    "color": "#1CE6FF",
    "keyframe": true,
    "point": {
        "x": 943,
        "y": 500
}
{
    "featureId": "cknjemyt800073g68xh4fsxeu",
    "schemaId": "cknjemcpt0l4n0y92d3oo7no3",
    "title": "test3",
    "value": "test3",
    "color": "#FF4A46",
    "type": "point",
    "geometry": {
        "coordinates": [
            -99.20951155086122,
            19.404749976992253
        ]
    }
}