Documentation
  • Introduction
  • Tutorials
    • Getting started
    • Python SDK quickstart
    • Model-assisted labeling
  • How to annotate
    • Label images
      • View and navigate in the image interfaces
      • Image interface settings
      • Image segmentation interface
      • Image vector interface
    • Label 3D point clouds
      • View and navigate in the 3D interface
      • Upload, view, and overlay images
      • 3D interface settings
      • 3D point cloud cuboid interface
      • 3D point cloud vector interface
      • 3D point cloud segmentation interface
      • Merged point cloud view (for static objects)
      • Batch mode (for dynamic objects)
      • Smart cuboid propagation
      • 3D to 2D Projection
      • Tips for labeling cuboid sequences
    • Label sequences of data
      • Use track IDs in sequences
      • Use keyframe interpolation
    • Annotate object links (beta)
    • Customize hotkeys
  • How to manage
    • Add collaborators to a dataset
    • Create an organization
    • Configure the label editor
    • Customize label queue
    • Search within a dataset
    • Clone a dataset
    • Work with issues
    • Bulk change label status
    • Manage QA processes
  • How to integrate
    • Import data
      • Cloud integrations
    • Export data
      • Structure of the release file
      • Exporting image annotations to different formats
    • Integrations
      • Hugging Face
      • W&B
      • Databricks
      • SceneBox
    • Create an API key
    • Upload model predictions
    • Set up webhooks
  • Background
    • Main concepts
    • Sequences
    • Label queue mechanics
    • Labeling metrics
    • 3D Tiles
    • Security
  • Reference
    • Python SDK
    • Task types
    • Sample formats
      • Supported file formats
    • Label formats
    • Categories and attributes
    • API
Powered by GitBook
On this page
  • Create a new cuboid
  • Create a cuboid with default dimensions
  • Draw a cuboid with custom dimensions
  • Remove a cuboid
  • Select a cuboid
  • Using the "Select and edit" tool
  • Using the objects sidebar
  • Change the dimensions of a cuboid
  • Translate a cuboid
  • Rotate a cuboid
  • Change the heading of a cuboid
  • Edit cuboid information
  • Change the category of a cuboid
  • Using the category dropdown
  • Using the category hotkey
  • Cycle between cuboids / select the next cuboid
  • Copy/paste a cuboid
  • Copy a cuboid
  • Paste a cuboid

Was this helpful?

  1. How to annotate
  2. Label 3D point clouds

3D point cloud cuboid interface

Previous3D interface settingsNext3D point cloud vector interface

Last updated 1 year ago

Was this helpful?

When through the Python SDK, choose pointcloud-cuboid or pointcloud-cuboid-sequence as the task_type to use this labeling interface

Tip: to make sure the 3D point cloud interface runs smoothly.

Create a new cuboid

Create a cuboid with default dimensions

  1. Select the "Create cuboid" tool by clicking on the box icon in the toolbar on the left, or by pressing the hotkey (b by default).

  2. Double click in the perspective view or in the top view to create a new cuboid. This cuboid will have the default dimensions of the current category. When you change the category, the dimensions of the cuboid will change as well, given that you have not altered the dimensions of the cuboid yet.

Draw a cuboid with custom dimensions

You can quickly draw a cuboid with an arbitrary rotation using our 3-click cuboid drawing method.

  1. Select the "Create cuboid" tool by clicking on the box icon in the toolbar on the left, or by pressing the hotkey (b by default).

  2. Click in the perspective view or in the top view to set the back corner of the new cuboid.

  3. When you move your mouse, the back side of the cuboid will follow your mouse position. Click to set the second corner of the cuboid.

  4. Next, you can extend the cuboid by moving your mouse. Click to complete the cuboid. After clicking, the new cuboid is added to the objects sidebar on the right.

Remove a cuboid

  1. Select the cuboid you want to remove.

  2. Press the hotkey (Backspace by default) or click the trash icon next to the object in the objects sidebar on the right.

Select a cuboid

Using the "Select and edit" tool

  1. Select the "Select and edit" tool by clicking on the pointer icon in the toolbar on the left, or by pressing the hotkey (Esc by default).

  2. Click on the cuboid in any view.

