Copied
Docs

Contact Us

If you still have questions or prefer to get help directly from an agent, please submit a request.
We’ll get back to you as soon as possible.

Please fill out the contact form below and we will reply as soon as possible.

EMPLOYEE LOGIN
  • Home
  • Getting Started
  • Annotate
  • Tasks
  • API
  • Recipes
  • Tutorials
  • Integrations

Sensor Fusion JSON-delivery

Updated at January 10th, 2024

Submissions

Submission Id

Refers to a unique identifier that locates a specific submission
{
  "id": "646b7ff84948945cc0a03fff"
}
 
 

Project Id

A unique identifier that specifies which project this submission belongs to
{
  "project_id": 20329
}
 
 

Submission Dates

“created_at” indicates the date and time when the task was initially created
“delivered_at” specifies the date when the task was marked as delivered

📘Note

Marking a task as delivered is a manual action. If it's not set, delivered_at will default to null.

 
{
   "created_at":"2023-05-22T14:47:07.871Z",
   "delivered_at":2023-05-22T15:50:16.781Z
}
 
 

Submission State

Indicates the state of the task: new, in progress, completed, delivered, rejected, approved, acknowledged. Please see https://samakb.readme.io/reference/task-states for more details
{
   "state":"delivered"
}
 
 
 
 

Data

Input metadata

The input metadata offers essential information about the video, comprising a sequence of images that create the motion picture, along with its size, height, and width.
{
   "data":{
      "sensor-location":"https://assets.samasource.org/...",
      "right_camera Camera initial rotation":"[0,0,0]",
      "left_camera Camera initial rotation":"[0,0,0]",
      "center_camera Camera initial rotation":"[0,0,0]"
   }
}
 
 
 
 

Answers

To understand the 'answer' in this JSON, two concepts are key: 'workspace output' and 'shape output'.

  • Workspace Output: This is the collective data generated from a digital workspace, encompassing all activities, elements, and their results within that space.
  • Shape Outputs: These are detailed outputs related to graphical 'shapes' within the workspace, like cuboids, each with specific data such as size and color.

In this context, the "answers" element in the JSON acts as a repository that holds both the overall workspace output and the specific data related to individual shapes. This information is organized in a dictionary format using key-value pairs, making it easier to access and manage the diverse range of outputs generated in the workspace.

 

