Overview

This node can be used if you want to merge bounding boxes of objects of the same class, or rename one or more object classes into a specific class, or modify the object's attributes'.

Requires a AI Model Node before it in order to function properly. Having a Track Objects Node before is required if using Object Match Patterns else 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	Description	Type	Default	Required
`object_types`	If specified, only process objects of these types. Leave blank to process all objects. ex. `car`,`person`,`car.red`	model-label	null	false
`object_match_patterns`	Modify objects with IDs specified in the metadata attribute(s) defined by this pattern. ex. nodes...*.cur_dir1_objects	metadata-list	null	false
`processing_mode`	Process objects continuously after they match type/patterns specified at least once or only when they match the type/patterns specified. Options: `continuous`, `matched`	enum	continuous	false
`rename_objects_to`	Rename object types specified using object types above. If object types are specified, number of renamed objects must match number of object types.	string	null	false
`add_object_attributes`	Add the specified attributes to the object, keeping any attributes it already has. ex. wrong_way,stopped	string	null	false
`remove_object_attributes`	Remove the specified attributes from the object. ex. wrong_way,red	string	null	false
`replace_object_attributes`	Replace all the object attributes with the ones specified. ex. wrong_direction,object_of_interest	string	null	false
`scale_factor`	Grows/shrinks the bounding box of the objects by this factor. Does not resize the object itself. Min: 0, Max: 10.0, Step: 0.1	slider	1.0	false
`overlap_threshold`	Merges all overlapping objects with overlap ratio (Intersection over Union (IoU)) above this threshold. Min: 0, Max: 1.0, Step: 0.05	slider-optional	null	false
`display_objects`	If enabled, objects removed as a result of the merge will be drawn on video for debug purposes. ex. `true` / `false`	bool	false	false
`object_history_duration`	Remember objects for this duration after they are last seen in case they reappear.	float	600	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.