26 APR 2026

rahulmnavneeth

reference — trackers

homedocs

Each tracker is an independent crate under crates/uify-<name>/ implementing uify_core::Tracker. Concrete trackers wrap a filter via uify_core::TrackerCommon<F> so dt-since-last-update, reset, and the filter snapshot are shared bookkeeping.

CrateGStatusFilter
uify-pointVector2<f64>implementedKalmanFilter<4>
uify-bboxBbox (cx, cy, w, h)implementedKalmanFilter<6> (AABB)
uify-planeSe3smootherEkf3D (manifold EKF)
uify-facelandmarks + Se3 + blendshapesstub
uify-rotocontour / signed-distance maskstub

What "smoother" / "stub" mean

Bounding box

uify-bbox::BboxTracker2D is axis-aligned with state (cx, cy, w, h, vcx, vcy) ∈ ℝ⁶. Position is constant-velocity; size is random-walk. An oriented variant ((SE(2), w, h)) will land separately once a use case justifies the extra DOFs.

Plane

uify-plane::PlaneTracker wraps uify_core::filters::ekf_manifold::Ekf3D with random-walk predict and direct-pose update. It's the layer a host pipeline plugs into once a detector exists.

Each tracker owns

Tracker-specific reference pages (TODO):