A fused annotation output refers to an integrated annotation data structure, which combines information from multiple sources or viewpoints, such as different camera angles (left, right, center cameras in this case). This fusion enhances the accuracy and completeness of the annotation.
 

  1. "answers" Object: This is the main container holding all annotation data.
  2. Camera Sections ("left_camera", "right_camera", "center_camera"):
    Each section contains an array of objects representing annotations from different camera perspectives.
    These sections allow annotations to be organized based on the source of the data (camera view).
  3. "shapes" array: 
    Within each camera section, there's an array of "shapes", which holds the details of each annotated object.
    Each shape object includes "tags" (like "object_class": "vehicle"), "type" (e.g., "rectangle"), and an "index" for identification.
  4. "key_locations" and "locations" arrays:
    1. These arrays contain detailed annotation data for each shape, including points defining the shape's geometry, visibility status, frame number, and additional tags like "occlusion" and "truncation".
    2. "key_locations" A key location signifies a shape in a frame that has been edited, including updates to its tags or adjustments to the shape itself. It acts as a marker for important changes or alterations made to the annotated shape in that particular frame.
  5. "group_type" and "frame_count": These fields offer details on the group responsible for the annotation of this task and the total count of frames involved in the annotation process.
{
   "answers":{
      "left_camera":[
         {
            "shapes":[
               {
                  "tags":{
                     "object_class":"vehicle"
                  },
                  "type":"rectangle",
                  "index":1,
                  "key_locations":[
                     {
                        "tags":{
                           "occlusion":"none",
                           "truncation":"none"
                        },
                        "points":[
                           [
                              1030,
                              513
                           ],
                           [
                              1252,
                              513
                           ],
                           [
                              1030,
                              613
                           ],
                           [
                              1252,
                              613
                           ]
                        ],
                        "visibility":1,
                        "frame_number":0
                     },
                     {
                        "points":[
                           [
                              1010,
                              512
                           ],
                           [
                              1237,
                              512
                           ],
                           [
                              1010,
                              615
                           ],
                           [
                              1237,
                              615
                           ]
                        ],
                        "visibility":1,
                        "frame_number":1
                     }
                  ]
               }
            ],
            "group_type":null,
            "frame_count":200
         }
      ],
      "right_camera":[
         {
            "shapes":[
               {
                  "tags":{
                     "object_class":"vehicle"
                  },
                  "type":"rectangle",
                  "index":1,
                  "key_locations":[
                     {
                        "points":[
                           [
                              750,
                              240
                           ],
                           [
                              1050,
                              240
                           ],
                           [
                              750,
                              375
                           ],
                           [
                              1050,
                              375
                           ]
                        ],
                        "visibility":0,
                        "frame_number":0
                     }
                  ],
                  "locations":[
                     {
                        "visibility":0
                     },
                     {
                        "visibility":0
                     }
                  ]
               }
            ],
            "group_type":null,
            "frame_count":200
         }
      ],
      "center_camera":[
         {
            "shapes":[
               {
                  "tags":{
                     "object_class":"vehicle"
                  },
                  "type":"rectangle",
                  "index":1,
                  "key_locations":[
                     {
                        "points":[
                           [
                              158,
                              505
                           ],
                           [
                              383,
                              505
                           ],
                           [
                              158,
                              603
                           ],
                           [
                              383,
                              603
                           ]
                        ],
                        "visibility":1,
                        "frame_number":0
                     },
                     {
                        "points":[
                           [
                              108,
                              501
                           ],
                           [
                              358,
                              501
                           ],
                           [
                              108,
                              607
                           ],
                           [
                              358,
                              607
                           ]
                        ],
                        "visibility":1,
                        "frame_number":2
                     }
                  ],
                  "locations":[
                     {
                        "visibility":1,
                        "points":[
                           [
                              158,
                              505
                           ],
                           [
                              383,
                              505
                           ],
                           [
                              158,
                              603
                           ],
                           [
                              383,
                              603
                           ]
                        ],
                        "tags":{
                           "truncation":"partial",
                           "occlusion":"none"
                        }
                     },
                     {
                        "visibility":1,
                        "points":[
                           [
                              133,
                              503
                           ],
                           [
                              371,
                              503
                           ],
                           [
                              133,
                              605
                           ],
                           [
                              371,
                              605
                           ]
                        ],
                        "tags":{
                           "truncation":"partial",
                           "occlusion":"none"
                        }
                     }
                  ]
               }
            ],
            "group_type":null,
            "frame_count":200
         }
      ]
   }
}

 

 
 

Shapes

Rectangle

A rectangle is a four-sided shape where each side is at a right angle to the adjacent sides. Is defined by four coordinates, arranged as [[x1,y1],[x1,y2],[x2,y1],[x2,y2]], where 
(x1,y1) and (x2,y2) are diagonal from each other. This structure ensures that opposite sides of the rectangle are parallel and equal in length, and all angles are right angles. In this JSON he rectangle is represented by the coordinates 
(2869,7) (3263,7), (2869,674) and (3263,674) These points correspond to the four corners of the rectangle, ensuring that opposite sides are equal and parallel, forming the right angles at each corner.
 
{
   "type":"rectangle",
   "index":9,
   "points":[
      [
         2869,
         7
      ],
      [
         3263,
         7
      ],
      [
         2869,
         674
      ],
      [
         3263,
         674
      ]
   ]
}
 
 

Index

The "index" refers to a unique identifier assigned to each shape, used to distinguish it from others in a sequence. It is a sequential number, meaning each shape is given a consecutive number based on its order in the sequence
{
   "index":1
}
 
 

Tag

Tags are descriptive attributes assigned to a shape to provide additional information or classification, depending on how the project is set up tags can be in different formats:

1. Multi-Level Menu: This tag uses a hierarchical format, like "category |sub category" indicating categories and subcategories.
2. Dropdown: A dropdown format, offers a selection from predefined options.
3. Radio Button: This format, allows for choosing one option from a set.
4. Checkbox: A nested structure with binary choices (0 or 1) to indicate features like "left," "none," or "right" roadside.

 

These varied tag formats provide detailed and specific information about the object, facilitating nuanced classification and understanding.

{
   "tags":{
      "object_class":"vehicle"
   }
}
 
 

Key Locations

Shape output

In the 3D world, shapes are made on specific objects within a scene, creating a list of 'shape outputs.' These are known as 'nested outputs' due to their hierarchical organization. They can be part of a larger workspace output or appear as nested objects in a JSON file

 

Tags

Tags are descriptive attributes assigned to a shape to provide additional information or classification, depending on how the project is set up tags can be in different formats:

