Skip to content

boxmot.trackers.common.box.base

Shared invariant boundary for box-state trackers.

BoxTracker 

BoxTracker(
    *args,
    is_obb: bool = False,
    mask_guidance: MaskGuidanceConfig
    | MaskGuidance
    | None = None,
    edgetam: Mapping[str, object] | None = None,
    **kwargs,
)

Bases: BoxMaskGuidanceMixin, BaseTracker

Base class for trackers whose primary state is an AABB or OBB.

The class selects one immutable geometry policy at construction. That policy owns canonical-geometry validation, private row layout selection, and association-mode dispatch for the lifetime of the tracker.

accepts_embeddings class-attribute instance-attribute 

accepts_embeddings = False

accepts_frame class-attribute instance-attribute 

accepts_frame = True

accepts_masks class-attribute instance-attribute 

accepts_masks = False

capabilities class-attribute instance-attribute 

capabilities = TrackerCapabilities(
    family=BOX,
    geometry_kinds=supported_geometry_kinds,
    accepts_frame=True,
)

geometry_ops instance-attribute 

geometry_ops = get_box_geometry_ops(is_obb=is_obb)

requires_embeddings class-attribute instance-attribute 

requires_embeddings = False

requires_frame class-attribute instance-attribute 

requires_frame = False

requires_masks class-attribute instance-attribute 

requires_masks = False

supported_geometry_kinds class-attribute instance-attribute 

supported_geometry_kinds: frozenset[GeometryKind] = (
    frozenset({AABB, OBB})
)

supports_obb class-attribute instance-attribute 

supports_obb = OBB in supported_geometry_kinds

__init_subclass__ 

__init_subclass__(**kwargs) -> None

Materialize one immutable capability declaration per implementation.

validate_geometry_kind 

validate_geometry_kind(kind: GeometryKind) -> None

Validate a fixed geometry kind before allocating tracker state.