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

3D Cuboid 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 lines or polygons, 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.
 

{
   "answers":{
      "Scene":[
         {
            "shapes":[
               
            ]
         }
      ]
   }
}
 
 

Shapes

Cuboid

A 3D cuboid, is a three-dimensional geometric shape characterized by six rectangular faces.
Read more
{
   "points":[
      [
         10.1042,
         6.20588,
         -0.83359
      ],
      [
         10.0701,
         6.24026,
         0.7481
      ],
      [
         10.04102,
         8.03873,
         -0.87478
      ],
      [
         10.00692,
         8.07311,
         0.70691
      ],
      [
         14.89862,
         6.37339,
         -0.73387
      ],
      [
         14.86452,
         6.40777,
         0.84782
      ],
      [
         14.83544,
         8.20624,
         -0.77506
      ],
      [
         14.80134,
         8.24062,
         0.80663
      ]
   ]
}
 
 

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, providing a structured way to represent 3D annotations
 

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

The points represent the vertices (corners) of a 3D cuboid in a three-dimensional coordinate system. Each point is given as a set of three coordinates (x,y,z), indicating the position of a vertex in 3D space
A 3D cuboid has eight vertices. 


Understanding the Coordinates
X-coordinate: Indicates the position along the horizontal axis.
Y-coordinate: Represents the position along the vertical axis.
Z-coordinate: Shows the depth or height of the point in the third dimension.

 

The provided points are these vertices. Each vertex is a unique intersection of three edges of the cuboid.
 

{
   "points":[
      [
         10.1042,
         6.20588,
         -0.83359
      ],
      [
         10.0701,
         6.24026,
         0.7481
      ],
      [
         10.04102,
         8.03873,
         -0.87478
      ],
      [
         10.00692,
         8.07311,
         0.70691
      ],
      [
         14.89862,
         6.37339,
         -0.73387
      ],
      [
         14.86452,
         6.40777,
         0.84782
      ],
      [
         14.83544,
         8.20624,
         -0.77506
      ],
      [
         14.80134,
         8.24062,
         0.80663
      ]
   ]
}
 
 

Direction

Provides the orientation of the cuboid in terms of roll, pitch, and yaw angles
{
   "direction":{
      "roll":0.02246403250543165,
      "pitch":0.02078386006783126,
      "yaw":-3.106668390676402
   }
}
 
 

Dimension

Specifies the cuboid's length, width, and height

 

{
   "dimensions": {
         "length": 4.79838168707951,
         "width": 1.834401115078161,
         "height": 1.582431057108018
      }
}

 

 
 

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
}
 
 

Position center

The central point of the cuboid in 3D space

 

