Merge Objects Node

Merges objects and allows rename and grouping of classes names

Overview

This node can be used if you want to merge bounding boxes of objects of the same class. It can also be used for renaming one or more object classes into a specific class.

Requires a AI Model Node before it in order to function properly. Having a Track Objects Node before is optional, you can place it after the Merge Objects node.

Inputs & Outputs

  • Inputs : 1, Media Format : Raw Video
  • Outputs : 1, Media Format: Raw Video
  • Output Metadata : Filtered Objects Information

Properties

Property

Value

object_types

If specified, only process objects of these types. Else processes all objects.

Comma separated list of Detected Object labels to merge, as specified in Model Labels

ex. car, person

rename_objects_to

Rename object types specified using object_types above to this label

overlap_threshold

Merges all overlapping objects with overlap ratio (Intersection over Union (IoU)) above this threshold.

Check the information bellow to details about the IoU formula.

display_objects

Boolean. If true, objects removed as a result of the merge will be drawn on video for debug purposes.

Ex. true / false

Intersection over Union (IoU)

IoU (Intersection over Union) is the area of overlap between two detection bounding boxes divided by the area of union of both.