Esta página aún no está disponible en su idioma. Se muestra la versión en inglés.

Bildannotation

Bilder mit Begrenzungsrahmen, Polygonen, Freihandzeichnungen und Landmarkpunkten annotieren.

Bildannotation

Potatos Bildannotationssystem unterstützt mehrere Annotationsmethoden für Computer-Vision-Aufgaben, einschließlich Objekterkennung, Segmentierung und Keypoint-Annotation.

Unterstützte Werkzeuge

Werkzeug	Beschreibung	Anwendungsfall
`bbox`	Rechteckige Begrenzungsrahmen	Objekterkennung
`polygon`	Mehrpunktige Polygone	Instanzsegmentierung
`freeform`	Freihandzeichnung	Unregelmäßige Formen
`landmark`	Punktmarkierungen	Keypoint-Erkennung
`fill`	Pixelgenaues Füllwerkzeug	Segmentierungsmasken
`eraser`	Gemalte Bereiche löschen	Korrektur von Segmentierungsmasken
`brush`	Pinselwerkzeug	Feinkörnige Segmentierung

Grundkonfiguration

yaml

annotation_schemes:
  - name: "objects"
    description: "Draw boxes around all objects"
    annotation_type: "image_annotation"
    tools:
      - bbox
    labels:
      - person
      - car
      - bicycle

Konfigurationsoptionen

Feld	Typ	Standard	Beschreibung
`name`	string	Erforderlich	Eindeutiger Bezeichner für die Annotation
`description`	string	Erforderlich	Anweisungen für Annotatoren
`annotation_type`	string	Erforderlich	Muss `"image_annotation"` sein
`tools`	list	Erforderlich	Aktivierte Annotationswerkzeuge (`bbox`, `polygon`, `freeform`, `landmark`, `fill`, `eraser`, `brush`)
`labels`	list	Erforderlich	Kategoriebeschriftungen für Annotationen
`zoom_enabled`	boolean	true	Zoom-Steuerung aktivieren
`pan_enabled`	boolean	true	Ziehnavigation aktivieren
`min_annotations`	integer	0	Mindestanzahl erforderlicher Annotationen
`max_annotations`	integer	null	Maximale Anzahl erlaubter Annotationen (null = unbegrenzt)
`freeform_brush_size`	integer	5	Pinselgröße für Freihandzeichnung
`freeform_simplify`	float	2.0	Pfadvereinfachungsfaktor

Beschriftungskonfiguration

Beschriftungen können einfache Zeichenketten oder detaillierte Objekte sein:

yaml

# Simple labels (auto-colored)
labels:
  - person
  - car
  - tree
 
# Detailed labels with custom colors and shortcuts
labels:
  - name: "person"
    color: "#FF6B6B"
    key_value: "1"
  - name: "car"
    color: "#4ECDC4"
    key_value: "2"
  - name: "bicycle"
    color: "#45B7D1"
    key_value: "3"

Beispiele

Objekterkennung (Begrenzungsrahmen)

yaml

annotation_schemes:
  - name: "detection"
    description: "Draw bounding boxes around all vehicles"
    annotation_type: "image_annotation"
    tools:
      - bbox
    labels:
      - name: "car"
        color: "#3B82F6"
        key_value: "1"
      - name: "truck"
        color: "#10B981"
        key_value: "2"
      - name: "motorcycle"
        color: "#F59E0B"
        key_value: "3"
    min_annotations: 1
    zoom_enabled: true

Instanzsegmentierung (Polygone)

yaml

annotation_schemes:
  - name: "segmentation"
    description: "Draw polygons around each object"
    annotation_type: "image_annotation"
    tools:
      - polygon
    labels:
      - name: "building"
        color: "#8B5CF6"
      - name: "road"
        color: "#64748B"
      - name: "vegetation"
        color: "#22C55E"
    zoom_enabled: true
    pan_enabled: true

Keypoint-Annotation (Landmarken)

yaml

annotation_schemes:
  - name: "facial_landmarks"
    description: "Mark facial keypoints"
    annotation_type: "image_annotation"
    tools:
      - landmark
    labels:
      - name: "left_eye"
        color: "#3B82F6"
      - name: "right_eye"
        color: "#3B82F6"
      - name: "nose"
        color: "#10B981"
      - name: "left_mouth"
        color: "#F59E0B"
      - name: "right_mouth"
        color: "#F59E0B"

