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. Requires tracker prior to this node. ex. nodes...*.cur_dir1_objects	metadata-list	null	false
`processing_mode`	Object processing mode. Options: `continuous` (Process objects continuously after they match type/patterns specified at least once), `matched` (Process objects only for frames where they match the type/patterns specified)	enum	continuous	false
`min_presence_secs`	Only process objects/attributes that have been seen for at least this duration. Conditional on processing_mode being set to `continuous`.	float	0	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. Format: `<attribute>` or `<attribute>=<class_id>`. Ex. `wrong_way,object_of_interest=6700`	string	null	false
`remove_object_attributes`	Remove the specified attributes from the object. Format: `<attribute>`. Ex. `wrong_way,object_of_interest`	string	null	false
`replace_object_attributes`	Replace all the object attributes with the ones specified. Format: `<attribute>` or `<attribute>=<class_id>`. Ex. `wrong_way,object_of_interest=6700`	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.	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.