Skip to content
Tutorials4 min read

Annotazione video con controlli fotogramma per fotogramma

Come impostare in Potato l'annotazione video, con navigazione fotogramma per fotogramma, marcatori temporali, etichettatura degli eventi nel tempo e classificazione per segmento con schemi radio o span.

Potato Team

L'annotazione video è il modo in cui si costruiscono i dati di addestramento per cose come il riconoscimento di azioni, il tracciamento di oggetti e il rilevamento di eventi nel tempo. Questo tutorial copre la navigazione tra i fotogrammi, la divisione di uno spezzone lungo l'asse del tempo e i modi per tenere veloce l'etichettatura. Per il riferimento completo degli schemi video, vedi la documentazione di riferimento.

Che cosa si può fare con l'annotazione video

Potato gestisce il video sia per l'etichettatura sia per i task di classificazione:

  • Classificazione video: etichettare interi spezzoni
  • Etichettatura multipla: applicare più tag allo stesso video
  • Annotazione temporale: marcare gli eventi dentro il video

Configurazione video di base

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

Annotazione di segmenti temporali

Marca gli eventi con un tempo di inizio e uno di fine:

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"

Creare i segmenti

  1. Portati all'inizio di un evento
  2. Premi [ oppure clicca «Mark Start»
  3. Portati alla fine dell'evento
  4. Premi ] oppure clicca «Mark End»
  5. Scegli l'etichetta dell'evento
  6. Ripeti per tutti gli eventi

Marcare i momenti chiave

Puoi segnare singoli momenti dentro uno spezzone:

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"

Classificazione dell'intero video

Per etichettare un video per intero bastano i tipi di annotazione standard:

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

Video con etichette di categoria

Annotare i video con etichette di categoria:

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"

Una configurazione completa

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

Formato di output

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

Consigli per l'annotazione video

  1. Prima passata d'insieme: guarda tutto a velocità normale
  2. Rallentatore per la precisione: usa 0.25x per i tempi esatti
  3. Scorciatoie da tastiera: molto più rapide del mouse
  4. Fai delle pause: annotare video stanca gli occhi
  5. Criteri coerenti: metti per iscritto i casi limite

Prossimi passi

Documentazione completa su Annotazione di Immagini, sezione video.