Source code for datumaro.plugins.mot_format
# Copyright (C) 2020-2021 Intel Corporation
#
# SPDX-License-Identifier: MIT
# The Multiple Object Tracking Benchmark challenge format support
# Format description: https://arxiv.org/pdf/1906.04567.pdf
# Another description: https://motchallenge.net/instructions
from collections import OrderedDict
from enum import Enum
import csv
import logging as log
import os
import os.path as osp
from datumaro.components.annotation import AnnotationType, Bbox, LabelCategories
from datumaro.components.converter import Converter
from datumaro.components.extractor import DatasetItem, Importer, SourceExtractor
from datumaro.components.format_detection import FormatDetectionContext
from datumaro.components.media import Image
from datumaro.util import cast
from datumaro.util.image import find_images
from datumaro.util.meta_file_util import has_meta_file, parse_meta_file
MotLabel = Enum('MotLabel', [
('pedestrian', 1),
('person on vehicle', 2),
('car', 3),
('bicycle', 4),
('motorbike', 5),
('non motorized vehicle', 6),
('static person', 7),
('distractor', 8),
('occluder', 9),
('occluder on the ground', 10),
('occluder full', 11),
('reflection', 12),
])
[docs]class MotPath:
IMAGE_DIR = 'img1'
SEQINFO_FILE = 'seqinfo.ini'
LABELS_FILE = 'labels.txt'
GT_FILENAME = 'gt.txt'
DET_FILENAME = 'det.txt'
IMAGE_EXT = '.jpg'
FIELDS = [
'frame_id',
'track_id',
'x',
'y',
'w',
'h',
'confidence', # or 'not ignored' flag for GT anns
'class_id',
'visibility'
]
[docs]class MotSeqExtractor(SourceExtractor):
[docs] def __init__(self, path, labels=None, occlusion_threshold=0, is_gt=None,
subset=None):
super().__init__(subset=subset)
assert osp.isfile(path)
seq_root = osp.dirname(osp.dirname(path))
self._image_dir = ''
if osp.isdir(osp.join(seq_root, MotPath.IMAGE_DIR)):
self._image_dir = osp.join(seq_root, MotPath.IMAGE_DIR)
seq_info = osp.join(seq_root, MotPath.SEQINFO_FILE)
if osp.isfile(seq_info):
seq_info = self._parse_seq_info(seq_info)
self._image_dir = osp.join(seq_root, seq_info['imdir'])
else:
seq_info = None
self._seq_info = seq_info
self._occlusion_threshold = float(occlusion_threshold)
assert is_gt in {None, True, False}
if is_gt is None:
if osp.basename(path) == MotPath.DET_FILENAME:
is_gt = False
else:
is_gt = True
self._is_gt = is_gt
if has_meta_file(seq_root):
labels = list(parse_meta_file(seq_root).keys())
if labels is None:
labels = osp.join(osp.dirname(path), MotPath.LABELS_FILE)
if not osp.isfile(labels):
labels = [lbl.name for lbl in MotLabel]
if isinstance(labels, str):
labels = self._parse_labels(labels)
elif isinstance(labels, list):
assert all(isinstance(lbl, str) for lbl in labels), labels
else:
raise TypeError("Unexpected type of 'labels' argument: %s" % labels)
self._categories = self._load_categories(labels)
self._items = list(self._load_items(path).values())
@staticmethod
def _parse_labels(path):
with open(path, encoding='utf-8') as labels_file:
return [s.strip() for s in labels_file]
def _load_categories(self, labels):
attributes = ['track_id']
if self._is_gt:
attributes += ['occluded', 'visibility', 'ignored']
else:
attributes += ['score']
label_cat = LabelCategories(attributes=attributes)
for label in labels:
label_cat.add(label)
return { AnnotationType.label: label_cat }
def _load_items(self, path):
labels_count = len(self._categories[AnnotationType.label].items)
items = OrderedDict()
if self._seq_info:
for frame_id in range(1, self._seq_info['seqlength'] + 1): # base-1 frame ids
items[frame_id] = DatasetItem(
id=frame_id,
subset=self._subset,
image=Image(
path=osp.join(self._image_dir,
'%06d%s' % (frame_id, self._seq_info['imext'])),
size=(self._seq_info['imheight'], self._seq_info['imwidth'])
)
)
elif osp.isdir(self._image_dir):
for p in find_images(self._image_dir):
frame_id = int(osp.splitext(osp.relpath(p, self._image_dir))[0])
items[frame_id] = DatasetItem(id=frame_id, subset=self._subset,
image=p)
with open(path, newline='', encoding='utf-8') as csv_file:
# NOTE: Different MOT files have different count of fields
# (7, 9 or 10). This is handled by reader:
# - all extra fields go to a separate field
# - all unmet fields have None values
for row in csv.DictReader(csv_file, fieldnames=MotPath.FIELDS):
frame_id = int(row['frame_id'])
item = items.get(frame_id)
if item is None:
item = DatasetItem(id=frame_id, subset=self._subset)
annotations = item.annotations
x, y = float(row['x']), float(row['y'])
w, h = float(row['w']), float(row['h'])
label_id = row.get('class_id')
if label_id and label_id != '-1':
label_id = int(label_id) - 1
assert label_id < labels_count, label_id
else:
label_id = None
attributes = {}
# Annotations for detection task are not related to any track
track_id = int(row['track_id'])
if 0 < track_id:
attributes['track_id'] = track_id
confidence = cast(row.get('confidence'), float, 1)
visibility = cast(row.get('visibility'), float, 1)
if self._is_gt:
attributes['visibility'] = visibility
attributes['occluded'] = \
visibility <= self._occlusion_threshold
attributes['ignored'] = confidence == 0
else:
attributes['score'] = float(confidence)
annotations.append(Bbox(x, y, w, h, label=label_id,
attributes=attributes))
items[frame_id] = item
return items
@classmethod
def _parse_seq_info(cls, path):
fields = {}
with open(path, encoding='utf-8') as f:
for line in f:
entry = line.lower().strip().split('=', maxsplit=1)
if len(entry) == 2:
fields[entry[0]] = entry[1]
cls._check_seq_info(fields)
for k in { 'framerate', 'seqlength', 'imwidth', 'imheight' }:
fields[k] = int(fields[k])
return fields
@staticmethod
def _check_seq_info(seq_info):
assert set(seq_info) == {'name', 'imdir', 'framerate', 'seqlength', 'imwidth', 'imheight', 'imext'}, seq_info
[docs]class MotSeqImporter(Importer):
[docs] @classmethod
def detect(cls, context: FormatDetectionContext) -> None:
context.require_file('gt/gt.txt')
[docs] @classmethod
def find_sources(cls, path):
return cls._find_sources_recursive(path, '.txt', 'mot_seq',
dirname='gt', filename=osp.splitext(MotPath.GT_FILENAME)[0])
[docs]class MotSeqGtConverter(Converter):
DEFAULT_IMAGE_EXT = MotPath.IMAGE_EXT
[docs] def apply(self):
extractor = self._extractor
image_dir = osp.join(self._save_dir, MotPath.IMAGE_DIR)
os.makedirs(image_dir, exist_ok=True)
anno_dir = osp.join(self._save_dir, 'gt')
os.makedirs(anno_dir, exist_ok=True)
anno_file = osp.join(anno_dir, MotPath.GT_FILENAME)
with open(anno_file, 'w', encoding="utf-8") as csv_file:
writer = csv.DictWriter(csv_file, fieldnames=MotPath.FIELDS)
track_id_mapping = {-1: -1}
for idx, item in enumerate(extractor):
log.debug("Converting item '%s'", item.id)
frame_id = cast(item.id, int, 1 + idx)
for anno in item.annotations:
if anno.type != AnnotationType.bbox:
continue
track_id = int(anno.attributes.get('track_id', -1))
if track_id not in track_id_mapping:
track_id_mapping[track_id] = len(track_id_mapping)
track_id = track_id_mapping[track_id]
writer.writerow({
'frame_id': frame_id,
'track_id': track_id,
'x': anno.x,
'y': anno.y,
'w': anno.w,
'h': anno.h,
'confidence': int(anno.attributes.get('ignored') is not True),
'class_id': 1 + cast(anno.label, int, -2),
'visibility': float(
anno.attributes.get('visibility',
1 - float(
anno.attributes.get('occluded', False)
)
)
)
})
if self._save_images:
if item.has_image and item.image.has_data:
self._save_image(item, subdir=image_dir,
name='%06d' % frame_id)
else:
log.debug("Item '%s' has no image", item.id)
if self._save_dataset_meta:
self._save_meta_file(self._save_dir)
else:
labels_file = osp.join(anno_dir, MotPath.LABELS_FILE)
with open(labels_file, 'w', encoding='utf-8') as f:
f.write('\n'.join(l.name
for l in extractor.categories()[AnnotationType.label])
)