CV / ByteTrack

ByteTrack

reComputer R Series (CM5 + Hailo-8)

Suivi MOT17 de personnes avec la série ByteTrack sur reComputer série R avec Hailo-8 (S/Tiny/Nano/M) ou Hailo-10H (S/Tiny).

10 téléchargements
Taille
14.8 MB
Mémoire
4GB+
Précision
Hailo HEF

Choisissez l'appareil que vous utilisez. Le guide de configuration et la documentation seront mis à jour en conséquence.

Pour commencer

Déployer
sudo docker run --rm \
  --name pi5-hailo8-bytetrack-s \
  --privileged \
  --net=host \
  -e PYTHONUNBUFFERED=1 \
  --device /dev/hailo0:/dev/hailo0 \
  -v /usr/lib/libhailort.so.4.23.0:/usr/lib/libhailort.so.4.23.0:ro \
  -v /usr/lib/libhailort.so:/usr/lib/libhailort.so:ro \
  ghcr.io/seeed-projects/recomputer-hailo8-cv/bytetrack_s_mot17:latest \
  python web_detection.py --model_path model/bytetrack_s_mot17.hef --video_path video/test.mp4

Détails du modèle

reComputer R Series (CM5 + Hailo-8)

Suivi MOT17 avec ByteTrack-S / ByteTrack-Tiny sur reComputer série R (CM5 + Hailo-8)

ByteTrack-S, ByteTrack-Tiny, ByteTrack-Nano et ByteTrack-M suivent des personnes sur des vidéos de type MOT17 sur Hailo-8 via HailoRT 4.23.x. Les HEF sont des détecteurs de personnes de type YOLOX ; l’hôte décode les neuf têtes, applique le NMS et l’association ByteTrack (Kalman + IoU haut/bas score), puis dessine un track ID stable dans l’aperçu MJPEG.

Informations sur le modèle

VarianteEntréeHEF embarquéMOTA float / Hailo-8FPS (batch 1)Paramètres / opérationsConteneur
ByteTrack-S608×1088×314.8 MB79.5 / 77.788.38.94M / 43.21Gbytetrack_s_mot17
ByteTrack-Tiny608×1088×39.7 MB77.2 / 76.01265.03M / 24.60Gbytetrack_tiny_mot17
ByteTrack-Nano608×1088×39.8 MB70.1 / 69.063.70.90M / 4.12Gbytetrack_nano_mot17
ByteTrack-M608×1088×381.4 MB86.2 / 86.111.125.28M / 206.12Gbytetrack_m_mot17

Matériel et configuration de l'hôte

| Carte | Accélérateur | Environnement d’exécution | Python dans le conteneur | |---|---| | Carte | reComputer série R avec Raspberry Pi CM5 | | Accélérateur | Hailo-8 en PCIe, exposé comme /dev/hailo0 | | Environnement d’exécution | HailoRT 4.23.x (hôte et conteneur doivent partager major.minor) | | Python dans le conteneur | 3.11, aarch64 |

bash
sudo apt update
sudo apt install hailo-all -y
sudo reboot

# Après redémarrage
hailortcli fw-control identify
ls /dev/hailo0

# Docker
curl -fsSL https://get.docker.com -o get-docker.sh
sudo sh get-docker.sh --mirror Aliyun
sudo systemctl enable docker
sudo systemctl start docker

Exécuter avec la vidéo de démonstration

Sélectionnez la commande correspondant à la variante.

ByteTrack-S

bash
sudo docker run --rm \
  --name pi5-hailo8-bytetrack-s \
  --privileged \
  --net=host \
  -e PYTHONUNBUFFERED=1 \
  --device /dev/hailo0:/dev/hailo0 \
  -v /usr/lib/libhailort.so.4.23.0:/usr/lib/libhailort.so.4.23.0:ro \
  -v /usr/lib/libhailort.so:/usr/lib/libhailort.so:ro \
  ghcr.io/seeed-projects/recomputer-hailo8-cv/bytetrack_s_mot17:latest \
  python web_detection.py --model_path model/bytetrack_s_mot17.hef --video_path video/test.mp4

ByteTrack-Tiny

