Calculate Minimum Distance

@bleenco1 VersionCalculate

Computes inter-object distances between tracked objects in the 2D image plane: takes a per-frame list of tracked-object records and emits, per object, the minimum Double distance to each other class — or the single nearest neighbour — as a list of distance records.

How it fits

Typical backends

Track detections across frames, smooth their positions, compute nearest inter-object distances, and publish them over HTTP for a proximity monitor.

Compute distances then keep only the records that pass a downstream proximity predicate before publishing.

Caveats

Hard constraintmovement_threshold must carry an entry for every class id present in the input; an object whose class index has no threshold entry fails the computation rather than being skipped.
I/O contractWith select_smallest_distance_only enabled a single nearest record is emitted per object, and an object with no eligible neighbour still emits a sentinel record with negative class ids and an infinite distance.
Parameter interactionfilter_class_pairs is order-insensitive — a pair is normalized so either ordering excludes the same two classes from the distance search.
LimitationObjects whose per-frame movement falls below their class threshold are dropped from the search, so a stationary object is treated as absent when computing other objects' nearest neighbours.

Versions

3a6cd149defaultlatest
Automated release
6/14/2026