Steps to Label

1

1. Scene Setup & Orientation

  • Setup point cloud visibility and density from Tool Settings (tool Footer).

  • Fit the entire point cloud in the viewing window using Fit to Screen (tool Header).

  • Jump to the centre (near the Ego vehicle) by using Jump to Origin (tool Header).

  • Toggle to Fullscreen if desired (tool Header).

2

2. Navigation in point cloud

  • Choose one of the two Navigation Controls to navigate in the point cloud based on your preference. (tool Header)

3

3. Object Identification

The tool provides multiple features & interactions that aid in object identification:

  • Expand and collapse the image Panel whenever needed to cross-check the object/scene-related details.

  • Use the help of the raycaster while navigating through the point cloud to see the respective coordinate highlighted in Camera Image(s).

  • On hovering on the Cameras, a red cone (Frustum) will appear in the point cloud emerging from the Ego vehicle to indicate the direction the camera is facing.

  • Enable the Merge Point Clouds across the frames to identify and mark stationary objects.

Learn more: https://docs.imerit-prod.io/annotation-tool/key-features/merged-point-cloud

4

4. Object Visibility

For better object visibility during drawing/marking use the following features:

  • Isolate areas of the point cloud where the object is present by marking a boundary to hide surrounding/background points.

    • Reference: https://docs.imerit-prod.io/annotation-tool/tool-layout#isolate

  • Hide points from bottom (ground) to top (ceiling) and vice-versa using the Ground & Ceiling Mover.

    • Reference: https://docs.imerit-prod.io/annotation-tool/tool-layout#ground-and-ceiling-mover

5

5. Object Labelling

  • Switch to a desired view to start marking an object in the top view using BEV Mode or 3 dimensionally using 3D Mode.

    • BEV Mode: https://docs.imerit-prod.io/annotation-tool/tool-layout#bev-3d-mode

    • 3D Mode: https://docs.imerit-prod.io/annotation-tool/tool-layout#id-2d-3d-mode

  • Identify the object either on the point cloud or on the camera sensors.

    • Pull up the Camera Sensors using the hotkey Shift + Q or double-clicking the camera sensor in the reference images.

  • Click the '+' icon on the Class the object belongs to from the Class List.

    • Class List: https://docs.imerit-prod.io/annotation-tool/tool-layout#id-3.-class-list

  • All the Drawing Tools linked to the Class will appear. Select the appropriate one from the Available Drawing Tools.

    • Drawing Tools: https://docs.imerit-prod.io/annotation-tool/drawing-tools

6

6. Annotation Detail Input

After marking the annotation, mark the annotation details in the popup that appears. Enter the Instance, Attribute Details and Relationship if any.

Attributes and Relationships

Once an annotation is created, the user needs to input the following:

a. Time-varying & Constant Attributes

  • Enter all the mandatory attributes (constant and time-varying).

    • constant: https://docs.imerit-prod.io/project-setup/create-recipe/3.-attributes#id-1.-attribute-type

    • time-varying: https://docs.imerit-prod.io/project-setup/create-recipe/3.-attributes#id-1.-attribute-type

Attributes image

b. Relationship

  • This tab is enabled if a relation has been defined in the recipe generator.

    • Recipe relations: https://docs.imerit-prod.io/project-setup/create-recipe/4.-associations#b.-create-relations

Steps:

  1. Select the Relation type from the dropdown.

  2. Select the Instance it has a relationship with (multiple instances can be added).

  3. The relationship between the two can be applied across all frames or only the current frame.

  4. The view icon allows the user to see the list of frames the relationship exists on.

  5. Once the relationship is saved, the visual representation of the link is displayed over the point cloud with a line connecting the two instances.

Relationship UI 1
Relationship UI 2
Relationship UI 3

Learn more about the Relationship feature: https://docs.imerit-prod.io/annotation-tool/key-features/relationship

Instance ID

An Instance ID is an identifier assigned to each labelled object across the batch of frames.

  • This instance ID can be used to track an object over multiple frames.

  • Instance ID can be viewed in the status box that appears on hover or selection of an annotation on the class list.

    • Status box: https://docs.imerit-prod.io/annotation-tool/tool-layout#status

    • Class list: https://docs.imerit-prod.io/annotation-tool/tool-layout#id-3.-class-list

  • Instances can be created, modified or merged.

    • Creating instance: https://docs.imerit-prod.io/annotation-tool/steps-to-label#creating-instance

    • Modifying instance: https://docs.imerit-prod.io/annotation-tool/steps-to-label#changing-instance-id-for-an-annotation-across-frames

    • Merging instance: https://docs.imerit-prod.io/annotation-tool/steps-to-label#merging-instance-id