Mehrere Werkzeuge

yaml

annotation_schemes:
  - name: "mixed_annotation"
    description: "Use boxes for objects and polygons for regions"
    annotation_type: "image_annotation"
    tools:
      - bbox
      - polygon
    labels:
      - name: "object"
        color: "#3B82F6"
      - name: "region"
        color: "#10B981"

Tastaturkürzel

Taste	Aktion
`b`	Begrenzungsrahmen-Werkzeug aktivieren
`p`	Polygon-Werkzeug aktivieren
`f`	Freihand-Werkzeug aktivieren
`l`	Landmarken-Werkzeug aktivieren
`1-9`	Beschriftung auswählen
`Delete`	Ausgewählte Annotation entfernen
`Ctrl+Z`	Rückgängig machen
`Ctrl+Y`	Wiederholen
`+` / `-`	Hinein-/herauszoomen

Datenformat

Eingabedaten

Die Datendatei sollte Bildpfade oder URLs enthalten:

json

[
  {
    "id": "img_001",
    "image_url": "https://example.com/images/photo1.jpg"
  },
  {
    "id": "img_002",
    "image_url": "/data/images/photo2.png"
  }
]

Das Bildfeld in der Konfiguration festlegen:

yaml

item_properties:
  id_key: id
  text_key: image_url

Ausgabeformat

Annotationen enthalten Geometriedaten für jede Annotation:

json

{
  "id": "img_001",
  "annotations": {
    "objects": [
      {
        "id": "ann_1",
        "type": "bbox",
        "label": "car",
        "geometry": {
          "x": 100,
          "y": 150,
          "width": 200,
          "height": 100
        }
      },
      {
        "id": "ann_2",
        "type": "polygon",
        "label": "building",
        "geometry": {
          "points": [
            [50, 50],
            [150, 50],
            [150, 200],
            [50, 200]
          ]
        }
      }
    ]
  }
}

Unterstützte Bildformate

JPEG / JPG
PNG
GIF
WebP

Segmentierungsmasken

Neu in v2.2.0

Die Werkzeuge fill, eraser und brush ermöglichen pixelgenaue Segmentierungsmasken-Annotation. Diese Werkzeuge sind ideal für semantische Segmentierungsaufgaben, bei denen präzise Regionsgrenzen benötigt werden.

yaml

annotation_schemes:
  - name: "segmentation"
    description: "Paint segmentation masks"
    annotation_type: "image_annotation"
    tools:
      - fill
      - eraser
      - brush
    labels:
      - name: "foreground"
        color: "#3B82F6"
      - name: "background"
        color: "#6B7280"
    freeform_brush_size: 10

Taste	Aktion
`i`	Füll-Werkzeug aktivieren
`e`	Radiergummi-Werkzeug aktivieren
`r`	Pinsel-Werkzeug aktivieren

PDF/Dokument-Begrenzungsrahmen

Neu in v2.2.0

Begrenzungsrahmen auf PDF-Seiten und Dokumentbildern zeichnen. In Kombination mit dem pdf-Anzeigetyp in instance_display können Annotatoren Rahmen auf einzelnen Seiten von PDF-Dokumenten zeichnen.

yaml

instance_display:
  fields:
    - key: pdf_url
      type: pdf
 
annotation_schemes:
  - name: "document_regions"
    description: "Draw boxes around figures and tables"
    annotation_type: "image_annotation"
    tools:
      - bbox
    labels:
      - name: "figure"
        color: "#3B82F6"
      - name: "table"
        color: "#10B981"
      - name: "equation"
        color: "#F59E0B"

Bewährte Vorgehensweisen

Geeignete Werkzeuge verwenden - Begrenzungsrahmen für schnelle Erkennung, Polygone für präzise Grenzen, Füll-/Pinselwerkzeuge für Segmentierung
Klare Beschriftungen definieren - Eindeutige, nicht überlappende Kategorien verwenden
Annotationslimits setzen - min_annotations für vollständige Erfassung nutzen
Zoom aktivieren - Unverzichtbar für detaillierte Annotationen bei hochauflösenden Bildern
Tastaturkürzel verwenden - Beschleunigt die Annotation erheblich
Beschriftungsfarben angeben - Erleichtert die visuelle Unterscheidung von Annotationen