Annotations-Editor#

Ultralytics Platform enthält einen Annotationseditor zum Markieren von Bildern mit Bounding Boxes, Polygonen, Keypoints, orientierten Boxen und Klassifikationen. Der Editor unterstützt manuelles Zeichnen, SAM-gestützte intelligente Annotationen und Vorhersagen von kompatiblen YOLO Modellen.

graph TB
    subgraph Draw["Draw Mode"]
        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 Annotations-Editor unterstützt alle 6 YOLO-Aufgabentypen:

Aufgabendetails#

Erste Schritte#

Um Bilder zu annotieren:

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

Bei Datensätzen, die du bearbeiten kannst, sind die Annotationssteuerelemente aktiv, sobald sich der Vollbild-Viewer auf dem Desktop öffnet. Es gibt keinen separaten Bearbeitungsmodus oder eine Edit-Schaltfläche. Auf Mobilgeräten und wenn du keine Bearbeitungsrechte 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 Detektions-, Segmentierungs-, semantische und OBB-Datensätze bietet die Symbolleiste auch den Modus Smart an, wenn die intelligente Annotation verfügbar ist:

Die Pose-Annotation verwendet Draw mit einer Skelettvorlage. Die Klassifikation verwendet die Klassenseitenleiste direkt und zeigt die Werkzeugleiste zum Zeichnen nicht an.

Intelligente Annotationen sind für verbundene Datensätze derzeit nicht verfügbar.

Draw-Modus-Werkzeuge#

Bounding Box (Detect)#

Zeichne rechteckige Boxen um Objekte:

1. Wähle eine Klasse in der Klassenseitenleiste aus.
2. Klicke im Standardmodus Draw und ziehe, um ein Rechteck zu zeichnen.
3. Loslassen, um die Box abzuschließen

Polygon (Segment)#

Zeichne präzise Polygonmasken:

1. Wähle eine Klasse in der Klassenseitenleiste aus.
2. Klicke im Standardmodus Draw, um Eckpunkte hinzuzufügen, oder halte Shift gedrückt und Bewege die Maus, um dichte Punkte frei Hand zu zeichnen.
3. Mache einen Doppelklick, klicke auf den ersten Eckpunkt oder drücke Enter bzw. Escape, um das Polygon zu schließen.

Keypoint (Pose)#

Annotiere Posen mithilfe von Skelett-Vorlagen. Wähle eine Vorlage aus der Werkzeugleiste, klicke einmal, um alle Keypoints zu platzieren, und ziehe dann einzelne Keypoints, um die Positionen anzupassen.

1. Wähle eine Klasse in der Klassenseitenleiste aus.
2. Wähle im Standardmodus Draw eine Skelettvorlage aus der Vorlagenauswahl in der Werkzeugleiste aus.
3. Klicke auf das Bild, um alle Keypoints auf einmal zu platzieren
4. Ziehe einzelne Keypoints, um ihre Positionen anzupassen

Integrierte Skelett-Vorlagen#

Der Editor enthält 5 integrierte Vorlagen:

Benutzerdefinierte Skelett-Vorlagen#

Erstelle benutzerdefinierte Vorlagen für jede Posenstruktur:

1. Klicke auf den +-Button neben der Vorlagenauswahl
2. Optional kannst du auf Start from... klicken, um Keypoints und Verbindungen aus einer bestehenden Vorlage als Ausgangspunkt zu laden
3. Platziere Keypoints auf der Leinwand durch Klicken
4. Benenne jeden Keypoint und passe die Farben an
5. Verbinde Keypoints, indem du zwei Punkte auswählst (Verbindungen werden automatisch gezeichnet, während du nacheinander Keypoints platzierst)
6. Speichere die Vorlage zur Wiederverwendung für deinen Datensatz

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

Orientierte Bounding Box (OBB)#

Zeichne gedrehte Boxen für angewinkelte Objekte:

1. Wähle eine Klasse in der Klassenseitenleiste aus.
2. Klicke im Standardmodus Draw und ziehe, um eine anfängliche Box zu zeichnen.
3. Nutze den Rotationsgriff, um den Winkel anzupassen
4. Ziehe an den Eckgriffen, um die Größe zu ändern

Klassifizierung (Classify)#

Weise Klassen-Labels auf Bildebene zu:

1. Klicke auf ein Bild, um den Vollbildeditor zu öffnen.
2. Wähle eine Klasse in der Klassenseitenleiste aus oder drücke eine Zahlentaste von 1-9.

Smarte Annotation#

Die intelligente Annotation fügt dem Editor eine modellgestützte Annotation hinzu. Im Smart-Modus kannst du das Segment Anything Model (SAM) für eine klickbasierte Annotation verwenden oder vortrainierte Ultralytics YOLO-Modelle sowie deine eigenen feinabgestimmten YOLO-Modelle nutzen, um Vorhersagen als Annotationen hinzuzufügen. Die intelligente Annotation steht für detect-, segment-, semantic- und OBB-Aufgaben zur Verfügung.

