フレーム単位のコントロールによるビデオアノテーション

ビデオアノテーションは、行動認識、オブジェクトトラッキング、時間的イベント検出のための学習データ作成を可能にします。本チュートリアルでは、フレームナビゲーション、時間的セグメンテーション、効率的なビデオラベリングワークフローを紹介します。

ビデオアノテーション機能

Potatoはラベリングと分類タスクのためのビデオアノテーションをサポートしています：

ビデオ分類: ビデオクリップ全体にラベルを付ける
マルチラベルタグ付け: ビデオに複数のタグを適用
時間的アノテーション: ビデオ内のイベントをマークする

基本的なビデオ設定

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

時間的セグメントアノテーション

開始時間と終了時間でイベントをマークします：

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"

セグメントの作成

イベントの開始位置にナビゲートする
[を押すか「Mark Start」をクリックする
イベントの終了位置にナビゲートする
]を押すか「Mark End」をクリックする
イベントラベルを選択する
すべてのイベントについて繰り返す

ビデオ分類

ラベルを使用してビデオコンテンツを分類します：

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"

ビデオごとの分類

標準的なアノテーションタイプでビデオを分類します：

yaml

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

ラベル付きビデオ

カテゴリラベルでビデオをアノテーションします：

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"

完全なビデオアノテーション設定

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: |
    ## イベントマーキング
    - イベントの開始時点からマーク
    - プレー全体のシーケンスを含める
    - ゴール：シュートからボールがラインを越えるまで
 
    ## ナビゲーション
    - Space: 再生/一時停止
    - 矢印キー: フレームナビゲーション

出力フォーマット

json

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

ビデオアノテーションのコツ

初回は概観を掴む: まず通常速度で視聴する
精度にはスローモーション: 正確なタイムスタンプには0.25倍速を使用
キーボードショートカット: マウスより大幅に速い
休憩を取る: ビデオアノテーションは視覚的に負担が大きい
一貫した基準: 境界ケースを明確に文書化する

次のステップ

ビデオ品質評価のための画像比較を学ぶ
大規模ビデオアノテーションのためのクラウドソーシングを設定する

完全なドキュメントは/docs/features/image-annotation（ビデオセクション）をご覧ください。