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
| Name | Type | Description |
|---|---|---|
| field = 'bbox' | str | Field name for the bbox mean. The matching covariance lives in ``f"{field}_cov"``. |
| q = 0.01 | float | Per-unit-time process-noise scale. |
| r = 0.1 | float | Measurement-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