Skip to content
Tutorials4 min read

Annotation vidéo avec contrôles image par image

Configurez des tâches d'annotation vidéo avec une navigation précise par image, des marqueurs temporels et l'étiquetage d'événements temporels.

Potato Team·

Annotation vidéo avec contrôles image par image

L'annotation vidéo permet la création de données d'entraînement pour la reconnaissance d'actions, le suivi d'objets et la détection d'événements temporels. Ce tutoriel couvre la navigation par image, la segmentation temporelle et les flux de travail efficaces d'étiquetage vidéo.

Capacités d'annotation vidéo

Potato supporte l'annotation vidéo pour les tâches d'étiquetage et de classification :

  • Classification vidéo : étiqueter des clips vidéo entiers
  • Étiquetage multi-labels : appliquer plusieurs tags aux vidéos
  • Annotation temporelle : marquer des événements dans les vidéos

Configuration vidéo basique

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

Navigation image par image

yaml
annotation_schemes:
  - annotation_type: video_annotation
    name: frame_label
    description: "Annotate video frames"
    labels:
      - Action
      - No action

Annotation de segments temporels

Marquez les événements avec des temps de début et de fin :

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"

Créer des segments

  1. Naviguez vers le début d'un événement
  2. Appuyez sur [ ou cliquez sur « Marquer le début »
  3. Naviguez vers la fin de l'événement
  4. Appuyez sur ] ou cliquez sur « Marquer la fin »
  5. Sélectionnez l'étiquette de l'événement
  6. Répétez pour tous les événements

Classification vidéo

Classifiez le contenu vidéo avec des étiquettes :

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"

Classification par vidéo

Classifiez les vidéos avec des types d'annotation standard :

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

Vidéo avec étiquettes

Annotez les vidéos avec des étiquettes de catégorie :

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"

Configuration complète d'annotation vidéo

yaml
annotation_task_name: "Sports Video Analysis"
 
data_files:
  - "data/sports_clips.json"
 
output_annotation_dir: "annotations/"
output_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: |
    ## Marquage des événements
    - Marquez les événements à partir du moment où ils COMMENCENT
    - Incluez la séquence de jeu complète
    - But : du tir au moment où le ballon franchit la ligne
 
    ## Navigation
    - Espace : Lecture/Pause
    - Touches fléchées : navigation par image

Format de sortie

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

Conseils pour l'annotation vidéo

  1. Premier passage en aperçu : regardez à vitesse normale d'abord
  2. Ralenti pour la précision : utilisez 0,25x pour les horodatages exacts
  3. Raccourcis clavier : bien plus rapide que la souris
  4. Faites des pauses : l'annotation vidéo est visuellement exigeante
  5. Critères cohérents : documentez clairement les cas limites

Prochaines étapes

Documentation complète sur /docs/features/image-annotation (section vidéo).