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
]
}
}