|
|
|
|
|
---
|
|
|
|
|
|
comments: true
|
|
|
|
|
|
description: Apprenez à utiliser Ultralytics YOLO pour le suivi d'objets dans les flux vidéo. Guides pour utiliser différents traceurs et personnaliser les configurations de traceurs.
|
|
|
|
|
|
keywords: Ultralytics, YOLO, suivi d'objets, flux vidéo, BoT-SORT, ByteTrack, guide Python, guide CLI
|
|
|
|
|
|
---
|
|
|
|
|
|
|
|
|
|
|
|
# Suivi Multi-Objets avec Ultralytics YOLO
|
|
|
|
|
|
|
|
|
|
|
|
<img width="1024" src="https://user-images.githubusercontent.com/26833433/243418637-1d6250fd-1515-4c10-a844-a32818ae6d46.png" alt="Exemples de suivi multi-objets">
|
|
|
|
|
|
|
|
|
|
|
|
Le suivi d'objets dans le domaine de l'analyse vidéo est une tâche essentielle qui non seulement identifie l'emplacement et la classe des objets à l'intérieur de l'image, mais maintient également un identifiant unique pour chaque objet détecté au fur et à mesure que la vidéo progresse. Les applications sont illimitées, allant de la surveillance et de la sécurité à l'analytique sportive en temps réel.
|
|
|
|
|
|
|
|
|
|
|
|
## Pourquoi Choisir Ultralytics YOLO pour le Suivi d'Objet ?
|
|
|
|
|
|
|
|
|
|
|
|
La sortie des traceurs Ultralytics est cohérente avec la détection standard d'objets mais apporte la valeur ajoutée des identifiants d'objets. Cela facilite le suivi des objets dans les flux vidéo et effectue des analyses subséquentes. Voici pourquoi vous devriez envisager d'utiliser Ultralytics YOLO pour vos besoins de suivi d'objet :
|
|
|
|
|
|
|
|
|
|
|
|
- **Efficacité :** Traitez les flux vidéo en temps réel sans compromettre la précision.
|
|
|
|
|
|
- **Flexibilité :** Prend en charge de multiples algorithmes de suivi et configurations.
|
|
|
|
|
|
- **Facilité d'Utilisation :** API Python simple et options CLI pour une intégration et un déploiement rapides.
|
|
|
|
|
|
- **Personnalisabilité :** Facile à utiliser avec des modèles YOLO entraînés sur mesure, permettant une intégration dans des applications spécifiques au domaine.
|
|
|
|
|
|
|
|
|
|
|
|
<p align="center">
|
|
|
|
|
|
<br>
|
|
|
|
|
|
<iframe width="720" height="405" src="https://www.youtube.com/embed/hHyHmOtmEgs?si=VNZtXmm45Nb9s-N-"
|
|
|
|
|
|
title="Lecteur vidéo YouTube" frameborder="0"
|
|
|
|
|
|
allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share"
|
|
|
|
|
|
allowfullscreen>
|
|
|
|
|
|
</iframe>
|
|
|
|
|
|
<br>
|
|
|
|
|
|
<strong>Regardez :</strong> Détection et suivi d'objets avec Ultralytics YOLOv8.
|
|
|
|
|
|
</p>
|
|
|
|
|
|
|
|
|
|
|
|
## Applications dans le Monde Réel
|
|
|
|
|
|
|
|
|
|
|
|
| Transport | Distribution | Aquaculture |
|
|
|
|
|
|
|:------------------------------------------------------------------------------------------------------------------------:|:------------------------------------------------------------------------------------------------------------------------:|:-----------------------------------------------------------------------------------------------------------------------:|
|
|
|
|
|
|
|  |  |  |
|
|
|
|
|
|
| Suivi de Véhicules | Suivi de Personnes | Suivi de Poissons |
|
|
|
|
|
|
|
|
|
|
|
|
## Caractéristiques en Bref
|
|
|
|
|
|
|
|
|
|
|
|
Ultralytics YOLO étend ses fonctionnalités de détection d'objets pour fournir un suivi d'objets robuste et polyvalent :
|
|
|
|
|
|
|
|
|
|
|
|
- **Suivi en Temps Réel :** Suivi fluide d'objets dans des vidéos à fréquence d'images élevée.
|
|
|
|
|
|
- **Prise en Charge de Multiples Traceurs :** Choisissez parmi une variété d'algorithmes de suivi éprouvés.
|
|
|
|
|
|
- **Configurations de Traceurs Personnalisables :** Adaptez l'algorithme de suivi pour répondre à des exigences spécifiques en réglant divers paramètres.
|
|
|
|
|
|
|
|
|
|
|
|
## Traceurs Disponibles
|
|
|
|
|
|
|
|
|
|
|
|
Ultralytics YOLO prend en charge les algorithmes de suivi suivants. Ils peuvent être activés en passant le fichier de configuration YAML correspondant tel que `tracker=tracker_type.yaml` :
|
|
|
|
|
|
|
|
|
|
|
|
* [BoT-SORT](https://github.com/NirAharon/BoT-SORT) - Utilisez `botsort.yaml` pour activer ce traceur.
|
|
|
|
|
|
* [ByteTrack](https://github.com/ifzhang/ByteTrack) - Utilisez `bytetrack.yaml` pour activer ce traceur.
|
|
|
|
|
|
|
|
|
|
|
|
Le traceur par défaut est BoT-SORT.
|
|
|
|
|
|
|
|
|
|
|
|
## Suivi
|
|
|
|
|
|
|
|
|
|
|
|
Pour exécuter le traceur sur des flux vidéo, utilisez un modèle Detect, Segment ou Pose formé tel que YOLOv8n, YOLOv8n-seg et YOLOv8n-pose.
|
|
|
|
|
|
|
|
|
|
|
|
!!! exemple ""
|
|
|
|
|
|
|
|
|
|
|
|
=== "Python"
|
|
|
|
|
|
|
|
|
|
|
|
```python
|
|
|
|
|
|
from ultralytics import YOLO
|
|
|
|
|
|
|
|
|
|
|
|
# Charger un modèle officiel ou personnalisé
|
|
|
|
|
|
model = YOLO('yolov8n.pt') # Charger un modèle Detect officiel
|
|
|
|
|
|
model = YOLO('yolov8n-seg.pt') # Charger un modèle Segment officiel
|
|
|
|
|
|
model = YOLO('yolov8n-pose.pt') # Charger un modèle Pose officiel
|
|
|
|
|
|
model = YOLO('chemin/vers/best.pt') # Charger un modèle entraîné personnalisé
|
|
|
|
|
|
|
|
|
|
|
|
# Effectuer le suivi avec le modèle
|
|
|
|
|
|
results = model.track(source="https://youtu.be/LNwODJXcvt4", show=True) # Suivi avec le traceur par défaut
|
|
|
|
|
|
results = model.track(source="https://youtu.be/LNwODJXcvt4", show=True, tracker="bytetrack.yaml") # Suivi avec le traceur ByteTrack
|
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
|
|
=== "CLI"
|
|
|
|
|
|
|
|
|
|
|
|
```bash
|
|
|
|
|
|
# Effectuer le suivi avec divers modèles en utilisant l'interface en ligne de commande
|
|
|
|
|
|
yolo track model=yolov8n.pt source="https://youtu.be/LNwODJXcvt4" # Modèle Detect officiel
|
|
|
|
|
|
yolo track model=yolov8n-seg.pt source="https://youtu.be/LNwODJXcvt4" # Modèle Segment officiel
|
|
|
|
|
|
yolo track model=yolov8n-pose.pt source="https://youtu.be/LNwODJXcvt4" # Modèle Pose officiel
|
|
|
|
|
|
yolo track model=chemin/vers/best.pt source="https://youtu.be/LNwODJXcvt4" # Modèle entraîné personnalisé
|
|
|
|
|
|
|
|
|
|
|
|
# Suivi en utilisant le traceur ByteTrack
|
|
|
|
|
|
yolo track model=chemin/vers/best.pt tracker="bytetrack.yaml"
|
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
|
|
Comme on peut le voir dans l'utilisation ci-dessus, le suivi est disponible pour tous les modèles Detect, Segment et Pose exécutés sur des vidéos ou des sources de diffusion.
|
|
|
|
|
|
|
|
|
|
|
|
## Configuration
|
|
|
|
|
|
|
|
|
|
|
|
### Arguments de Suivi
|
|
|
|
|
|
|
|
|
|
|
|
La configuration du suivi partage des propriétés avec le mode Prédiction, telles que `conf`, `iou`, et `show`. Pour des configurations supplémentaires, référez-vous à la page [Predict](https://docs.ultralytics.com/modes/predict/) du modèle.
|
|
|
|
|
|
|
|
|
|
|
|
!!! exemple ""
|
|
|
|
|
|
|
|
|
|
|
|
=== "Python"
|
|
|
|
|
|
|
|
|
|
|
|
```python
|
|
|
|
|
|
from ultralytics import YOLO
|
|
|
|
|
|
|
|
|
|
|
|
# Configurer les paramètres de suivi et exécuter le traceur
|
|
|
|
|
|
model = YOLO('yolov8n.pt')
|
|
|
|
|
|
results = model.track(source="https://youtu.be/LNwODJXcvt4", conf=0.3, iou=0.5, show=True)
|
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
|
|
=== "CLI"
|
|
|
|
|
|
|
|
|
|
|
|
```bash
|
|
|
|
|
|
# Configurer les paramètres de suivi et exécuter le traceur en utilisant l'interface en ligne de commande
|
|
|
|
|
|
yolo track model=yolov8n.pt source="https://youtu.be/LNwODJXcvt4" conf=0.3, iou=0.5 show
|
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
|
|
### Sélection du Traceur
|
|
|
|
|
|
|
|
|
|
|
|
Ultralytics vous permet également d'utiliser un fichier de configuration de traceur modifié. Pour cela, faites simplement une copie d'un fichier de configuration de traceur (par exemple, `custom_tracker.yaml`) à partir de [ultralytics/cfg/trackers](https://github.com/ultralytics/ultralytics/tree/main/ultralytics/cfg/trackers) et modifiez toute configuration (à l'exception du `tracker_type`) selon vos besoins.
|
|
|
|
|
|
|
|
|
|
|
|
!!! exemple ""
|
|
|
|
|
|
|
|
|
|
|
|
=== "Python"
|
|
|
|
|
|
|
|
|
|
|
|
```python
|
|
|
|
|
|
from ultralytics import YOLO
|
|
|
|
|
|
|
|
|
|
|
|
# Charger le modèle et exécuter le traceur avec un fichier de configuration personnalisé
|
|
|
|
|
|
model = YOLO('yolov8n.pt')
|
|
|
|
|
|
results = model.track(source="https://youtu.be/LNwODJXcvt4", tracker='custom_tracker.yaml')
|
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
|
|
=== "CLI"
|
|
|
|
|
|
|
|
|
|
|
|
```bash
|
|
|
|
|
|
# Charger le modèle et exécuter le traceur avec un fichier de configuration personnalisé en utilisant l'interface en ligne de commande
|
|
|
|
|
|
yolo track model=yolov8n.pt source="https://youtu.be/LNwODJXcvt4" tracker='custom_tracker.yaml'
|
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
|
|
Pour une liste complète des arguments de suivi, référez-vous à la page [ultralytics/cfg/trackers](https://github.com/ultralytics/ultralytics/tree/main/ultralytics/cfg/trackers).
|
|
|
|
|
|
|
|
|
|
|
|
## Exemples Python
|
|
|
|
|
|
|
|
|
|
|
|
### Boucle de Persistance des Pistes
|
|
|
|
|
|
|
|
|
|
|
|
Voici un script Python utilisant OpenCV (`cv2`) et YOLOv8 pour exécuter le suivi d'objet sur des images vidéo. Ce script suppose toujours que vous avez déjà installé les packages nécessaires (`opencv-python` et `ultralytics`). L'argument `persist=True` indique au traceur que l'image ou la trame actuelle est la suivante dans une séquence et s'attend à ce que les pistes de l'image précédente soient présentes dans l'image actuelle.
|
|
|
|
|
|
|
|
|
|
|
|
!!! exemple "Boucle for streaming avec suivi"
|
|
|
|
|
|
|
|
|
|
|
|
```python
|
|
|
|
|
|
import cv2
|
|
|
|
|
|
from ultralytics import YOLO
|
|
|
|
|
|
|
|
|
|
|
|
# Charger le modèle YOLOv8
|
|
|
|
|
|
model = YOLO('yolov8n.pt')
|
|
|
|
|
|
|
|
|
|
|
|
# Ouvrir le fichier vidéo
|
|
|
|
|
|
video_path = "chemin/vers/video.mp4"
|
|
|
|
|
|
cap = cv2.VideoCapture(video_path)
|
|
|
|
|
|
|
|
|
|
|
|
# Parcourir les images vidéo
|
|
|
|
|
|
while cap.isOpened():
|
|
|
|
|
|
# Lire une image de la vidéo
|
|
|
|
|
|
success, frame = cap.read()
|
|
|
|
|
|
|
|
|
|
|
|
if success:
|
|
|
|
|
|
# Exécuter le suivi YOLOv8 sur l'image, en persistant les pistes entre les images
|
|
|
|
|
|
results = model.track(frame, persist=True)
|
|
|
|
|
|
|
|
|
|
|
|
# Visualiser les résultats sur l'image
|
|
|
|
|
|
annotated_frame = results[0].plot()
|
|
|
|
|
|
|
|
|
|
|
|
# Afficher l'image annotée
|
|
|
|
|
|
cv2.imshow("Suivi YOLOv8", annotated_frame)
|
|
|
|
|
|
|
|
|
|
|
|
# Interrompre la boucle si 'q' est pressée
|
|
|
|
|
|
if cv2.waitKey(1) & 0xFF == ord("q"):
|
|
|
|
|
|
break
|
|
|
|
|
|
else:
|
|
|
|
|
|
# Interrompre la boucle si la fin de la vidéo est atteinte
|
|
|
|
|
|
break
|
|
|
|
|
|
|
|
|
|
|
|
# Relâcher l'objet de capture vidéo et fermer la fenêtre d'affichage
|
|
|
|
|
|
cap.release()
|
|
|
|
|
|
cv2.destroyAllWindows()
|
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
|
|
Veuillez noter le changement de `model(frame)` à `model.track(frame)`, qui active le suivi d'objet à la place de la simple détection. Ce script modifié exécutera le traceur sur chaque image de la vidéo, visualisera les résultats et les affichera dans une fenêtre. La boucle peut être quittée en appuyant sur 'q'.
|
|
|
|
|
|
|
|
|
|
|
|
## Contribuer de Nouveaux Traceurs
|
|
|
|
|
|
|
|
|
|
|
|
Êtes-vous compétent en suivi multi-objets et avez-vous réussi à implémenter ou adapter un algorithme de suivi avec Ultralytics YOLO ? Nous vous invitons à contribuer à notre section Traceurs sur [ultralytics/cfg/trackers](https://github.com/ultralytics/ultralytics/tree/main/ultralytics/cfg/trackers) ! Vos applications et solutions dans le monde réel pourraient être inestimables pour les utilisateurs travaillant sur des tâches de suivi.
|
|
|
|
|
|
|
|
|
|
|
|
En contribuant à cette section, vous aidez à élargir l'éventail des solutions de suivi disponibles au sein du cadre Ultralytics YOLO, ajoutant une autre couche de fonctionnalité et d'utilité pour la communauté.
|
|
|
|
|
|
|
|
|
|
|
|
Pour initier votre contribution, veuillez vous référer à notre [Guide de Contribution](https://docs.ultralytics.com/help/contributing) pour des instructions complètes sur la soumission d'une Pull Request (PR) 🛠️. Nous sommes impatients de voir ce que vous apportez à la table !
|
|
|
|
|
|
|
|
|
|
|
|
Ensemble, améliorons les capacités de suivi de l'écosystème Ultralytics YOLO 🙏 !
|