SAM Smarte Annotation#

Mit einem ausgewählten SAM-Modell:

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

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

SAM smarte Annotation kann generieren:

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

Auto-Apply-Modus#

Der Auto-Apply-Modus beschleunigt die smarte Annotation, indem die SAM-Maske nach jedem Klick automatisch gespeichert wird – kein Drücken von Enter erforderlich. Schalte ihn über den Auto-Apply-Button in der Werkzeugleiste um oder drücke A.

SAM-Modellauswahl#

Wenn der Smart-Modus aktiv ist, erscheint ein Modellauswähler in der Werkzeugleiste. Fünf SAM-Modelle sind verfügbar – wähle basierend auf dem Kompromiss zwischen Geschwindigkeit und Genauigkeit, der zu deinem Datensatz passt:

Das Wechseln von Modellen, während der Smart-Modus aktiv ist, initialisiert den Prädiktor für das aktuelle Bild automatisch neu.

YOLO Smarte Annotation#

Mit einem ausgewählten YOLO-Modell kann die smarte Annotation Vorhersagen von 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 dem Modellauswähler in der Werkzeugleiste (Official oder My Models)
3. Klicke auf Predict
4. Überprüfe die hinzugefügten Annotationen und nimm notwendige Korrekturen vor

Klassen-Seitenleiste#

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

• Klassen suchen: Filtere die Klassenliste durch Eingabe in das Suchfeld. Drücke Enter bei einer exakten Übereinstimmung, um sie auszuwählen, oder erstelle eine neue Klasse, falls keine Übereinstimmung existiert.
• Neue Klasse inline erstellen: Klicke unten in der Liste auf Add class, gib einen Namen ein und wähle optional eine benutzerdefinierte Farbe. Drücke Enter zum Erstellen.
• Klassennamen inline bearbeiten: Bewege den Mauszeiger über einen Klassennamen und klicke auf das Stift-Symbol, um ihn umzubenennen.
• Farbauswahl: Klicke auf das Farbfeld neben einer Klasse, um deren Farbe zu ändern.
• Annotationsanzahl pro Klasse: Jede Klassenzeile zeigt eine hochgestellte Anzahl an Annotationen an.
• Auf-/zuklappen: Klicke auf das Chevron-Symbol, um eine Klasse zu erweitern und die darunter aufgelisteten einzelnen Annotationen zu sehen.
• Bidirektionales Hover-Highlighting: Das Bewegen des Mauszeigers über eine Annotation auf der Arbeitsfläche hebt sie in der Seitenleiste hervor und umgekehrt. Die Seitenleiste scrollt automatisch zur relevanten Klasse.
• Einzelne Annotationen aus-/einblenden: Klicke auf das Auge-Symbol in einer Annotationszeile, um deren Sichtbarkeit auf der Arbeitsfläche umzuschalten.
• Annotationen löschen: Klicke auf das Papierkorb-Symbol in einer Annotationszeile, um sie zu löschen.
• Tastaturkürzel: Drücke 1-9, um schnell die ersten 9 Klassen auszuwählen.

Kontextmenü#

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

Sichtbarkeits-Steuerelemente#

Das Sichtbarkeits-Dropdown (Auge-Symbol) ermöglicht das Umschalten der Anzeige einzelner Elemente:

Fadenkreuz-Cursor#

Während der Annotation verfolgt ein Fadenkreuz-Overlay die Cursorposition und zeigt Pixelkoordinaten auf dem Canvas an. Dies hilft dabei, Annotationen präzise zu platzieren. Schalte es über das Sichtbarkeits-Dropdown um.

SAM Hover-Vorschau#

Im Smart-Modus bietet SAM eine Echtzeit-Hover-Vorschau, bevor du Punkte klickst. Diese Vorschau ist für detect-, segment-, semantic- und OBB-Aufgaben verfügbar. Sobald du Verfeinerungsklicks hinzufügst, aktualisiert sich die Vorschau, um die aktuelle Maske und den Annotationstyp für die aktive Aufgabe widerzuspiegeln.

Polygon-Vertex-Bearbeitung#

Bei Segment-Annotationen kannst du Polygon-Vertices nach dem Zeichnen bearbeiten:

• Vertices bewegen: Ziehe an einem beliebigen Vertex-Anker, um ihn neu zu positionieren
• Vertices löschen: Wähle einen Vertex aus und drücke Delete, um ihn zu entfernen

Klassenverwaltung#

Klassen erstellen#

Definiere Annotationsklassen für dein Dataset im Tab Classes:

1. Navigiere zum Tab Classes
2. Verwende das Eingabefeld unten, um einen Klassennamen einzugeben
3. Klicke auf Add oder drücke Enter
4. Eine Farbe wird automatisch aus der Ultralytics-Palette zugewiesen

Neue Klasse während der Annotation hinzufügen#

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