1. Multi-Level Menu: This tag uses a hierarchical format, like "category|sub category," indicating categories and subcategories.
2. Dropdown: A dropdown format, offers a selection from predefined options.
3. Radio Button: This format, allows for choosing one option from a set.
4. Checkbox: A nested structure with binary choices (0 or 1) 
These varied tag formats provide detailed and specific information about the object, facilitating nuanced classification and understanding.

{
   "tags":{
      "occlusion":"none",
      "truncation":"none"
   }
}
 
 

Points

A rectangle is a four-sided shape where each side is at a right angle to the adjacent sides. Is defined by four coordinates, arranged as [[x1,y1],[x1,y2],[x2,y1],[x2,y2]], where 
(x1,y1) and (x2,y2) are diagonal from each other. This structure ensures that opposite sides of the rectangle are parallel and equal in length, and all angles are right angles. In this JSON the rectangle is represented by the coordinates 
(2869,7) (3263,7), (2869,674) and (3263,674) These points correspond to the four corners of the rectangle, ensuring that opposite sides are equal and parallel, forming the right angles at each corner.
{
   "type":"rectangle",
   "index":9,
   "points":[
      [
         2869,
         7
      ],
      [
         3263,
         7
      ],
      [
         2869,
         674
      ],
      [
         3263,
         674
      ]
   ]
}
 
 

Visibility

The 'visibility' element indicates the visibility of a shape in a given frame. A shape might be visible in one frame but obscured by another object in the next, rendering it invisible. However, it can reappear in subsequent frames. This element helps track the shape's visibility across different frames.

Visible

{
    "visibility": 1,
}

 

Not visible

{
    "visibility": 0,
}
 
 

Frame number

The 'frame_number' in a 'key_frame' represents its position within the overall sequence of frames
{
  "frame_number": 0
}
 
 
 
 
 
 

Locations

Locations indicate the frames that are interpolated between two key frames. If a shape isn't visible in a frame, its visibility value is set to 0, and there won't be any associated points array for that frame. That's way some locations are an empty array
Inside a location you find all shape outputs: visibility, points, and tags
{
   "locations":[
      {
         "visibility":1,
         "points":[
            [
               1294,
               519
            ],
            [
               1416,
               519
            ],
            [
               1294,
               587
            ],
            [
               1416,
               587
            ]
         ],
         "tags":{
            "truncation":"none",
            "occlusion":"none"
         }
      }
   ]
}
 
 

Group Type

Group type is defined in the project settings
{
  "group_type": null,
}
 
 

Frame Count

The 'frame_count' in a 'key_frame' represents its position within the overall sequence of frames
{
  "frame_count": 2
}
 
 
 
 

Check the complete JSON

