NEURAL深度モードを使用すると、なぜ私のアプリケーションはフリーズするのですか？

Last updated: August 13, 2026

ZED SDK v5.0以降、利用可能なすべての深度モードはAIベースで、TERRA AIエンジンを搭載しています：

sl::InitParameters::depth_mode = sl::DEPTH_MODE::NEURAL_LIGHT
sl::InitParameters::depth_mode = sl::DEPTH_MODE::NEURAL        // default
sl::InitParameters::depth_mode = sl::DEPTH_MODE::NEURAL_PLUS

各深度モードの詳細な説明については、深度モードのドキュメントをご覧ください。

ZED SDKの物体検出およびボディトラッキングモジュールで利用可能な他のAIモデルと同様に、各深度AIモデルは、最初に使用する際にステレオラブスのサーバーからダウンロードされ、ホストデバイスに搭載されたGPU向けに最適化される必要があります。ZED SDKはこれらの処理を自動的に実行します。

各AIモデルはかなりのディスク容量を必要とするため、ダウンロードが必要です。すべてのモデルをZED SDKインストーラーに含めると、非常に大きなインストーラーパッケージになってしまいます。

最適化の手順により、ホストマシンに搭載されたNVIDIA GPUのアーキテクチャに合わせてモデルを適応させ、ZED SDKのAIエンジンが最大限のパフォーマンスを発揮できるようになります。

この手順は、新しいバージョンのZED SDKをインストールした後、使用する各深度モードについて一度だけ実行する必要があります。

AIモデルのダウンロードと最適化には、GPUモデルやインターネット接続速度によって数分かかることがあります。この段階をアプリケーションが適切に処理しない場合、ユーザーインターフェースが応答しなくなります。

フリーズを回避する方法

アプリケーションを起動する前に、コマンドラインからZED Diagnosticツールを実行して、深度AIモデルをダウンロードおよび最適化することをお勧めします：

Windows（C:\Program Files (x86)\ZED SDK\tools\から）：

"ZED Diagnostic.exe" -nrlo_all

Linux:

ZED_Diagnostic -nrlo_all

-nrlo_allオプションは、AIベースのすべての深度モードをダウンロードして最適化します。単一の深度モードを最適化することもできます:

-nrloはニューラル深度モデルをダウンロードして最適化します
-nrlo_plusはNEURAL PLUS深度モデルをダウンロードして最適化します
-nrlo_lightはNEURAL LIGHT深度モデルをダウンロードして最適化します

その他のAIモジュール（物体検出、ボディトラッキング）を使用する予定がある場合は、-aioオプションを使用してすべてのAIモデルを一度にダウンロードして最適化できます。

または、ZED DiagnosticツールのGUIを使用できます。診断テストを実行した後、AI MODELSボタンをクリックし、最適化するモデルを選択して、Optimize Selectionをクリックします。AIモデルの最適化は、ZED Depth ViewerツールのGUIからも実行できます。

利用可能なすべてのオプションの詳細については、ZED Diagnosticsドキュメントを参照してください。

注: 最適化されたモデルが破損した場合、または最適化が停止した場合は、-aicオプション（またはGUIのCLEAR ALL MODELSボタン）を使用して、ダウンロードおよび最適化されたすべてのAIモデルをリセットしてから、再度最適化を実行できます。

注: AIベースの深度モードには、CUDAをサポートするNVIDIA GPUが必要です。最新バージョンのZED SDKは開発者ページで入手できます。