1. Zeichne eine Annotation auf dem Bild
2. Klicke in der Klassen-Seitenleiste auf Add class (oder gib einen neuen Namen in das Suchfeld der Seitenleiste ein)
3. Gib den Klassennamen ein
4. Drücke Enter zum Erstellen und Zuweisen

Dies ermöglicht einen nahtlosen Arbeitsablauf, bei dem du Klassen definieren kannst, während du auf neue Objekttypen in deinen Daten stößt.

Klassen bearbeiten#

• Umbenennen: Klicke auf einen Klassennamen in der Tabelle, um ihn inline 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 die Spaltenüberschriften, um nach Index, Name, Annotationsanzahl oder Bildanzahl zu sortieren

Klassenfarben#

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

Tastaturkürzel#

Effiziente Annotation mit Tastaturkürzeln:

Rückgängig/Wiederherstellen#

Der Annotations-Editor führt eine vollständige Historie für Rückgängig/Wiederherstellen:

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

Die Historie verfolgt:

• Das Hinzufügen von Annotationen (einzeln und im Batch)
• Das Bearbeiten von Annotationen (verschieben, skalieren, rotieren)
• Das Löschen von Annotationen (einzeln und im Batch)
• Das Ändern von Klassen (einzeln und im Batch)
• Das Neuanordnen von Annotationen (z-order)
• Das Bearbeiten von Polygon-Eckpunkten (hinzufügen, entfernen, verschieben)
• Das Verschieben von Keypoints

Annotationen speichern#

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

• Jetzt speichern: Klicke auf die Speichern-Schaltfläche oder drücke Cmd/Ctrl+S.
• Schließen: Klicke auf die Schließen-Schaltfläche, klicke außerhalb des Bildes oder drücke Escape; das Schließen löst eine Hintergrundspeicherung für ausstehende Änderungen aus.

FAQ#

Wie genau ist die SAM-Annotation?#

SAM liefert hochwertige Masken für die meisten Objekte. Die Genauigkeit hängt ab von:

• Unterscheidbarkeit des Objekts vom Hintergrund
• Bildqualität und Auflösung
• Anzahl der bereitgestellten positiven/negativen Punkte

Für die besten Ergebnisse starte mit einem Klick auf die Objektmitte und verwende dann Klicks außerhalb der Maske, um die Abdeckung zu erweitern, und Klicks innerhalb der Maske, um nahegelegene Objekte oder Hintergrund zu entfernen.

Kann ich bestehende Annotationen importieren?#

Ja, lade deinen Datensatz mit YOLO-format label files hoch. Die Plattform parst diese automatisch und zeigt sie im Editor an.

Wie annotiere ich mehrere Objekte derselben Klasse?#

Nachdem du eine Annotation gezeichnet hast:

1. Lasse dieselbe Klasse ausgewählt
2. Zeichne die nächste Annotation
3. Wiederhole dies, bis alle Objekte beschriftet sind

Die Tastenkürzel 1-9 wählen Klassen schnell aus.

Kann ich auf teilweise annotierten Datensätzen trainieren?#

Ja, aber für die besten Ergebnisse:

• Beschrifte alle Objekte deiner Zielklassen in jedem Bild
• Verwende den Annotations Filter, eingestellt auf Unannotated, um Bilder zu identifizieren, die noch annotiert werden müssen

Welches SAM Modell sollte ich verwenden?#

SAM 3 ist das Standardmodell und die neueste Generation — starte dort für die höchste Maskenqualität. Wechsle zu SAM 2.1 Small für einen schnelleren interaktiven Workflow bei gängigen Objekten, oder zu SAM 2.1 Large, wenn du eine höhere Maskenpräzision bei komplexen Formen benötigst. Verwende SAM 2.1 Tiny für maximale Geschwindigkeit bei einfachen, kontrastreichen Objekten.

Welche Aufgaben unterstützen die SAM Smart-Annotation?#

Die SAM Smart-Annotation ist verfügbar für detect, segment, semantic und OBB Aufgaben. Klassifizierungs- und Pose-Aufgaben nutzen nur die manuelle Annotation.

Kann ich benutzerdefinierte Skelett-Vorlagen für die Pose-Annotation erstellen?#

Ja. Klicke auf den + Button neben der Skelett-Vorlagen-Auswahl, um den Vorlagen-Editor zu öffnen. Platziere Keypoints, benenne sie, zeichne Verbindungen und speichere sie. Benutzerdefinierte Vorlagen werden in deinem Konto gespeichert und sind für alle Pose-Datensätze verfügbar.

Wie wechsle ich zwischen Skelett-Vorlagen?#

Klicke auf das Dropdown zur Vorlagenauswahl in der Annotations-Toolbar. Wähle eine beliebige integrierte Vorlage (Person, Hand, Face, Dog, Box) oder deine gespeicherten benutzerdefinierten Vorlagen aus. Die ausgewählte Vorlage bestimmt, welche Keypoints platziert werden, wenn du auf das Bild klickst.