Annotations-Editor#

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

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:

Tiefen-Ground-Truth ist eine von dir hochgeladene, gepaarte Karte, die du nicht selbst einzeichnest, weshalb sich der Editor bei einem Tiefendatensatz im Read-Only-Modus öffnet.

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 der Vollbild-Viewer auf dem Desktop geöffnet wird. 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 Datensätze vom Typ detect, segment, semantic und OBB bietet die Symbolleiste auch den Modus Smart, wenn Smart Annotation verfügbar ist:

Die Pose-Annotation verwendet Draw mit einer Skelettvorlage – die Schaltfläche Smart wird angezeigt, ist jedoch deaktiviert und mit „Demnächst verfügbar“ gekennzeichnet. Die Klassifizierung verwendet die Klassen-Seitenleiste direkt und zeigt überhaupt keine Zeichen-Symbolleiste oder Smart-Schaltfläche an.

Intelligente Annotation ist derzeit nicht verfügbar für verknüpfte Datensätze mit Cloud- oder On-Premise-Speicher.

Draw-Modus-Werkzeuge#

Bounding Box (Detect)#

Zeichne rechteckige Boxen um Objekte:

1. Wähle eine Klasse in der Klassenseitenleiste aus.
2. Klicke und ziehe im Standardmodus Draw, 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 oder 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 Symbolleiste
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 und ziehe im Standardmodus Draw, 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 Klassen-Seitenleiste aus oder drücke eine Zifferntaste von 1-9

Smarte Annotation#

Smart Annotation fügt dem Editor modellunterstützte Annotationen hinzu. Im Smart-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. Smart Annotation ist für die Aufgaben detect, segment, semantic und OBB verfügbar.

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-Arbeitsabläufe

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 Smart Annotation, indem die SAM-Maske nach jedem Klick automatisch gespeichert wird — es ist nicht nötig, Enter zu drücken. Schalte ihn über die Auto-Apply-Schaltfläche in der Symbolleiste 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 bei aktivem Smart-Modus 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 der Modellauswahl in der Symbolleiste (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: Filter die Klassenliste, indem du in das Suchfeld tippst. Drücke Enter bei einer exakten Übereinstimmung, um sie auszuwählen, oder erlaube die Erstellung einer neuen Klasse, falls keine Übereinstimmung existiert.
• Neue Klasse inline erstellen: Klicke auf Add class am Ende der Liste, tippe einen Namen ein und wähle optional eine benutzerdefinierte Farbe aus. 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.
• Ganze Klasse ausblenden/einblenden: Klicke auf das Augensymbol in einer Klassenzeile, um alle Annotationen dieser Klasse gleichzeitig auszublenden oder einzublenden.
• 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.
• Tastenkombinationen: Drücke 1-9, um schnell die ersten 9 Klassen auszuwählen, oder H, um die Sichtbarkeit aller Annotationen auf dem Bild umzuschalten.

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
• Eckpunkte löschen: Wähle einen Eckpunkt aus und drücke Delete, um ihn zu entfernen

Klassenverwaltung#

Klassen erstellen#

Definiere Annotationsklassen für deinen Datensatz 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 tippe 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-Farbpalette zugewiesen. Du kannst Farben über die Farbauswahl auf dem Tab 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
• Wiederholen: 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#