Modify and Merge Objects
Merges and modifies objects, changes object bbox sizes & attributes, and allows rename and grouping of class names
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.
Updated about 2 months ago