Using the objects sidebar

  1. Click on the object in the objects sidebar to select it.

Change the dimensions of a cuboid

  1. Select the "Select and edit" tool by clicking on the pointer icon in the toolbar on the left, or by pressing the hotkey (Esc by default).

  2. Select the cuboid you want to change.

  3. Change the cuboid's dimensions by using the hotkeys (i, j, k, l, u, o by default) or by using your mouse:

    • In the perspective view: click and drag a face of the cuboid.

    • In a side view: click and drag one of the edges of the cuboid.

Translate a cuboid

  1. Select the "Select and edit" tool by clicking on the pointer icon in the toolbar on the left, or by pressing the hotkey (Esc by default).

  2. Select the cuboid you want to translate.

  3. Translate the cuboid by using the hotkeys (w, a, s, d, Shift + W, Shift + S by default) or by using your mouse:

    • Click and drag the yellow cube in the middle of the cuboid to translate the cuboid freely.

    • Hover over the yellow cube in the middle to see the translation axes. Click and drag on an axis to translate the cuboid along the selected axis.

Rotate a cuboid

By default, only yaw rotation (around the z-axis) is enabled. To enable full 3D rotation, visit the dataset settings, select the "Labeling" tab, tick the "Enable 3D cuboid rotation" checkbox, and press "Save".

  1. Select the "Select and edit" tool by clicking on the pointer icon in the toolbar on the left, or by pressing the hotkey (Esc by default).

  2. Select the cuboid you want to rotate.

  3. Click and drag the red rotation plane attached to the cuboid to rotate the cuboid or use the hotkeys:

    • Rotate 1° counterclockwise (yaw): f by default

    • Rotate 1° clockwise (yaw): g by default

    • Rotate 45° counterclockwise (yaw): Shift + F by default

    • Rotate 45° clockwise (yaw): Shift + G by default

Change the heading of a cuboid

  1. Select the "Select and edit" tool by clicking on the pointer icon in the toolbar on the left, or by pressing the hotkey (Esc by default).

  2. Select the cuboid you want to change.

  3. Change the heading of the cuboid (indicated by a red arrow):

    • In the perspective view: double-click the face where you want the heading to be.

    • In a side view: double-click the edge where you want the heading to be.

Edit cuboid information

When a cuboid is selected you'll see the "Cuboid info" pane pop up at the bottom right. In here you can directly change the numeric inputs of the cuboid for more fine-grained control. In here it's also possible to propagate a certain value to the next and previous frames by clicking on the arrow buttons next to the input field. These buttons are disabled for properties that are already synced across frames.

Change the category of a cuboid

If the selected cuboid was created with default dimensions, the dimensions of the cuboid will change to the default dimensions of the new category.

Using the category dropdown

  1. Select the cuboid.

  2. Open the category dropdown by clicking on the category name in the objects sidebar on the right, or by pressing the hotkey (c by default).

  3. Select a category by clicking on the desired category, or by using the arrow keys and pressing Enter to confirm.

Using the category hotkey

  1. Select the cuboid.

  2. Press the hotkey of the desired category (1 - 9).

Cycle between cuboids / select the next cuboid

Press the hotkey (Tab by default).

Copy/paste a cuboid

Copy a cuboid

  1. Select the cuboid.

  2. Press the copy hotkey of your operating system (Ctrl/cmd + c).

Paste a cuboid

Press the paste hotkey of your operating system (Ctrl/cmd + v).

  • If you paste a cuboid and the cuboid does not exist yet (e.g because you pasted it in another frame which doesn't have a cuboid with that track ID yet), the cuboid will keep its track ID and will not be offset.

If you've set up the default dimensions for your categories (see ), you can create a cuboid with default dimensions by double clicking.

If you paste a cuboid and the same cuboid already exists (e.g. because you pasted it in the same frame), a duplicate cuboid with a new will be created and its position will be offset from the original cuboid.

track ID
creating a dataset
use your GPU in Chrome
This video shows you how to label cuboids in 3D point cloud sequences on Segments.ai. Specifically, we'll use the to easily label static objects, and to label dynamic objects.
merged point cloud view
batch mode
#categories
Cuboid information pane
Page cover image