[
   [
      {
         "id":"646b7ff84948945cc0a03fff",
         "project_id":20329,
         "created_at":"2023-05-22T14:47:07.871Z",
         "delivered_at":"2023-05-22T15:50:16.781Z",
         "state":"delivered",
         "data":{
            "sensor-location":"https://assets.org/...",
            "right_camera Camera initial rotation":"[0,0,0]",
            "left_camera Camera initial rotation":"[0,0,0]",
            "center_camera Camera initial rotation":"[0,0,0]"
         },
         "answers":{
            "left_camera":[
               {
                  "shapes":[
                     {
                        "tags":{
                           "object_class":"vehicle"
                        },
                        "type":"rectangle",
                        "index":1,
                        "key_locations":[
                           {
                              "tags":{
                                 "occlusion":"none",
                                 "truncation":"none"
                              },
                              "points":[
                                 [
                                    1030,
                                    513
                                 ],
                                 [
                                    1252,
                                    513
                                 ],
                                 [
                                    1030,
                                    613
                                 ],
                                 [
                                    1252,
                                    613
                                 ]
                              ],
                              "visibility":1,
                              "frame_number":0
                           }
                        ],
                        "locations":[
                           {
                              "visibility":1,
                              "points":[
                                 [
                                    1294,
                                    519
                                 ],
                                 [
                                    1416,
                                    519
                                 ],
                                 [
                                    1294,
                                    587
                                 ],
                                 [
                                    1416,
                                    587
                                 ]
                              ],
                              "tags":{
                                 "truncation":"none",
                                 "occlusion":"none"
                              }
                           }
                        ]
                     }
                  ],
                  "group_type":null,
                  "frame_count":2
               },
               {
                  "shapes":[
                     {
                        "tags":{
                           "object_class":"vehicle"
                        },
                        "type":"rectangle",
                        "index":3,
                        "key_locations":[
                           {
                              "tags":{
                                 "occlusion":"none",
                                 "truncation":"none"
                              },
                              "points":[
                                 [
                                    1294,
                                    519
                                 ],
                                 [
                                    1416,
                                    519
                                 ],
                                 [
                                    1294,
                                    587
                                 ],
                                 [
                                    1416,
                                    587
                                 ]
                              ],
                              "visibility":1,
                              "frame_number":0
                           }
                        ]
                     }
                  ],
                  "group_type":null,
                  "frame_count":2
               }
            ],
            "right_camera":[
               {
                  "shapes":[
                     {
                        "tags":{
                           "object_class":"vehicle"
                        },
                        "type":"rectangle",
                        "index":1,
                        "key_locations":[
                           {
                              "tags":{
                                 "occlusion":"none",
                                 "truncation":"none"
                              },
                              "points":[
                                 [
                                    750,
                                    240
                                 ],
                                 [
                                    1050,
                                    240
                                 ],
                                 [
                                    750,
                                    375
                                 ],
                                 [
                                    1050,
                                    375
                                 ]
                              ],
                              "visibility":0,
                              "frame_number":0
                           }
                        ],
                        "locations":[
                           {
                              "visibility":0
                           }
                        ]
                     }
                  ],
                  "group_type":null,
                  "frame_count":2
               },
               {
                  "shapes":[
                     {
                        "tags":{
                           "object_class":"vehicle"
                        },
                        "type":"rectangle",
                        "index":3,
                        "key_locations":[
                           {
                              "tags":{
                                 "occlusion":"none",
                                 "truncation":"none"
                              },
                              "points":[
                                 [
                                    750,
                                    240
                                 ],
                                 [
                                    1050,
                                    240
                                 ],
                                 [
                                    750,
                                    375
                                 ],
                                 [
                                    1050,
                                    375
                                 ]
                              ],
                              "visibility":0,
                              "frame_number":0
                           }
                        ],
                        "locations":[
                           {
                              "visibility":0
                           }
                        ]
                     }
                  ],
                  "group_type":null,
                  "frame_count":2
               }
            ],
            "center_camera":[
               {
                  "shapes":[
                     {
                        "tags":{
                           "object_class":"vehicle"
                        },
                        "type":"rectangle",
                        "index":1,
                        "key_locations":[
                           {
                              "points":[
                                 [
                                    158,
                                    505
                                 ],
                                 [
                                    383,
                                    505
                                 ],
                                 [
                                    158,
                                    603
                                 ],
                                 [
                                    383,
                                    603
                                 ]
                              ],
                              "visibility":1,
                              "frame_number":0
                           }
                        ],
                        "locations":[
                           {
                              "visibility":1,
                              "points":[
                                 [
                                    158,
                                    505
                                 ],
                                 [
                                    383,
                                    505
                                 ],
                                 [
                                    158,
                                    603
                                 ],
                                 [
                                    383,
                                    603
                                 ]
                              ],
                              "tags":{
                                 "truncation":"partial",
                                 "occlusion":"none"
                              }
                           }
                        ]
                     }
                  ],
                  "group_type":null,
                  "frame_count":2
               },
               {
                  "shapes":[
                     {
                        "tags":{
                           "object_class":"vehicle"
                        },
                        "type":"rectangle",
                        "index":3,
                        "key_locations":[
                           {
                              "points":[
                                 [
                                    426,
                                    515
                                 ],
                                 [
                                    530,
                                    515
                                 ],
                                 [
                                    426,
                                    576
                                 ],
                                 [
                                    530,
                                    576
                                 ]
                              ],
                              "visibility":1,
                              "frame_number":0
                           }
                        ],
                        "locations":[
                           {
                              "visibility":1,
                              "points":[
                                 [
                                    426,
                                    515
                                 ],
                                 [
                                    530,
                                    515
                                 ],
                                 [
                                    426,
                                    576
                                 ],
                                 [
                                    530,
                                    576
                                 ]
                              ],
                              "tags":{
                                 "occlusion":"none",
                                 "truncation":"none"
                              }
                           }
                        ]
                     }
                  ],
                  "group_type":null,
                  "frame_count":2
               }
            ]
         }
      }
   ]
]
 
 

Course Home

←  Orthographic Shapes JSON-delivery
json transfer sensor merging

Was this article helpful?

Yes
No
Give feedback about this article

The first B Corp-certified AI company

  • Security
  • Terms
  • Privacy
  • Quality & Information

Copyright © 2023 Samasource Impact Sourcing, Inc. All rights reserved.


Knowledge Base Software powered by Helpjuice

Expand