Annotationseditor#

Die Ultralytics Platform enthält einen Annotationseditor zum Beschriften von Bildern mit Begrenzungsrahmen, Polygonen, Schlüsselpunkten, orientierten Begrenzungsrahmen und Klassen. Der Editor unterstützt manuelles Zeichnen, intelligente Annotationen mit SAM und Vorhersagen kompatibler YOLO-Modelle.

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

Unterstützte Aufgabentypen#

Der Annotationseditor bietet Werkzeuge für 6 YOLO-Aufgabentypen:

Ground Truth für die Tiefenschätzung ist eine hochgeladene zugehörige Karte und wird nicht gezeichnet. Daher wird der Editor bei einem Tiefendatensatz schreibgeschützt geöffnet.

Aufgabendetails#

Erste Schritte#

So annotierst du Bilder:

1. Navigiere zu deinem Datensatz
2. Klicke einmal auf ein Bild, um den Vollbild-Annotationseditor zu öffnen
3. Verwende den standardmäßigen Modus Draw oder wechsle, sofern unterstützt, zu Smart
4. Wähle eine Klasse aus und füge Annotationen direkt im Bild hinzu oder passe sie an
5. Wechsle zu einem anderen Bild oder schließe den Editor; Änderungen werden nach jeder Bearbeitung automatisch gespeichert

Bei Datensätzen, die du bearbeiten kannst, sind die Annotationssteuerungen auf dem Desktop aktiv, sobald der Vollbild-Viewer geöffnet wird. Es gibt keinen separaten Bearbeitungsmodus und keine Schaltfläche Edit. Auf Mobilgeräten und wenn du keinen Bearbeitungszugriff hast, ist der Vollbild-Viewer schreibgeschützt.

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

Annotationsmodi#

Draw ist der Standardmodus für räumliche Annotationsaufgaben. Für Objektserkennungs-, Segmentierungs-, semantische, Posen- und OBB-Datensätze bietet die Symbolleiste auch den Modus Smart, wenn die intelligente Annotation verfügbar ist:

Die Posenannotation verwendet Draw mit einer Skelettvorlage; der Modus Smart bietet ausschließlich YOLO-Posenmodelle ohne SAM-Auswahl oder Auto-Anwenden-Umschalter. Die Klassifizierung verwendet direkt die Klassenseitenleiste und zeigt überhaupt keine Zeichensymbolleiste oder Smart-Schaltfläche.

Intelligente Annotationen sind derzeit für verbundene Datensätze mit Cloud- oder On-Premise-Speicher nicht verfügbar.

Werkzeuge im Zeichenmodus#

Begrenzungsrahmen (Detect)#

Zeichne rechteckige Rahmen um Objekte:

1. Wähle eine Klasse in der Klassen-Seitenleiste aus
2. Klicke im standardmäßigen Modus Draw und ziehe, um ein Rechteck zu zeichnen
3. Lasse die Maustaste los, um den Rahmen fertigzustellen

Polygon (Segment)#

Zeichne präzise Polygonmasken:

1. Wähle eine Klasse in der Klassen-Seitenleiste aus
2. Klicke im standardmäßigen Modus Draw, um Scheitelpunkte hinzuzufügen, oder halte Shift gedrückt und bewege die Maus, um Punkte freihändig dicht aneinander zu zeichnen
3. Doppelklicke, klicke auf den ersten Scheitelpunkt oder drücke Enter oder Escape, um das Polygon zu schließen

Schlüsselpunkt (Pose)#

Annotiere Posen mithilfe von Skelettvorlagen. Wähle eine Vorlage aus der Werkzeugleiste aus, klicke einmal, um alle Schlüsselpunkte zu platzieren, und ziehe anschließend einzelne Schlüsselpunkte, um ihre Positionen anzupassen.

1. Wähle eine Klasse in der Klassen-Seitenleiste aus
2. Wähle im standardmäßigen Modus Draw eine Skelettvorlage aus der Vorlagenauswahl in der Werkzeugleiste aus
3. Klicke auf das Bild, um alle Schlüsselpunkte gleichzeitig zu platzieren
4. Ziehe einzelne Schlüsselpunkte, um ihre Positionen anzupassen

Integrierte Skelettvorlagen#

Der Editor enthält 5 integrierte Vorlagen:

Benutzerdefinierte Skelettvorlagen#

Erstelle benutzerdefinierte Vorlagen für jede Posenstruktur:

