Éditeur d’annotations#

Ultralytics Platform inclut un éditeur d’annotations pour étiqueter les images avec des boîtes englobantes, des polygones, des points clés, des boîtes orientées et des classifications. L’éditeur prend en charge le dessin manuel, l’annotation intelligente optimisée par SAM et les prédictions de modèles YOLO compatibles.

graph TB
    subgraph Draw["Shape set by the dataset task"]
        A[Box]:::start & B[Polygon]:::start & C[Classify]:::start & D[Keypoint]:::start & E[OBB]:::start
    end
    subgraph AI["AI-Assisted"]
        F[SAM Smart]:::start
        G[YOLO Predict]:::start
    end
    Draw --> H[Save Labels]:::out
    AI --> H

    classDef start fill:#4CAF50,color:#fff
    classDef out fill:#9C27B0,color:#fff

Types de tâches pris en charge#

L’éditeur d’annotations fournit des outils d’annotation pour 6 types de tâches YOLO :

La vérité terrain de profondeur est une carte associée que tu importes, et non un élément que tu dessines ; l’éditeur s’ouvre donc en lecture seule pour un jeu de données de profondeur.

Détails des tâches#

Premiers pas#

Pour annoter des images :

1. Accède à ton jeu de données
2. Clique une fois sur une image pour ouvrir l’éditeur d’annotations en plein écran
3. Utilise le mode Draw par défaut ou passe au mode Smart lorsqu’il est pris en charge
4. Sélectionne une classe, puis ajoute ou ajuste directement les annotations sur l’image
5. Passe à une autre image ou ferme l’éditeur ; les modifications sont enregistrées automatiquement après chaque modification

Pour les jeux de données que tu peux modifier, les commandes d’annotation sont actives dès que la visionneuse plein écran s’ouvre sur ordinateur. Il n’existe pas de mode de modification distinct ni de bouton Edit. Sur mobile et lorsque tu n’as pas accès à la modification, la visionneuse plein écran est en lecture seule.

graph LR
    A[Open Dataset]:::start --> B[Click Image]:::proc
    B --> C[Annotate in Fullscreen]:::proc
    C --> D[Changes Auto-Save]:::out
    D --> E[Next Image]:::proc
    E --> B

    classDef start fill:#4CAF50,color:#fff
    classDef proc fill:#2196F3,color:#fff
    classDef out fill:#9C27B0,color:#fff

Modes d’annotation#

Draw est le mode par défaut pour les tâches d'annotation spatiale. Pour les jeux de données de détection, segmentation, sémantique, pose et OBB, la barre d'outils propose également le mode Smart lorsque l'annotation intelligente est disponible :

L'annotation de pose utilise Draw avec un modèle de squelette ; son mode Smart propose uniquement les modèles de pose YOLO, sans sélecteur SAM ni interrupteur d'application automatique. La classification utilise directement la barre latérale des classes et n'affiche aucun bouton de barre d'outils de dessin ni de bouton Smart.

L’annotation intelligente n’est actuellement pas disponible pour les jeux de données connectés reposant sur un stockage cloud ou On Premise.

Outils du mode Dessiner#

Boîte englobante (détection)#

Dessine des boîtes rectangulaires autour des objets :

1. Sélectionne une classe dans la barre latérale des classes
2. Dans le mode Draw par défaut, clique et fais glisser pour dessiner un rectangle
3. Relâche le bouton pour terminer la boîte

Polygone (segmentation)#

Dessine des masques polygonaux précis :

1. Sélectionne une classe dans la barre latérale des classes
2. Dans le mode Draw par défaut, clique pour ajouter des sommets, ou maintiens Shift enfoncé et déplace la souris pour dessiner librement des points rapprochés
3. Double-clique, clique sur le premier sommet ou appuie sur Enter ou Escape pour fermer le polygone

Point clé (pose)#

Annote les poses à l’aide de modèles de squelette. Sélectionne un modèle dans la barre d’outils, clique une fois pour placer tous les points clés, puis fais glisser chaque point clé pour ajuster sa position.

