Estimate Object Movement

How it fits

Typical backends

Caveats

• OrderingThe mask and flow inputs must be cadence-aligned and refer to the same frame; misaligned producers silently mix this-frame masks with last-frame flow.
• I/O contractPosition is the image-moment centroid of the binary mask, so a degenerate zero-area mask divides by zero and emits NaN coordinates; upstream code must drop empty masks or downstream must filter the NaNs.
• Parameter interactionOrientation is the mean flow over mask pixels whose flow magnitude clears movement_threshold; when every pixel in a mask is below it, the object renders as stationary even though the mask exists. The orientation is the mean vector, not the dominant direction, so multi-modal motion averages toward zero.
• Parameter interactionmultiplication_factor scales the orientation vector linearly and is a per-frame displacement, not a per-second velocity; reverse only flips the sign, applied after thresholding and scaling.
• I/O contractOutput length always equals the input mask count, including objects rendered stationary by threshold filtering, so an empty mask list yields an empty output.
• CostThe reduction is CPU-only; latency tracks the mask count and flow-tensor size rather than GPU resources.