chenzenghui
/
cvat
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
cvat/site/content/en/docs/manual/basics/3d-object-annotation.md

3.9 KiB
Raw Blame History

title linkTitle weight description
3D Object annotation 3D Object annotation 19 Overview of basic operations available when annotating 3D objects.

Use the 3D Annotation tool for labeling 3D objects and scenes, such as vehicles, buildings, landscapes, and others.

Check out:

Navigation

The 3D annotation canvas looks like the following:

3D canvas

{{% alert title="Note" color="primary" %}} If you added contextual images to the dataset, the canvas will include them. For more information, consult {{< ilink "/docs/manual/advanced/contextual-images" "Contextual images" >}} {{% /alert %}}

For information on the available tools, consult {{< ilink "/docs/manual/basics/CVAT-annotation-Interface/controls-sidebar" "Controls sidebar" >}}.

You can navigate, using the mouse, or navigation keys:

Navigation keys used in 3D annotation

You can also use keyboard shortcuts to navigate:

Action Keys
Camera rotation Shift + Arrow (Up, Down, Left, Right)
Left/Right Alt+J/ Alt+L
Up/down Alt+U/ Alt+O
Zoom in/ou Alt+K/ Alt+I

Annotation with cuboids

There are two options available for 3D annotation:

  • Shape: for tasks like object detection.
  • Track: uses interpolation to predict the position of objects in subsequent frames. A unique ID will be assigned to each object and maintained throughout the sequence of images.

Annotation with shapes

To add a 3D shape:

  1. On the objects pane, select Draw new cuboid > select the label from the drop-down list > Shape.

    Opened "Draw new cuboid" window

  2. The cursor will be followed by a cuboid. Place the cuboid on the 3D scene.

    Example of placing cuboid on a 3D scene

  3. Use projections to adjust the cuboid. Click and hold the left mouse button to edit the label shape on the projection.

    Example of a cuboid adjustment with projections

  4. (Optional) Move one of the four points to change the size of the cuboid.

    Example of a cuboid size change using cuboid points

  5. (Optional) To rotate the cuboid, select the middle point and then drag the cuboid up/down or to left/right.

    Example of a cuboid rotation using cuboid middle point

Tracking with cuboids

To track with cuboids:

  1. On the objects pane, select Draw new cuboid > select the label from the drop-down list > Track.

  2. The cursor will be followed by a cuboid. Place the cuboid on the 3D scene.

  3. Use projections to adjust the cuboid. Select and hold the left mouse button to edit the label shape on the projection.

    Adjusting cuboid

  4. (Optional) Move one of the four points to change the size of the cuboid.

    Moving cuboid

  5. (Optional) To rotate the cuboid, click on the middle point and then drag the cuboid up/down or to left/right.

    Rotating cuboid

  6. Move several frames forward. You will see the cuboid you've added in frame 1. Adjust it, if needed.

  7. Repeat to the last frame with the presence of the object you are tracking.

For more information about tracking, consult {{< ilink "/docs/manual/basics/track-mode-basics" "Track mode" >}}.