Warum ist meine Anwendung bei Verwendung des NEURONAL-Tiefenmodus eingefroren?

Last updated: August 13, 2026

Ab ZED SDK v5.0 basieren alle verfügbaren Tiefenmodi auf KI und werden von unserer TERRA-KI-Engine betrieben:

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

Eine detaillierte Beschreibung jedes Tiefenmodus finden Sie in der Dokumentation zu den Tiefenmodi.

Jedes KI-Tiefenmodell muss, wie die anderen KI-Modelle, die mit den Modulen Objekterkennung und Körperspurenverfolgung des ZED SDK verfügbar sind, beim ersten Einsatz von den Stereolabs-Servern heruntergeladen und für die auf dem Hostgerät installierte GPU optimiert werden. Das ZED SDK führt diese Vorgänge automatisch aus.

Der Download ist erforderlich, da jedes KI-Modell erheblichen Speicherplatz benötigt; würden alle Modelle in das Installationsprogramm des ZED SDK aufgenommen, würde dies zu einem sehr großen Installationspaket führen.

Der Optimierungsschritt ermöglicht es der KI-Engine des ZED SDK, die volle Leistung zu erreichen, indem das Modell an die Architektur der auf dem Hostrechner installierten NVIDIA-GPU angepasst wird.

Dieser Vorgang muss nach der Installation einer neuen Version des ZED SDK nur einmal für jeden von Ihnen verwendeten Tiefenmodus ausgeführt werden.

Das Herunterladen und Optimieren eines KI-Modells kann je nach GPU-Modell und Geschwindigkeit der Internetverbindung mehrere Minuten dauern; wenn diese Phase von Ihrer Anwendung nicht ordnungsgemäß behandelt wird, führt dies zu einer nicht reagierenden Benutzeroberfläche.

So vermeiden Sie das Einfrieren

Wir empfehlen, die KI-Tiefenmodelle vor dem Start Ihrer Anwendung herunterzuladen und zu optimieren, indem Sie das ZED Diagnostic-Tool über die Befehlszeile ausführen:

  • Windows (aus C:\Program Files (x86)\ZED SDK\tools\):
"ZED Diagnostic.exe" -nrlo_all
  • Linux:
ZED_Diagnostic -nrlo_all

Die Option -nrlo_all lädt alle KI-basierten Tiefenmodi herunter und optimiert sie. Sie können auch einen einzelnen Tiefenmodus optimieren:

  • -nrlo lädt das Tiefenmodell NEURONAL herunter und optimiert es
  • -nrlo_plus lädt das Tiefenmodell NEURAL PLUS herunter und optimiert es
  • -nrlo_light lädt das Tiefenmodell NEURAL LIGHT herunter und optimiert es

Wenn Sie andere KI-Module (Objekterkennung, Körperspurenverfolgung) verwenden möchten, können Sie alle KI-Modelle auf einmal mit der Option -aio herunterladen und optimieren.

Alternativ können Sie die GUI des Tools ZED Diagnostic verwenden: Führen Sie nach dem Starten eines Diagnosetests einen Klick auf die Schaltfläche AI MODELS aus, wählen Sie die zu optimierenden Modelle aus und klicken Sie auf Optimize Selection. Die Optimierung der KI-Modelle kann auch über die GUI des Tools ZED Depth Viewer ausgelöst werden.

Weitere Informationen zu allen verfügbaren Optionen finden Sie in der Dokumentation zu ZED Diagnostics.

Hinweis: Wenn ein optimiertes Modell beschädigt wird oder die Optimierung stecken bleibt, können Sie alle heruntergeladenen und optimierten KI-Modelle mit der Option -aic (oder der Schaltfläche CLEAR ALL MODELS in der GUI) zurücksetzen und anschließend die Optimierung erneut ausführen.

Hinweis: Die KI-basierten Tiefenmodi erfordern eine NVIDIA-GPU mit CUDA-Unterstützung. Die neueste Version des ZED SDK ist auf der Entwicklerseite verfügbar.