Documentation

Editing and Refining Annotations 

Once initial annotations are created, you have a full suite of tools available to verify data quality and perfect your annotations. You can utilize automated checks to spot potential issues or enter Edit Mode to modify masks, categories, relations, attributes and activities.

Automated Quality Checks (Anomaly Detection)

To ensure high-quality datasets, you can use our built-in Anomaly Detection. This feature scans your annotations to flag potential mask irregularities or categorization inconsistencies.

There are two ways to run these checks:

  1. Integrated into the Pipeline: Many pipeline templates include anomaly detection as a standard step. If you selected one of these templates, the anomalies are detected automatically during the initial processing.
  2. Manual Trigger (Re-run): You can run (or re-run) anomaly detection at any time – for example, after you have finished manual editing and want a final quality check.

Run Anomaly Detection Manually

  1. Navigate to the Annotations tab.
  2. Locate the annotation card you wish to check and click Refine.
  3. Select the Detect Anomalies pipeline template.

View Anomaly Detection Results

Whether run automatically or manually, detected anomalies appear as tasks in the Inspector Panel and are highlighted on the timeline. The system displays:

  • The affected objects.
  • The frame ranges where the issue was found.
  • The specific type of anomaly.

Edit Mode Basics

Edit Mode is your workbench for adjusting masks, categories, relations, attributes, and activities.

How to Enter Edit Mode:

  • Manually: Click Edit on an annotation card in the Annotations tab (within a project).
  • Via Pipeline: If a pipeline includes a refinement step, clicking Start Task will automatically take you into Edit Mode.
  • Via the Annotation in the Library: When viewing an annotation, click on the Edit button in the upper right corner.

Note: You cannot edit Locked annotations. Only an Admin can unlock them.

Navigation and Selection

  • Select Objects: Click directly on a mask in the video canvas or check its box in the timeline. Hold Ctrl when clicking to select multiple objects.
  • Context Menu: Right-click an object to see quick actions.
  • Keyboard Shortcuts: To work faster, view the full list of shortcuts by clicking the Keyboard Icon in the top-right corner of the screen.

Defining Frame Ranges

Many editing tools apply only to a specific frame range. You can define the frame range using three methods:

  1. Timeline Drag: Click and drag directly on the Timeline to define a section.
  2. Timeline Buttons: Use the Start Frame and End Frame buttons located above the Timeline.
  3. F-Buttons: In the Inspector Panel, look for the button with the F icon. Clicking this lets you set start/end frames based on your current position.

Correction Tools

The Timeline toolbar offers five core tools to correct your data. Using the correction tools follows a standard 3-step workflow:

  1. Select the Object(s) you want to modify.
  2. Define the Frame Range on the Timeline.
  3. Click the appropriate action's Button (Merge, Split, Delete, etc.).

Merge

Combines multiple instances of the same object into one single ID (e.g., if a car was tracked as "Car 1" then "Car 2", merge them into "Car 1").

  1. Select all relevant objects.
  2. Define the Frame Range.
  3. Click Merge.

Note: The object marked with a star will become the primary ID.

Split

Divides a single annotation into multiple instances (e.g., if two people were tracked as one object).

  1. Select the object.
  2. Define the Frame Range where the split should occur.
  3. Click Split.

Delete

Removes annotations either completely or just for a specific duration.

  1. Select the object(s).
  2. Define the Frame Range.
  3. Click Delete.

Category Change

Updates the category/label of an object (e.g., changing "Car" to "Truck").

  1. Select the object.
  2. Click Category in the toolbar (or press C).
  3. Select or type the new category.

Note: This changes the category for the entire sequence. If you only need to change it for part of the video, use Split first.

Propagate

Efficiently adjusts mask shapes across multiple frames using a "Keyframe" reference.

  1. Correct the mask on a single frame.
  2. Click the + (Plus) icon on the keyframe line.
  3. A Blue Diamond icon will appear on the timeline. This diamond acts as a signal to the system that this specific frame is correct and should be used as the reference.
  4. Define the target Frame Range.
  5. Select the object(s) and click Propagate.
  6. Tip: If an object rotates or changes appearance significantly, set multiple keyframes (Blue Diamonds) to help the system understand the shape changes.

Note: Objects that are not selected are locked and will not be modified. Propagated objects cannot cut pixels out of objects which are not selected.