Instance UI 1
Instance UI 2

Creating Instance

After creating an object, the user is asked to create a new instance or select "+ Create New".

  • There will always be one unique instance per Frame and Sensor.

Example: Only one object will have the ID car_1 which is present in Frame 1. This car could be present in 3 Cameras and the point cloud of Frame 1. Hence each of the 4 Sensors (3 Camera, 1 LiDAR) will have an annotation with ID car_1.

Creating instance example

The Instance Dropdown allows:

  • Creating New Instances.

  • Listing all created instances that are missing in that Sensor (e.g., car_48).

Changing Instance ID (for an annotation across frames)

  1. Select the object.

  2. Open the annotation details pop-up.

  3. Select "+ Create new". The tool will allocate a new unique ID to it.

  4. Save the new Instance ID. This replaces the old Instance ID in all frames for that annotation.

Merging Instance ID

If the user realises that two instances are the same object (e.g., car_2 on Frame 10 is actually car_1), merging is required.

Steps:

  1. Select the annotation you want to merge into another instance (e.g., car_2 on Frame 10).

  2. Right-click and select Annotation Details.

  3. Open the instance ID dropdown. This dropdown lists annotation IDs missing from the current frame and the option to create a new one.

  4. Select the appropriate existing ID to merge with (e.g., select car_1).

  5. Save and the old instance gets changed to the new selected one (car_1 becomes car_2 in Frame 10).

Note: Merging instances is only possible when both instances have no overlapping Keyframes.

7

7. Dimension Setting/ Modification

  • On selecting an annotation, the multiview mode will be enabled on the right-side. Hover on the multiview to enable the annotation to modify it from the top, side, and front views aiding accurate dimension modification.

  • Learn how to modify annotations using Shortcuts.

    • Shortcuts: https://docs.imerit-prod.io/annotation-tool/tool-shortcuts#drawing-tools-and-modification

  • Learn how to use Drawing Tools.

    • Drawing Tools: https://docs.imerit-prod.io/annotation-tool/drawing-tools

8

8. Interpolation (for a moving Obj.)

If the annotation created is for a moving object, use keyframe interpolation to mark the object across all the sequential frames without having to create it in every frame.

  • Keyframe interpolation: https://docs.imerit-prod.io/annotation-tool/key-features/keyframe-interpolation

9

9. Object Tracking

  • Use this feature when an object is required to be labeled in both point cloud and image sensors while sharing a unique instance ID.

  • The projection of the created cuboid in the point cloud is visible on the appropriate camera images.

  • Double-click on that image to enlarge it.

  • Create a rectangle on that object in the image.

    • Create rectangle: https://docs.imerit-prod.io/annotation-tool/drawing-tools/rectangle#create-rectangle

  • Annotation detail input opens up. Choose the instance ID the same as its parent annotation created in the point cloud. Fill in the remaining details and Save.

  • The 2D instance of the same object appears under the 3D instance created on the point cloud (sharing the same ID). Example: Truck_1 is a cuboid annotation created in the point cloud and the instance of the same object created in Image will appear as Truck_1 #2 (with a 2D icon on the left of the label).

Object tracking example
10

10. Cross-Checking

  • Use the outlier feature to locate points that have not been labelled.

    • Outlier: https://docs.imerit-prod.io/annotation-tool/key-features/outlier

  • Use object clipping on the class row to identify if any extra points have been labelled for an object or if required points have not been labelled for an object.

    • Class row / object clipping: https://docs.imerit-prod.io/annotation-tool/tool-layout#class-row

  • Conduct auditing and mark issues that are observed in the Audit Tool.

    • Audit Tool / how to raise issues: https://docs.imerit-prod.io/audit-tool#how-to-raise-issues

  • View the overall submissions of batches using the Visualization Tool.

    • Batches: https://docs.imerit-prod.io/project-setup/pre-process-data#batch

    • Visualization Tool: https://docs.imerit-prod.io/visualization-tool

  • Pull up the camera sensor with Shift + Q, locate the object, press Esc to land in the point cloud in the same perspective as the camera sensor.

Last updated