{
  "position_center": [12.45277, 7.22325, -0.01348]
}
 
 
 
 
 
 

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, tags, position center, direction, and dimension.
{
  "locations": {
      "visibility": 1,
      "points": [
         [10.1042, 6.20588, -0.83359],
         [10.0701, 6.24026, 0.7481],
         [10.04102, 8.03873, -0.87478],
         [10.00692, 8.07311, 0.70691],
         [14.89862, 6.37339, -0.73387],
         [14.86452, 6.40777, 0.84782],
         [14.83544, 8.20624, -0.77506],
         [14.80134, 8.24062, 0.80663]
      ],
      "tags": {
         "occlusion": "none",
         "truncation": "none"
      },
      "position_center": [12.45277, 7.22325, -0.01348],
      "direction": {
         "roll": 0.02246403250543165,
         "pitch": 0.02078386006783126,
         "yaw": -3.106668390676402
      },
      "dimensions": {
         "length": 4.79838168707951,
         "width": 1.834401115078161,
         "height": 1.582431057108018
      }
   }
}
 
 

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":{
            "Scene":[
               {
                  "shapes":[
                     {
                        "tags":{
                           "object_class":"vehicle"
                        },
                        "type":"cuboid",
                        "index":0,
                        "key_locations":{
                           "tags":{
                              "occlusion":"none",
                              "truncation":"none"
                           },
                           "points":[
                              [
                                 10.1042,
                                 6.20588,
                                 -0.83359
                              ],
                              [
                                 10.0701,
                                 6.24026,
                                 0.7481
                              ],
                              [
                                 10.04102,
                                 8.03873,
                                 -0.87478
                              ],
                              [
                                 10.00692,
                                 8.07311,
                                 0.70691
                              ],
                              [
                                 14.89862,
                                 6.37339,
                                 -0.73387
                              ],
                              [
                                 14.86452,
                                 6.40777,
                                 0.84782
                              ],
                              [
                                 14.83544,
                                 8.20624,
                                 -0.77506
                              ],
                              [
                                 14.80134,
                                 8.24062,
                                 0.80663
                              ]
                           ],
                           "source":{
                              "source_id":"pre_annotation"
                           },
                           "direction":{
                              "roll":0.02246403250543165,
                              "pitch":0.02078386006783126,
                              "yaw":-3.106668390676402
                           },
                           "dimensions":{
                              "length":4.79838168707951,
                              "width":1.834401115078161,
                              "height":1.582431057108018
                           },
                           "visibility":1,
                           "frame_number":0,
                           "position_center":[
                              12.45277,
                              7.22325,
                              -0.01348
                           ]
                        },
                        "locations":{
                           "visibility":1,
                           "points":[
                              [
                                 10.1042,
                                 6.20588,
                                 -0.83359
                              ],
                              [
                                 10.0701,
                                 6.24026,
                                 0.7481
                              ],
                              [
                                 10.04102,
                                 8.03873,
                                 -0.87478
                              ],
                              [
                                 10.00692,
                                 8.07311,
                                 0.70691
                              ],
                              [
                                 14.89862,
                                 6.37339,
                                 -0.73387
                              ],
                              [
                                 14.86452,
                                 6.40777,
                                 0.84782
                              ],
                              [
                                 14.83544,
                                 8.20624,
                                 -0.77506
                              ],
                              [
                                 14.80134,
                                 8.24062,
                                 0.80663
                              ]
                           ],
                           "tags":{
                              "occlusion":"none",
                              "truncation":"none"
                           },
                           "position_center":[
                              12.45277,
                              7.22325,
                              -0.01348
                           ],
                           "direction":{
                              "roll":0.02246403250543165,
                              "pitch":0.02078386006783126,
                              "yaw":-3.106668390676402
                           },
                           "dimensions":{
                              "length":4.79838168707951,
                              "width":1.834401115078161,
                              "height":1.582431057108018
                           }
                        }
                     }
                  ],
                  "group_type":null,
                  "frame_count":2
               },
               {
                  "shapes":[
                     {
                        "tags":{
                           "object_class":"vehicle"
                        },
                        "type":"cuboid",
                        "index":0,
                        "key_locations":{
                           "tags":{
                              "occlusion":"none",
                              "truncation":"none"
                           },
                           "points":[
                              [
                                 20.99287,
                                 6.29963,
                                 -0.67235
                              ],
                              [
                                 20.98708,
                                 6.36483,
                                 1.05708
                              ],
                              [
                                 20.99422,
                                 8.15865,
                                 -0.74243
                              ],
                              [
                                 20.98842,
                                 8.22385,
                                 0.987
                              ],
                              [
                                 25.61348,
                                 6.29687,
                                 -0.65676
                              ],
                              [
                                 25.60768,
                                 6.36207,
                                 1.07267
                              ],
                              [
                                 25.61482,
                                 8.15589,
                                 -0.72684
                              ],
                              [
                                 25.60903,
                                 8.22109,
                                 1.00259
                              ]
                           ],
                           "source":{
                              "source_id":"pre_annotation"
                           },
                           "direction":{
                              "roll":0.03767993418056637,
                              "pitch":0.003372184823309683,
                              "yaw":3.140997147403339
                           },
                           "dimensions":{
                              "length":4.620627124720197,
                              "width":1.860340926389568,
                              "height":1.730668278151536
                           },
                           "visibility":1,
                           "frame_number":0,
                           "position_center":[
                              23.30095,
                              7.26036,
                              0.16512
                           ]
                        },
                        "locations":{
                           "visibility":1,
                           "points":[
                              [
                                 20.99287,
                                 6.29963,
                                 -0.67235
                              ],
                              [
                                 20.98708,
                                 6.36483,
                                 1.05708
                              ],
                              [
                                 20.99422,
                                 8.15865,
                                 -0.74243
                              ],
                              [
                                 20.98842,
                                 8.22385,
                                 0.987
                              ],
                              [
                                 25.61348,
                                 6.29687,
                                 -0.65676
                              ],
                              [
                                 25.60768,
                                 6.36207,
                                 1.07267
                              ],
                              [
                                 25.61482,
                                 8.15589,
                                 -0.72684
                              ],
                              [
                                 25.60903,
                                 8.22109,
                                 1.00259
                              ]
                           ],
                           "tags":{
                              "occlusion":"none",
                              "truncation":"none"
                           },
                           "position_center":[
                              23.30095,
                              7.26036,
                              0.16512
                           ],
                           "direction":{
                              "roll":0.03767993418056637,
                              "pitch":0.003372184823309683,
                              "yaw":3.140997147403339
                           },
                           "dimensions":{
                              "length":4.620627124720197,
                              "width":1.860340926389568,
                              "height":1.730668278151536
                           }
                        }
                     }
                  ],
                  "group_type":null,
                  "frame_count":2
               }
            ]
         }
      }
   ]
]
 
 

Course Home

←  Video Instance Segmentation JSON-delivery Orthographic Shapes JSON-delivery  →

 

json 3d cuboid delivery

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