1. Sélectionne une classe dans la barre latérale des classes
2. Dans le mode Draw par défaut, choisis un modèle de squelette dans le sélecteur de modèles de la barre d’outils
3. Clique sur l’image pour placer tous les points clés en une seule fois
4. Fais glisser les points clés individuellement pour ajuster leur position

Modèles de squelette intégrés#

L’éditeur inclut 5 modèles intégrés :

Modèles de squelette personnalisés#

Crée des modèles personnalisés pour toute structure de pose :

1. Clique sur le bouton + à côté du sélecteur de modèles
2. Si tu le souhaites, clique sur Commencer à partir de... pour charger les points clés et les connexions d’un modèle existant comme point de départ
3. Place les points clés sur le canevas en cliquant
4. Nomme chaque point clé et personnalise les couleurs
5. Relie les points clés en sélectionnant deux points (les connexions sont tracées automatiquement lorsque tu places des points clés successifs)
6. Enregistre le modèle pour le réutiliser dans l’ensemble de tes données

Les modèles personnalisés sont enregistrés sur ton compte et disponibles dans tous les jeux de données de pose.

Boîte englobante orientée (OBB)#

Dessine des boîtes orientées pour les objets inclinés :

1. Sélectionne une classe dans la barre latérale des classes
2. Dans le mode Draw par défaut, clique et fais glisser pour dessiner une boîte initiale
3. Utilise la poignée de rotation pour ajuster l’angle
4. Fais glisser les poignées d’angle pour redimensionner

Classification (Classify)#

Attribue des étiquettes de classe au niveau de l’image :

1. Clique sur une image pour ouvrir l’éditeur en plein écran
2. Sélectionne une classe dans la barre latérale des classes ou appuie sur une touche numérique de 1-9

Annotation intelligente#

L'annotation intelligente ajoute l'annotation assistée par modèle à l'éditeur. En mode Intelligent, tu peux utiliser Segment Anything Model (SAM) pour l'annotation basée sur les clics ou utiliser des modèles Ultralytics YOLO pré-entraînés et tes propres modèles YOLO affinés pour ajouter des prédictions en tant qu'annotations. L'annotation intelligente SAM est disponible pour les tâches de détection, segmentation, sémantique et OBB ; l'annotation intelligente YOLO couvre également la pose.

Annotation intelligente avec SAM#

Avec un modèle SAM sélectionné :

1. Sélectionne Smart ou appuie sur S
2. Clique sur l’objet que tu veux annoter — SAM génère un masque initial en temps réel
3. Affine le masque avec des clics supplémentaires : clique à l’extérieur du masque actuel pour ajouter de la couverture, ou clique à l’intérieur du masque actuel pour soustraire des régions
4. Appuie sur Enter ou Escape pour enregistrer l’annotation, ou active l’application automatique pour les flux de travail en un clic

graph LR
    A[Press S]:::start --> B[Left-click Object]:::proc
    B --> C[SAM Generates Mask]:::proc
    C --> D{Auto-apply?}:::decide
    D -->|Yes| E[Mask Applied Automatically]:::out
    D -->|No| F{Accurate?}:::decide
    F -->|Yes| G[Enter to Save]:::out
    F -->|No| H[Add +/- Points]:::proc
    H --> C

    classDef start fill:#4CAF50,color:#fff
    classDef proc fill:#2196F3,color:#fff
    classDef decide fill:#FF9800,color:#fff
    classDef out fill:#9C27B0,color:#fff

L’annotation intelligente SAM peut générer :

• Polygones pour les tâches de segmentation
• Boîtes englobantes pour les tâches de détection
• Boîtes orientées pour les tâches OBB

Mode d’application automatique#

Le mode d’application automatique accélère l’annotation intelligente en enregistrant automatiquement le masque SAM après chaque clic — inutile d’appuyer sur Enter. Active ou désactive ce mode avec le bouton d’application automatique de la barre d’outils ou appuie sur A.

Sélection du modèle SAM#

Quand le mode intelligent est actif, un sélecteur de modèle apparaît dans la barre d'outils. Six modèles SAM sont disponibles — choisis en fonction du compromis entre vitesse et précision qui convient à ton jeu de données :

Changer de modèle lorsque le mode intelligent est actif réinitialise automatiquement le prédicteur pour l'image actuelle.

