tao-validate-dataset-format

TAO DAFT データセットの検証

クイックスタート

tao-daft validate <format> --path <dataset-or-parent-dir>

<format> は位置引数のサブコマンドです（例：metropolis-v3.0、cosmos-reason-v1.0）。 --path は必須です。対応形式や形式ごとのフラグは、 tao-daft validate --help と末端の --help で確認してください（下記の「CLI の規則」を参照）。

事前確認

python -c "import nvidia_tao_daft" 2>/dev/null || {
  echo "MISSING: tao-daft not installed. Run:"
  echo "  pip install nvidia-tao-daft"
  exit 1
}

クイックスタート

形式のスラッグを選ぶ前に、インストール済みのバリデーター形式を確認してから、 --path に対象を指定して検証を実行します。

tao-daft --version
tao-daft validate --help
tao-daft validate <format> --help
tao-daft validate <format> --path /path/to/daft-dataset

目的

DAFT データセット（またはそのディレクトリツリー）に対して tao-daft validate を実行します。 CLI が仕様です。このスキルではサブコマンドとフラグを選び、結果を説明します。

ユーザーが「TAO DAFT」「DAFT format」、DAFT データセットの検証、スキーマや相互参照のエラー、 または tao-daft validate に言及した場合に使用します。 DAFT 以外のレイアウト（COCO、YOLO、Data Factory JSONL）や、 tao-daft info／tao-daft convert に対しては使用しないでください。これらには専用のスキルがあります。

ユーザーの最初の発言が曖昧な場合は、まずいくつかの --help コマンドを実行して状況を確認し、 その後、タスクを確認してください。

前提条件

• nvidia-tao-daft がインストールされていること（pip install nvidia-tao-daft。wheel だけで十分で、ソースリポジトリは不要です）。tao-daft --version で確認してください。
• ローカルディスク上に DAFT データセット、またはそれらの親ディレクトリがあること。

手順

CLI の規則

tao-daft は argparse のネストされたサブコマンドを使用します。名前やフラグはバージョンによって変わるため、 このドキュメントの一覧を信頼せず、--help から現在の仕様を確認してください。

1. 形式は位置引数のサブコマンドであり、--format ではありません： tao-daft validate <format> [flags]。現在の形式は tao-daft validate --help で一覧表示できます。スラッグの例： metropolis-v3.0、cosmos-reason-v1.0。
2. 対象は --path PATH で指定し、位置引数ではありません。単一の データセット／シーン、または親ディレクトリを指定できます。バリデーターはツリー内を走査します。
3. フラグは形式ごとに異なります。選択する前に、たとえば tao-daft validate metropolis-v3.0 --help のように、末端のヘルプを実行してください。 ある形式のフラグが別の形式にも存在するとは限りません。

したがって、実行の流れは次のとおりです：tao-daft --version → tao-daft validate --help → 形式を選択（指定がなければ下記を参照して推測）→ tao-daft validate <format> --help → 実行 → 結果を解釈。

形式の推測

ファイル名ではなく、ディレクトリ内の目印を使ってください。

• media/ と text/ の隣に meta.json がある ⇒ cosmos-reason-v1.0。
• contextual/ を含むディレクトリ（またはネストされたディレクトリ）。通常は raw/ や task/ も同じ場所にある ⇒ metropolis-v3.0。
• どちらの目印もない ⇒ ユーザーに確認してください。推測しないでください。

エラーの読み取り

CLI は毎回の実行の末尾に VALIDATION RESULTS ブロックを出力し、 続けて ✅ VALIDATION PASSED または ❌ VALIDATION FAILED を表示します。 失敗時はゼロ以外の終了コードを返すため、スクリプトで安全に連結できます。

大規模なツリーでは出力が膨大になる場合があります。出力全体をファイルに保存し、 インラインでスクロールするのではなく、分割して読んでください。

制限事項

• DAFT のみを検証します。DAFT 以外のレイアウト（COCO、YOLO、Data Factory JSONL など）は、上流のコンバーター用スキルで扱います。
• 対応形式は、インストール済みのバージョンで tao-daft validate --help が表示する形式です。 古いスラッグは廃止されている場合があります。
• 対象は validate のみです。tao-daft info と tao-daft convert については、 専用のスキルを参照してください。
• Python で検証処理を再実装しないでください。CLI が仕様です。

トラブルシューティング

• tao-daft: command not found — 有効な環境に wheel がインストールされていません。 pip install nvidia-tao-daft を実行し、tao-daft --version で確認してください。
• error: argument --path is required — パスが位置引数で渡されています。 --path の後ろに指定してください。
• invalid choice: '<format>' — このバージョンでは、そのスラッグが登録されていません。 tao-daft validate --help を再実行し、一覧から選択してください。
• 自動検出（raw type / contextual set）が誤っている — 形式固有のスコープ制限フラグで上書きしてください。 フラグ名は末端の --help で確認してください。
• CI で警告も失敗扱いにしたい — --strict を追加してください。