benchmarks.hota.TrackRemap

The panoptic encoding ``semantic * offset + instance`` requires the instance component to be a small positive integer (index 0 is reserved for crowd/void and is excluded by the metric). Track ids assigned by the tracker are arbitrary and may exceed ``offset``; this remaps them to ``1, 2, 3, …`` in first-seen order, kept consistent across all frames of one sequence. Indexing is scoped per semantic class: two tracks of *different* classes may share an instance index without colliding in the encoding because their ``semantic`` component differs. A new index that would reach ``offset`` (which would corrupt the encoding by carrying into the semantic component) raises a :class:`ValueError`.