Annotation intelligente avec YOLO#

Lorsqu’un modèle YOLO est sélectionné, l’annotation intelligente peut ajouter des prédictions provenant de modèles Ultralytics préentraînés ou de tes propres modèles ajustés.

1. Sélectionne Smart ou appuie sur S
2. Sélectionne un modèle YOLO dans le sélecteur de modèles de la barre d’outils (Official ou My Models)
3. Clique sur Predict
4. Vérifie les annotations ajoutées et apporte les corrections nécessaires

Annotation par lot#

L'annotation par lot exécute un modèle YOLO sur un jeu de données entier au lieu de l'image ouverte. Ouvre-la depuis la page du jeu de données avec Plus d'actions > Annotation par lot, ou depuis l'action Inférence totale sur la notification après une prédiction YOLO dans l'éditeur. Elle est disponible pour les éditeurs de jeux de données sur les jeux de données hébergés sur la plateforme avec jusqu'à trois canaux d'image, pour chaque tâche à l'exception de la profondeur.

1. Sélectionne un modèle dans le sélecteur (Official ou My Models)
2. Ajuste les curseurs de confiance (par défaut 0.25) et d'IoU (par défaut 0.7) — la bande Essai montre ce que le modèle trouve sur quelques images d'exemple lorsque tu les déplaces
3. Active Inclure les images annotées pour exécuter également le traitement sur les images qui ont déjà des étiquettes ; l'exécution ajoute ce que le modèle trouve et conserve les étiquettes qu'elles possèdent
4. Examine le Coût estimé et clique sur Démarrer

Par défaut, seules les images non annotées sont annotées, et les étiquettes existantes ne sont jamais modifiées. Une exécution nécessite des classes de jeu de données. Si les classes du modèle diffèrent de celles du jeu de données, une étape Associer les classes associe chaque classe de modèle à une classe de jeu de données ou la ignore, et sur un jeu de données sans classes, elle les crée — l'exécution ne démarre qu'après l'existence des classes. Le lancement d'une exécution enregistre d'abord une version du jeu de données, afin que tu puisses restaurer le jeu de données si le résultat ne te plaît pas.

La page du jeu de données affiche la progression de l'exécution, et Arrêter conserve et facture les images traitées jusqu'à présent. Lorsque l'exécution se termine, un résumé indique les images traitées ainsi que les annotations et les classes ajoutées.

Barre latérale des classes#

L’éditeur d’annotations comprend une barre latérale des classes réductible à droite du canevas. Cette barre latérale propose :

• Rechercher des classes : filtre la liste des classes en saisissant du texte dans le champ de recherche. Appuie sur Enter lorsqu’une correspondance exacte est trouvée pour la sélectionner, ou crée une nouvelle classe si aucune correspondance n’existe.
• Créer une classe directement : clique sur Add class en bas de la liste, saisis un nom et, si tu le souhaites, choisis une couleur personnalisée. Appuie sur Enter pour créer la classe.
• Modifier directement le nom d’une classe : survole un nom de classe et clique sur l’icône en forme de crayon pour le renommer.
• Sélecteur de couleurs : clique sur l’échantillon de couleur à côté d’une classe pour modifier sa couleur.
• Nombre d’annotations par classe : chaque ligne de classe affiche en exposant le nombre d’annotations.
• Développer/réduire : clique sur le chevron pour développer une classe et afficher les annotations individuelles répertoriées dessous.
• Mise en évidence bidirectionnelle au survol : le survol d’une annotation sur le canevas la met en évidence dans la barre latérale, et inversement. La barre latérale fait défiler automatiquement la liste jusqu’à la classe concernée.
• Masquer/afficher une classe entière : clique sur l’icône en forme d’œil d’une ligne de classe pour masquer ou afficher simultanément toutes les annotations de cette classe.
• Masquer/afficher des annotations individuelles : clique sur l’icône en forme d’œil d’une ligne d’annotation pour activer ou désactiver sa visibilité sur le canevas.
• Supprimer des annotations : clique sur l’icône de corbeille d’une ligne d’annotation pour la supprimer.
• Raccourcis clavier : appuie sur 1-9 pour sélectionner rapidement les 9 premières classes, ou sur H pour activer ou désactiver la visibilité de toutes les annotations de l’image.

