Pourquoi mon application se fige-t-elle lors de l’utilisation du mode de profondeur NEURAL ?

Last updated: August 13, 2026

À partir du ZED SDK v5.0, tous les modes de profondeur disponibles sont basés sur l’IA et propulsés par notre moteur 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

Vous trouverez une description détaillée de chaque mode de profondeur dans la Documentation des modes de profondeur.

Chaque modèle d’IA de profondeur, comme les autres modèles d’IA disponibles avec les modules Détection d’objets et Suivi du corps du ZED SDK, doit être téléchargé depuis les serveurs de Stereolabs et optimisé pour le GPU installé sur l’appareil hôte lors de sa première utilisation. Le ZED SDK effectue automatiquement ces opérations.

Le téléchargement est nécessaire, car chaque modèle d’IA occupe un espace disque important ; inclure tous les modèles dans le programme d’installation du ZED SDK entraînerait un package d’installation très volumineux.

L’étape d’optimisation permet au moteur d’IA du ZED SDK d’atteindre des performances maximales en adaptant le modèle à l’architecture du GPU NVIDIA installé sur la machine hôte.

Cette procédure ne doit être exécutée qu’une seule fois après l’installation d’une nouvelle version du ZED SDK, pour chaque mode de profondeur que vous utilisez.

Le téléchargement et l’optimisation d’un modèle d’IA peuvent prendre plusieurs minutes, selon le modèle de GPU et la vitesse de la connexion Internet ; si cette phase n’est pas correctement gérée par votre application, cela entraînera une interface utilisateur qui ne répond plus.

Comment éviter le blocage

Nous vous suggérons de télécharger et d’optimiser les modèles d’IA de profondeur avant de démarrer votre application en exécutant l’outil ZED Diagnostic depuis la ligne de commande :

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

L'option -nrlo_all télécharge et optimise tous les modes de profondeur basés sur l'IA. Vous pouvez également optimiser un seul mode de profondeur :

  • -nrlo télécharge et optimise le modèle de profondeur NEURAL
  • -nrlo_plus télécharge et optimise le modèle de profondeur NEURAL PLUS
  • -nrlo_light télécharge et optimise le modèle de profondeur NEURAL LIGHT

Si vous prévoyez d'utiliser d'autres modules d'IA (Détection d'objets, Suivi du corps), vous pouvez télécharger et optimiser tous les modèles d'IA à la fois avec l'option -aio.

Vous pouvez également utiliser l'interface graphique de l'outil ZED Diagnostic : après avoir exécuté un test de diagnostic, cliquez sur le bouton MODÈLES IA, sélectionnez les modèles à optimiser, puis cliquez sur Optimiser la sélection. L'optimisation des modèles d'IA peut également être déclenchée depuis l'interface graphique de l'outil ZED Depth Viewer.

Pour plus d'informations sur toutes les options disponibles, consultez la Documentation de ZED Diagnostics.

Remarque : si un modèle optimisé est corrompu ou si l'optimisation reste bloquée, vous pouvez réinitialiser tous les modèles d'IA téléchargés et optimisés avec l'option -aic (ou le bouton EFFACER TOUS LES MODÈLES dans l'interface graphique), puis relancer l'optimisation.

Remarque : les modes de profondeur basés sur l'IA nécessitent un GPU NVIDIA avec prise en charge de CUDA. La dernière version du ZED SDK est disponible sur la page des Développeurs.