1. Klicke neben der Vorlagenauswahl auf die Schaltfläche +
2. Klicke optional auf Start from..., um Schlüsselpunkte und Verbindungen aus einer vorhandenen Vorlage als Ausgangspunkt zu laden
3. Platziere Schlüsselpunkte durch Klicken auf der Arbeitsfläche
4. Benenne jeden Schlüsselpunkt und passe die Farben an
5. Verbinde Schlüsselpunkte, indem du zwei Punkte auswählst (Verbindungen werden automatisch gezeichnet, während du aufeinanderfolgende Schlüsselpunkte platzierst)
6. Speichere die Vorlage, um sie in deinem gesamten Datensatz wiederzuverwenden

Benutzerdefinierte Vorlagen werden in deinem Konto gespeichert und stehen in allen Pose-Datensätzen zur Verfügung.

Orientierter Begrenzungsrahmen (OBB)#

Zeichne gedrehte Boxen für schräg ausgerichtete Objekte:

1. Wähle eine Klasse in der Klassen-Seitenleiste aus
2. Klicke im standardmäßigen Modus Draw und ziehe, um eine erste Box zu zeichnen
3. Passe den Winkel mit dem Drehgriff an
4. Ziehe die Eckgriffe, um die Größe zu ändern

Klassifizierung (Classify)#

Weise Bildebenen-Klassenbezeichnungen zu:

1. Klicke auf ein Bild, um den Editor im Vollbildmodus zu öffnen
2. Wähle eine Klasse in der Klassen-Seitenleiste aus oder drücke eine Zifferntaste von 1-9

Intelligente Annotation#

Die intelligente Annotation fügt dem Editor eine modellgestützte Annotation hinzu. Im intelligenten Modus kannst du das Segment Anything Model (SAM) für eine klickbasierte Annotation verwenden oder vortrainierte Ultralytics YOLO-Modelle und deine eigenen feinabgestimmten YOLO-Modelle nutzen, um Vorhersagen als Annotationen hinzuzufügen. Die intelligente SAM-Annotation ist für die Aufgaben detect, segment, semantic und OBB verfügbar; die intelligente YOLO-Annotation deckt zudem pose ab.

Intelligente SAM-Annotation#

Wenn ein SAM-Modell ausgewählt ist:

1. Wähle Smart aus oder drücke S
2. Klicke auf das Objekt, das du annotieren möchtest – SAM erzeugt in Echtzeit eine erste Maske
3. Verfeinere die Maske mit zusätzlichen Klicks: Klicke außerhalb der aktuellen Maske, um den abgedeckten Bereich zu erweitern, oder innerhalb der aktuellen Maske, um Bereiche abzuziehen
4. Drücke Enter oder Escape, um die Annotation zu speichern, oder aktiviere auto-apply für Arbeitsabläufe mit nur einem Klick

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

Die intelligente SAM-Annotation kann Folgendes erzeugen:

• Polygone für Segmentierungsaufgaben
• Begrenzungsboxen für Erkennungsaufgaben
• Orientierte Boxen für OBB-Aufgaben

Modus „Automatisch anwenden“#

Der Modus „Automatisch anwenden“ beschleunigt die intelligente Annotation, indem die SAM-Maske nach jedem Klick automatisch gespeichert wird – du musst Enter nicht drücken. Aktiviere oder deaktiviere ihn mit der Schaltfläche „Automatisch anwenden“ in der Werkzeugleiste oder drücke A.

Auswahl des SAM-Modells#

Wenn der Smart-Modus aktiv ist, erscheint ein Modellwähler in der Werkzeugleiste. Sechs SAM-Modelle stehen zur Verfügung — wähle basierend auf dem Kompromiss zwischen Geschwindigkeit und Genauigkeit, der zu deinem Datensatz passt:

Das Wechseln von Modellen bei aktivem Smart-Modus initialisiert den Prädiktor für das aktuelle Bild automatisch neu.

Intelligente YOLO-Annotation#

Wenn ein YOLO-Modell ausgewählt ist, kann die intelligente Annotation Vorhersagen aus vortrainierten Ultralytics-Modellen oder deinen eigenen feinabgestimmten Modellen hinzufügen.

1. Wähle Smart aus oder drücke S
2. Wähle ein YOLO-Modell aus der Modellauswahl in der Werkzeugleiste aus (Official oder My Models)
3. Klicke auf Predict
4. Überprüfe die hinzugefügten Annotationen und nimm alle erforderlichen Korrekturen vor

Stapel-Annotation#