Menu contextuel#

Effectue un clic droit sur les annotations sélectionnées pour ouvrir un menu contextuel contenant :

Contrôles de visibilité#

La liste déroulante de visibilité (icône en forme d’œil) te permet d’activer ou de désactiver l’affichage des éléments individuels :

Curseur en forme de réticule#

Pendant l’annotation, une superposition en forme de réticule suit la position du curseur et affiche les coordonnées des pixels sur le canevas. Cela aide à placer les annotations avec précision. Tu peux l’activer ou le désactiver via la liste déroulante de visibilité.

Aperçu au survol avec SAM#

En mode Smart, SAM fournit un aperçu au survol en temps réel avant que tu ne cliques sur un point. Cet aperçu est disponible pour les tâches detect, segment, semantic et OBB. Une fois que tu ajoutes des clics d’affinage, l’aperçu se met à jour pour refléter le masque actuel et le type d’annotation de la tâche active.

Modification des sommets d’un polygone#

Pour les annotations de segmentation, tu peux modifier les sommets du polygone après l’avoir tracé :

• Déplacer les sommets : fais glisser une poignée de sommet pour la repositionner
• Supprimer des sommets : sélectionne un sommet et appuie sur Delete pour le supprimer

Gestion des classes#

Création de classes#

Définis les classes d’annotation de ton jeu de données dans l’onglet Classes :

1. Accède à l’onglet Classes
2. Utilise le champ de saisie en bas pour saisir un nom de classe
3. Clique sur Add ou appuie sur Enter
4. Une couleur est automatiquement attribuée à partir de la palette Ultralytics

Ajouter une classe pendant l’annotation#

Tu peux créer de nouvelles classes directement pendant l’annotation sans quitter l’éditeur :

1. Trace une annotation sur l’image
2. Dans la barre latérale des classes, clique sur Add class (ou saisis un nouveau nom dans le champ de recherche de la barre latérale)
3. Saisis le nom de la classe
4. Appuie sur Entrée pour la créer et l’attribuer

Cela permet un flux de travail fluide dans lequel tu peux définir les classes à mesure que tu rencontres de nouveaux types d’objets dans tes données.

Modifier les classes#

• Renommer : clique sur un nom de classe dans le tableau pour le modifier directement
• Modifier la couleur : clique sur l’échantillon de couleur pour ouvrir le sélecteur de couleurs
• Rechercher : utilise le champ de recherche pour filtrer les classes par nom
• Trier : clique sur les en-têtes de colonne pour trier par index, nom, nombre d’annotations ou nombre d’images

Couleurs des classes#

Chaque classe se voit attribuer une couleur de la palette Ultralytics. Tu peux personnaliser les couleurs à l’aide du sélecteur de couleurs dans l’onglet Classes ; les couleurs sélectionnées sont utilisées dans tout le jeu de données.

Raccourcis clavier#

Annote efficacement avec les raccourcis clavier :

Annuler/Rétablir#

L’éditeur d’annotations conserve un historique complet des actions d’annulation et de rétablissement :

• Annuler : Cmd/Ctrl+Z
• Rétablir : Cmd/Ctrl+Y

L’historique suit :

• Ajout d’annotations (individuelles et par lots)
• Modification d’annotations (déplacement, redimensionnement, rotation)
• Suppression d’annotations (individuelles et par lots)
• Modifier les classes (individuellement et par lots)
• Réorganiser les annotations (ordre d’empilement)
• Modifier les sommets des polygones (ajouter, supprimer, déplacer)
• Déplacer les points clés

Enregistrer les annotations#

Les modifications sont enregistrées automatiquement une seconde après la dernière modification d’une annotation. Elles sont également enregistrées lorsque tu passes à une autre image ou que tu fermes l’éditeur en plein écran.

• Enregistrer maintenant : clique sur le bouton d’enregistrement ou appuie sur Cmd/Ctrl+S
• Fermer : clique sur le bouton de fermeture, clique en dehors de l’image ou appuie sur Escape ; la fermeture déclenche un enregistrement en arrière-plan des modifications en attente

FAQ#