type

states.KalmanBBox

class KalmanBBox:

Constant-velocity bounding-box Kalman process.

Builds the state-transition matrix ``F``, measurement matrix ``H``, and isotropic noise covariances ``Q``, ``R`` for one of two bbox models: - ``"sort"`` — 7-D state ``[x, y, a, h, vx, vy, va]``, 4-D measurement ``[x, y, a, h]``. Height carries no velocity, matching the original SORT formulation. - ``"deepsort"`` — 8-D state ``[x, y, a, h, vx, vy, va, vh]`` with an added height velocity, matching the canonical Kalman-bbox convention. ``Q`` is parameterised as ``q * I_D`` and treated as per-unit-time process noise: each call accumulates ``q * dt`` along the diagonal of the propagated covariance (see :class:`KalmanLinear` for the exact integration rule). ``R`` is parameterised as ``r * I_4``.

Parameters

NameTypeDescription
field = 'bbox'strField name for the bbox mean. The matching covariance lives in ``f"{field}_cov"``.
q = 0.01floatPer-unit-time process-noise scale.
r = 0.1floatMeasurement-noise scale.
model = "sort"('sort', 'deepsort')Bbox motion model. Default ``"sort"``.

Raises

  • ValueError — If ``model`` is not one of ``"sort"`` or ``"deepsort"``.

Members

method

  • __call__Advance bbox mean and covariance by one predict step.
  • __init__
  • make_updateConstruct a matching KalmanUpdate for the bbox observation.
  • state_entriesReturn ``(mean, cov)`` :class:`~unitrack.states.State` entries.

property

Source: unitrack/states/kalman/bbox.py:102