Merge Objects Node

Merges objects and allows rename and grouping of classes names


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


object_typesIf 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_toRename object types specified using object_types above to this label
overlap_thresholdMerges all overlapping objects with overlap ratio (Intersection over Union (IoU)) above this threshold.

Check the information bellow to details about the IoU formula.
display_objectsBoolean. 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.

300 448