bash
sudo docker run --rm \
  --name pi5-hailo8-bytetrack-tiny \
  --privileged \
  --net=host \
  -e PYTHONUNBUFFERED=1 \
  --device /dev/hailo0:/dev/hailo0 \
  -v /usr/lib/libhailort.so.4.23.0:/usr/lib/libhailort.so.4.23.0:ro \
  -v /usr/lib/libhailort.so:/usr/lib/libhailort.so:ro \
  ghcr.io/seeed-projects/recomputer-hailo8-cv/bytetrack_tiny_mot17:latest \
  python web_detection.py --model_path model/bytetrack_tiny_mot17.hef --video_path video/test.mp4

Ouvrez http://<Board_IP>:8000 pour voir l’aperçu avec les track IDs. Le video/test.mp4 fourni est le clip de rue Hailo.

ByteTrack-Nano

bash
sudo docker run --rm \
  --name pi5-hailo8-bytetrack-nano \
  --privileged \
  --net=host \
  -e PYTHONUNBUFFERED=1 \
  --device /dev/hailo0:/dev/hailo0 \
  -v /usr/lib/libhailort.so.4.23.0:/usr/lib/libhailort.so.4.23.0:ro \
  -v /usr/lib/libhailort.so:/usr/lib/libhailort.so:ro \
  ghcr.io/seeed-projects/recomputer-hailo8-cv/bytetrack_nano_mot17:latest \
  python web_detection.py --model_path model/bytetrack_nano_mot17.hef --video_path video/test.mp4

ByteTrack-M

bash
sudo docker run --rm \
  --name pi5-hailo8-bytetrack-m \
  --privileged \
  --net=host \
  -e PYTHONUNBUFFERED=1 \
  --device /dev/hailo0:/dev/hailo0 \
  -v /usr/lib/libhailort.so.4.23.0:/usr/lib/libhailort.so.4.23.0:ro \
  -v /usr/lib/libhailort.so:/usr/lib/libhailort.so:ro \
  ghcr.io/seeed-projects/recomputer-hailo8-cv/bytetrack_m_mot17:latest \
  python web_detection.py --model_path model/bytetrack_m_mot17.hef --video_path video/test.mp4

Mode caméra USB

bash
sudo docker run --rm \
  --name pi5-hailo8-bytetrack-s \
  --privileged \
  --net=host \
  -e PYTHONUNBUFFERED=1 \
  --device /dev/hailo0:/dev/hailo0 \
  --device /dev/video0:/dev/video0 \
  -v /usr/lib/libhailort.so.4.23.0:/usr/lib/libhailort.so.4.23.0:ro \
  -v /usr/lib/libhailort.so:/usr/lib/libhailort.so:ro \
  ghcr.io/seeed-projects/recomputer-hailo8-cv/bytetrack_s_mot17:latest \
  python web_detection.py --model_path model/bytetrack_s_mot17.hef --camera_id 0

Remplacez bytetrack_s_mot17 par bytetrack_tiny_mot17 pour exécuter la variante Tiny.

REST API

EndpointMéthode
ByteTrack-SPOST /api/models/bytetrack_s_mot17/predict
ByteTrack-TinyPOST /api/models/bytetrack_tiny_mot17/predict
ByteTrack-NanoPOST /api/models/bytetrack_nano_mot17/predict
ByteTrack-MPOST /api/models/bytetrack_m_mot17/predict
bash
curl -X POST "http://<Board_IP>:8000/api/models/bytetrack_s_mot17/predict" \
  -F "file=@test.jpg"

Les entrées predictions contiennent track_id, class, confidence et box.

Notes d'implémentation

  • Les HEF exposent neuf têtes YOLOX (box/objectness/class) pour les strides 32/16/8, sans NMS sur puce.
  • L’hôte décode center/size, calcule score=obj*class, applique un NMS 0.7 et l’association ByteTrack.
  • Le prétraitement applique un letterbox 608×1088 (remplissage 114) et BGR→RGB ; la normalisation ImageNet est dans le HEF. Modèle réservé aux personnes.

Notes de développement

  • Sources: src/rpi5_hailo8_bytetrack{_s,_tiny,_nano,_m}_mot17/
  • Dockerfiles: docker/hailo8/bytetrack{_s,_tiny,_nano,_m}_mot17.dockerfile
  • Conteneurs: ghcr.io/seeed-projects/recomputer-hailo8-cv/bytetrack{_s,_tiny,_nano,_m}_mot17:latest
  • HEF: Hailo Model Zoo v2.20.0 (hailo8), sizes and SHA256 in each module's model/README.md

Entrées et sorties

Entrée : image, vidéo ou flux caméra USB. Sortie : boîtes person avec track ID, confiance et aperçu MJPEG.