Skip to content
Tutorials3 min read

Video-Annotation mit Steuerung Bild für Bild

So richtest du Video-Annotation in Potato ein: Navigation Bild für Bild, Marker mit Zeitstempeln, zeitliches Labeln von Ereignissen und Klassifikation je Segment über Radio- oder Span-Schemata.

Potato Team

Über Video-Annotation entstehen die Trainingsdaten für Dinge wie Aktivitätserkennung, Objektverfolgung und die Erkennung zeitlicher Ereignisse. Dieses Tutorial behandelt die Frame-Navigation, das Zerlegen eines Clips in der Zeit und Wege, das Labeln zügig zu halten. Die vollständige Referenz der Video-Schemata steht in der Quelldokumentation.

Was Video-Annotation leisten kann

Potato verarbeitet Video sowohl für Label- als auch für Klassifikationsaufgaben:

  • Videoklassifikation: ganze Videoclips labeln
  • Mehrfach-Tagging: mehrere Tags an ein Video vergeben
  • Zeitliche Annotation: Ereignisse im Video markieren

Einfacher Videoaufbau

yaml
annotation_task_name: "Video Action Recognition"
 
data_files:
  - "data/videos.json"
 
annotation_schemes:
  - annotation_type: video_annotation
    name: action
    description: "What action is shown in this video?"
    labels:
      - Walking
      - Running
      - Jumping
      - Sitting
      - Standing
      - Other
yaml
annotation_schemes:
  - annotation_type: video_annotation
    name: frame_label
    description: "Annotate video frames"
    labels:
      - Action
      - No action

Zeitliche Segmente annotieren

Ereignisse mit Start- und Endzeit markieren:

yaml
annotation_task_name: "Video Event Detection"
 
data_files:
  - "data/videos.json"
 
annotation_schemes:
  - annotation_type: video_annotation
    name: events
    description: "Mark all events and their duration"
    labels:
      - name: conversation
        color: "#4ECDC4"
      - name: action_sequence
        color: "#FF6B6B"
      - name: transition
        color: "#45B7D1"
      - name: title_card
        color: "#FFEAA7"

Segmente anlegen

  1. An den Anfang eines Ereignisses navigieren
  2. [ drücken oder auf Mark Start klicken
  3. An das Ende des Ereignisses navigieren
  4. ] drücken oder auf Mark End klicken
  5. Das Label für das Ereignis wählen
  6. Für alle weiteren Ereignisse wiederholen

Wichtige Momente markieren

Einzelne Momente innerhalb eines Clips taggen:

yaml
annotation_schemes:
  - annotation_type: video_annotation
    name: key_moments
    description: "Mark important moments"
    labels:
      - name: action_start
        description: "When the action begins"
        color: "#22C55E"
      - name: action_peak
        description: "Most intense moment"
        color: "#EF4444"
      - name: action_end
        description: "When the action completes"
        color: "#3B82F6"

Klassifikation je Video

Ein ganzes Video mit den Standard-Annotationstypen klassifizieren:

yaml
annotation_schemes:
  - annotation_type: radio
    name: video_label
    description: "What is happening in this video?"
    labels:
      - Person visible
      - No person
      - Transition/blur

Video mit Kategorielabels

Videos mit Kategorielabels annotieren:

yaml
annotation_schemes:
  - annotation_type: video_annotation
    name: video_labels
    description: "Label video content"
    labels:
      - name: person
        color: "#FF6B6B"
      - name: vehicle
        color: "#4ECDC4"
      - name: ball
        color: "#FFEAA7"

Eine vollständige Konfiguration

yaml
annotation_task_name: "Sports Video Analysis"
 
data_files:
  - "data/sports_clips.json"
 
output_annotation_dir: "annotations/"
export_annotation_format: "jsonl"
 
annotation_schemes:
  # Game events
  - annotation_type: video_annotation
    name: game_events
    description: "Mark game events"
    labels:
      - name: goal
        color: "#22C55E"
      - name: foul
        color: "#EF4444"
      - name: corner_kick
        color: "#3B82F6"
      - name: free_kick
        color: "#F59E0B"
      - name: penalty
        color: "#EC4899"
      - name: offside
        color: "#8B5CF6"
 
  # Clip-level annotation
  - annotation_type: multiselect
    name: clip_tags
    description: "Tags for this clip"
    labels:
      - Highlight worthy
      - Good camera angle
      - Multiple players
      - Close-up
      - Wide shot
      - Slow motion available
 
annotation_guidelines:
  title: "Sports Video Annotation Guide"
  content: |
    ## Event Marking
    - Mark events from when they START
    - Include the full play sequence
    - Goal: From shot to ball crossing line
 
    ## Navigation
    - Space: Play/Pause
    - Arrow keys: Frame navigation

Ausgabeformat

json
{
  "id": "clip_001",
  "video_path": "/videos/match_highlight.mp4",
  "annotations": {
    "game_events": ["goal", "corner_kick"],
    "clip_tags": ["Highlight worthy", "Good camera angle"]
  }
}

Hinweise zur Video-Annotation

  1. Erster Durchgang zum Überblick: den Clip zuerst in normaler Geschwindigkeit ansehen
  2. Zeitlupe für Genauigkeit: 0.25x für exakte Zeitstempel
  3. Tastenkürzel: deutlich schneller als die Maus
  4. Pausen machen: Video-Annotation strengt die Augen an
  5. Einheitliche Kriterien: Grenzfälle klar dokumentieren

Nächste Schritte

Vollständige Dokumentation unter Bildannotation (Abschnitt zu Video).