tao-validate-dataset-format

TAO DAFT データセットを検証する

単独でインストールしていますか？ このセッションが TAO スキルバンクプラグインによって初期化されていない場合は、まず tao-setup スキルを実行してください（ホストの事前チェック、認証情報、スキル間の検出）。

クイックスタート

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 — アクティブな環境にホイールがインストールされていません。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を追加してください。