Die Stapel-Annotation führt ein YOLO-Modell über einen gesamten Datensatz anstelle des geöffneten Bildes aus. Öffne sie über die Datensatzseite unter Weitere Aktionen > Stapel-Annotation oder über die Aktion Alle inferieren im Toast nach einer YOLO-Vorhersage im Editor. Sie steht Datensatzredakteuren für auf der Platform gehostete Datensätze mit bis zu drei Bildkanälen für jede Aufgabe außer Tiefenbildern zur Verfügung.

1. Wähle ein Modell aus der Auswahl (Official oder My Models).
2. Passe die Regler für Konfidenz (Standard 0.25) und IoU (Standard 0.7) an – der Testlauf-Streifen zeigt beim Verschieben, was das Modell auf einigen Beispielbildern findet.
3. Aktiviere Mit annotierten Bildern, um die Ausführung auch auf Bilder anzuwenden, die bereits Labels haben; der Durchlauf fügt hinzu, was das Modell findet, und behält die bereits vorhandenen Labels bei.
4. Überprüfe die Geschätzten Kosten und klicke auf Start.

Standardmäßig werden nur unannotierte Bilder annotiert, und bestehende Labels werden niemals geändert. Ein Durchlauf benötigt Datensatzklassen. Wenn sich die Klassen des Modells von denen des Datensatzes unterscheiden, ordnet ein Schritt Klassen zuordnen jede Modellklasse einer Datensatzklasse zu oder überspringt sie, und bei einem Datensatz ohne Klassen erstellt er diese – der Durchlauf startet erst, nachdem die Klassen existieren. Das Starten eines Durchlaufs speichert zuerst eine Datensatzversion, sodass du den Datensatz wiederherstellen kannst, wenn dir das Ergebnis nicht gefällt.

Die Datensatzseite zeigt den Fortschritt des Durchlaufs an, und Stopp behält die bisher verarbeiteten Bilder bei und stellt sie in Rechnung. Wenn der Durchlauf abgeschlossen ist, zeigt eine Zusammenfassung die verarbeiteten Bilder sowie die hinzugefügten Annotationen und Klassen.

Klassen-Seitenleiste#

Der Annotationseditor enthält auf der rechten Seite der Arbeitsfläche eine einklappbare Klassen-Seitenleiste. Die Seitenleiste bietet:

• Klassen suchen: Filtere die Klassenliste, indem du in das Suchfeld tippst. Drücke bei einer exakten Übereinstimmung Enter, um sie auszuwählen, oder erstelle eine neue Klasse, wenn keine Übereinstimmung vorhanden ist.
• Neue Klasse direkt erstellen: Klicke unten in der Liste auf Add class, gib einen Namen ein und wähle optional eine benutzerdefinierte Farbe aus. Drücke Enter, um die Klasse zu erstellen.
• Klassennamen direkt bearbeiten: Bewege den Mauszeiger über einen Klassennamen und klicke auf das Stiftsymbol, um ihn umzubenennen.
• Farbauswahl: Klicke auf das Farbfeld neben einer Klasse, um ihre Farbe zu ändern.
• Annotationsanzahl pro Klasse: Jede Klassenzeile zeigt hochgestellt die Anzahl der Annotationen an.
• Auf- und zuklappen: Klicke auf das Chevron, um eine Klasse aufzuklappen und die einzelnen darunter aufgeführten Annotationen anzuzeigen.
• Bidirektionale Hervorhebung beim Überfahren: Wenn du den Mauszeiger über eine Annotation auf der Arbeitsfläche bewegst, wird sie in der Seitenleiste hervorgehoben – und umgekehrt. Die Seitenleiste scrollt automatisch zur entsprechenden Klasse.
• Gesamte Klasse aus- oder einblenden: Klicke auf das Augensymbol in einer Klassenzeile, um alle Annotationen dieser Klasse gleichzeitig auszublenden oder einzublenden.
• Einzelne Annotationen aus- oder einblenden: Klicke auf das Augensymbol in einer beliebigen Annotationszeile, um ihre Sichtbarkeit auf der Arbeitsfläche umzuschalten.
• Annotationen löschen: Klicke auf das Papierkorbsymbol in einer beliebigen Annotationszeile, um sie zu löschen.
• Tastenkürzel: Drücke 1-9, um schnell die ersten 9 Klassen auszuwählen, oder H, um die Sichtbarkeit aller Annotationen im Bild umzuschalten.

Kontextmenü#

Klicke mit der rechten Maustaste auf ausgewählte Annotationen, um ein Kontextmenü zu öffnen mit:

Sichtbarkeitssteuerung#

Über das Sichtbarkeitsmenü (Augensymbol) kannst du die Anzeige einzelner Elemente umschalten:

Fadenkreuz-Cursor#

Während der Annotation verfolgt eine Fadenkreuzebene die Cursorposition und zeigt Pixelkoordinaten auf der Zeichenfläche an. Das hilft dir, Annotationen präzise zu platzieren. Du kannst die Funktion über das Sichtbarkeitsmenü umschalten.

SAM-Vorschau bei Mauszeigerkontakt#

Im Smart-Modus bietet SAM eine Echtzeitvorschau bei Mauszeigerkontakt, bevor du Punkte anklickst. Diese Vorschau ist für die Aufgaben detect, segment, semantic und OBB verfügbar. Sobald du Punkte zur Verfeinerung hinzufügst, wird die Vorschau aktualisiert und berücksichtigt die aktuelle Maske sowie den Annotationstyp der aktiven Aufgabe.

Bearbeiten von Polygonpunkten#

Bei Segment-Annotationen kannst du die Polygonpunkte nach dem Zeichnen bearbeiten:

• Punkte verschieben: Ziehe einen beliebigen Punkt, um ihn neu zu positionieren
• Punkte löschen: Wähle einen Punkt aus und drücke Delete, um ihn zu entfernen

Klassenverwaltung#

Klassen erstellen#

Definiere im Tab Classes die Annotationklassen für deinen Datensatz:

1. Öffne den Tab Classes
2. Gib im Eingabefeld unten einen Klassennamen ein
3. Klicke auf Add oder drücke Enter
4. Eine Farbe wird automatisch aus der Ultralytics-Farbpalette zugewiesen

Neue Klasse während der Annotation hinzufügen#

Du kannst direkt während der Annotation neue Klassen erstellen, ohne den Editor zu verlassen:

1. Zeichne eine Annotation in das Bild
2. Klicke in der Klassen-Seitenleiste auf Add class (oder gib im Suchfeld der Seitenleiste einen neuen Namen ein)
3. Gib den Klassennamen ein
4. Drücke die Eingabetaste, um die Klasse zu erstellen und zuzuweisen

So erhältst du einen nahtlosen Arbeitsablauf und kannst Klassen definieren, sobald du in deinen Daten auf neue Objekttypen stößt.

Klassen bearbeiten#

• Umbenennen: Klicke in der Tabelle auf einen Klassennamen, um ihn direkt zu bearbeiten
• Farbe ändern: Klicke auf das Farbfeld, um die Farbauswahl zu öffnen
• Suchen: Verwende das Suchfeld, um Klassen nach Namen zu filtern
• Sortieren: Klicke auf Spaltenüberschriften, um nach Index, Name, Anzahl der Annotationen oder Anzahl der Bilder zu sortieren

Klassenfarben#

Jeder Klasse wird eine Farbe aus der Ultralytics-Farbpalette zugewiesen. Du kannst Farben über die Farbauswahl im Tab Classes anpassen; die ausgewählten Farben werden im gesamten Datensatz verwendet.

Tastenkürzel#

Effizientes Annotieren mit Tastenkürzeln:

Rückgängig/Wiederholen#

Der Annotationseditor führt einen vollständigen Rückgängig-/Wiederholen-Verlauf:

• Rückgängig: Cmd/Ctrl+Z
• Wiederholen: Cmd/Ctrl+Y

Der Verlauf erfasst:

• Hinzufügen von Annotationen (einzeln und im Stapel)
• Bearbeiten von Annotationen (Verschieben, Größe ändern, Drehen)
• Löschen von Annotationen (einzeln und im Stapel)
• Ändern von Klassen (einzeln und im Stapel)
• Neuordnen von Annotationen (Reihenfolge in der z-Achse)
• Bearbeiten von Polygonpunkten (Hinzufügen, Entfernen, Verschieben)
• Verschieben von Schlüsselpunkten

Annotationen speichern#

Änderungen werden eine Sekunde nach der letzten Bearbeitung einer Annotation automatisch gespeichert. Sie werden auch gespeichert, wenn du zu einem anderen Bild wechselst oder den Vollbildeditor schließt.

• Jetzt speichern: Klicke auf die Speicherschaltfläche oder drücke Cmd/Ctrl+S
• Schließen: Klicke auf die Schaltfläche zum Schließen, außerhalb des Bildes oder drücke Escape; beim Schließen werden ausstehende Änderungen im Hintergrund gespeichert

FAQ#