Description

Filters objects in close XY proximity based on a specific measurement. For two, or more, objects within close proximity of each other the object with the largest (or smallest) measurement will be retained, whilst the others will be removed. This can be used to filter instances of the same object being detected multiple times. Distances are only considered in XY. Any Z-axis information on object position will be ignored.

Parameters

Input objects: Objects to be filtered.

Filter mode: Controls what happens to objects which don't pass the filter:

Output (filtered) objects: New object collection containing input objects which did not pass the filter. These objects are only stored if "Filter mode" is set to "Move filtered objects to new class".

Reference mode: Controls the method used for determining the nearest neighbour distances:

Minimum separation: Minimum allowed distance in XY plane for two objects to co-exist. Any objects with XY separation smaller than this value will be subject to filtering, where the "less suitable" (depending on filter settings) object will be removed.

Calibrated units: When selected, object-object distances are to be specified in calibrated units; otherwise, units are specified in pixels.

Only link objects in same frame: When selected, objects must be in the same time frame for them to be linked.

Method for filtering: For objects closer than the value specified by "Minimum separation" this parameter controls which will be retained.

Measurement to filter on: Objects will be filtered against their value of this measurement. Objects missing this measurement are not removed; however, they can be removed by using the module "With / without measurement".