ZED SDKのAIモデルを手動で最適化するにはどうすればよいですか？

Last updated: October 22, 2026

ZED SDKは、深度推定（NEURAL LIGHT、ニューラル、NEURAL PLUS深度モード）、物体検出とトラッキング、および人体検出とトラッキング（スケルトントラッキング）用のAIモデルを提供します。

AIモデルはサイズが大きいためZED SDKのインストーラーには含まれていませんが、インストール中に当社のサーバーからダウンロードし、ホストデバイスで使用可能なGPU向けに最適化できます。

ZED SDKのインストール中にAIモデルをダウンロードして最適化しないことを選択した場合、必要なAIモデルが初めて使用されるときに、ZED SDKによって処理が自動的に実行されます。

AIモデルを手動でクリーンアップして最適化する必要がある状況があります：

  • ホストデバイスのGPUを交換した；
  • ZED SDKを新しいバージョンに更新した；
  • 予期しない理由（停電、インターネット接続の切断など）によりダウンロードプロセスが失敗した；
  • 予期しない理由により最適化プロセスが停止した；
  • ZED SDKの処理で予期しない動作が発生した（例：NEURAL深度モードで深度マップが正しくない、物体検出が正しくない、スケルトン検出が正しくないなど）。

注：以下で説明するすべての操作は、診断テストの完了後に表示されるAI MODELSボタンをクリックして、ZED Diagnosticsツールのグラフィカルインターフェースからも実行できます。ZED Diagnosticsドキュメントを参照してください。ヘッドレスデバイス（ディスプレイのないNVIDIA® Jetson™など）では、-cオプションを追加してツールをコマンドラインモードで実行します。

コマンドの実行方法

シェルコンソールを開き、以下の表に記載されているオプションを指定してツールを実行します。

  • Linux / NVIDIA® Jetson™（現在のフォルダーは関係ありません）：
    ZED_Diagnostic <option>
  • Windows（コマンドプロンプトまたはPowerShell）：
    cd "C:\Program Files (x86)\ZED SDK\tools"
    & ".\ZED Diagnostic.exe" <option>
    コマンドプロンプト（cmd.exe）では、先頭の&を省略します："ZED Diagnostic.exe" <option>

<option>を次のいずれかに置き換えます：

オプション操作
-aicダウンロードおよび最適化されたすべてのAIモデルをクリーンアップ（削除）します。ディスク容量を解放したり、正常に動作しない場合に最適化をリセットしたりするのに便利です
-nrlo_lightNEURAL LIGHT深度モデルをダウンロードして最適化します
-nrloNEURAL深度モデルをダウンロードして最適化します
-nrlo_plusNEURAL PLUS深度モデルをダウンロードして最適化します
-nrlo_allAIベースのすべての深度モデルをダウンロードして最適化します
-ais X単一のAIモデルをダウンロードして最適化します（以下のリストを参照）
-aid最適化せずにすべてのAIモデルをダウンロードします（オフライン展開の準備に便利です。最適化は後で対象デバイス上で実行します）
-aioすべてのAIモデルを1回の手順でダウンロードして最適化します（完了まで時間がかかる場合があります）

単一のAIモデルをダウンロードして最適化する

-ais Xオプションを使用し、sl::AI_MODELS列挙型に従って「X」を整数値に置き換えます：

  • 0 - MULTI_CLASS_DETECTION: sl::OBJECT_DETECTION_MODEL::MULTI_CLASS_BOX_FASTに関連
  • 1 - MULTI_CLASS_MEDIUM_DETECTION: sl::OBJECT_DETECTION_MODEL::MULTI_CLASS_BOX_MEDIUMに関連
  • 2 - MULTI_CLASS_ACCURATE_DETECTION: sl::OBJECT_DETECTION_MODEL::MULTI_CLASS_BOX_ACCURATEに関連
  • 3 - HUMAN_BODY_FAST_DETECTION: sl::BODY_TRACKING_MODEL::HUMAN_BODY_FASTに関連
  • 4 - HUMAN_BODY_MEDIUM_DETECTION: sl::BODY_TRACKING_MODEL::HUMAN_BODY_MEDIUMに関連
  • 5 - HUMAN_BODY_ACCURATE_DETECTION: sl::BODY_TRACKING_MODEL::HUMAN_BODY_ACCURATEに関連
  • 6 - HUMAN_BODY_38_FAST_DETECTION: sl::BODY_TRACKING_MODEL::HUMAN_BODY_FASTにsl::BODY_FORMAT::BODY_38を組み合わせたもの
  • 7 - HUMAN_BODY_38_MEDIUM_DETECTION: sl::BODY_TRACKING_MODEL::HUMAN_BODY_MEDIUMにsl::BODY_FORMAT::BODY_38を組み合わせたもの
  • 8 - HUMAN_BODY_38_ACCURATE_DETECTION: sl::BODY_TRACKING_MODEL::HUMAN_BODY_ACCURATEにsl::BODY_FORMAT::BODY_38を組み合わせたもの
  • 9 - PERSON_HEAD_DETECTION: sl::OBJECT_DETECTION_MODEL::PERSON_HEAD_BOX_FASTに関連
  • 10 - PERSON_HEAD_ACCURATE_DETECTION: sl::OBJECT_DETECTION_MODEL::PERSON_HEAD_BOX_ACCURATEに関連
  • 11 - REID_ASSOCIATION: sl::BatchParameters::enableに関連
  • 12 - NEURAL_LIGHT_DEPTH: sl::DEPTH_MODE::NEURAL_LIGHTに関連
  • 13 - NEURAL_DEPTH: sl::DEPTH_MODE::NEURALに関連
  • 14 - NEURAL_PLUS_DEPTH: sl::DEPTH_MODE::NEURAL_PLUSに関連

注: 数値IDはsl::AI_MODELS enumの順序に従っており、ZED SDKのメジャーバージョン間で変更される可能性があります。インストールされているZED SDKバージョンに対応するリストを、ツールを-hフラグ付きで実行して必ず確認してください。

利用可能なZED Diagnosticsコマンドの詳細については、-hフラグを使用するか、ZED Diagnosticsドキュメントを参照してください。