Comment puis-je optimiser manuellement les modèles d'IA du ZED SDK ?

Last updated: October 22, 2026

Le ZED SDK fournit des modèles d’IA pour l’estimation de la profondeur (modes de profondeur NEURAL LIGHT, NEURAL et NEURAL PLUS), la détection et le suivi d’objets, ainsi que la détection et le suivi du corps humain (suivi du squelette).

Les modèles d’IA ne sont pas inclus dans le programme d’installation du ZED SDK en raison de leur taille, mais ils peuvent être téléchargés depuis nos serveurs pendant l’installation et optimisés pour le GPU disponible sur l’appareil hôte.

Si vous décidez de ne pas télécharger et d’optimiser les modèles d’IA pendant l’installation du ZED SDK, le processus est effectué automatiquement par le ZED SDK la première fois que le modèle d’IA requis est utilisé.

Dans certaines situations, les modèles d’IA doivent être nettoyés et optimisés manuellement :

  • le GPU de l’appareil hôte a été remplacé ;
  • le ZED SDK a été mis à jour vers une nouvelle version ;
  • le processus de téléchargement a échoué pour des raisons inattendues (par exemple, panne de courant, interruption de la connexion Internet, etc.) ;
  • le processus d’optimisation s’est arrêté pour des raisons inattendues ;
  • comportement inattendu du traitement du ZED SDK (par exemple, carte de profondeur incorrecte dans les modes de profondeur NEURAL, détections d’objets incorrectes, détection du squelette incorrecte, etc.).

Remarque : toutes les opérations décrites ci-dessous peuvent également être effectuées depuis l’interface graphique de l’outil ZED Diagnostics en cliquant sur le bouton AI MODELS, disponible après avoir effectué un test de diagnostic. Consultez la Documentation de ZED Diagnostics. Sur les appareils sans interface graphique (par exemple, NVIDIA® Jetson™ sans écran), ajoutez l’option -c pour exécuter l’outil en mode ligne de commande.

Comment exécuter les commandes

Ouvrez une console shell et exécutez l’outil avec l’option décrite dans le tableau ci-dessous.

  • Linux / NVIDIA® Jetson™ (le dossier actuel n’est pas pertinent) :
    ZED_Diagnostic <option>
  • Windows (Invite de commandes ou PowerShell) :
    cd "C:\Program Files (x86)\ZED SDK\tools"
    & ".\ZED Diagnostic.exe" <option>
    Dans l’Invite de commandes (cmd.exe), omettez le & initial : "ZED Diagnostic.exe" <option>

Remplacez <option> par l’une des options suivantes :

OptionOpération
-aicNettoyer (supprimer) tous les modèles d'IA téléchargés et optimisés ; utile pour libérer de l'espace disque ou réinitialiser les optimisations si quelque chose ne fonctionne pas correctement
-nrlo_lightTélécharger et optimiser le modèle de profondeur NEURAL LIGHT
-nrloTélécharger et optimiser le modèle de profondeur NEURAL
-nrlo_plusTélécharger et optimiser le modèle de profondeur NEURAL PLUS
-nrlo_allTélécharger et optimiser tous les modèles de profondeur basés sur l'IA
-ais XTélécharger et optimiser un seul modèle d'IA (voir la liste ci-dessous)
-aidTélécharger tous les modèles d'IA sans les optimiser (utile pour préparer un déploiement hors ligne ; l'optimisation est effectuée ultérieurement sur l'appareil cible)
-aioTélécharger et optimiser tous les modèles d'IA en une seule étape (cela peut prendre un certain temps)

Télécharger et optimiser un seul modèle d'IA

Avec l'option -ais X, remplacez "X" par un nombre entier conformément à l'énumération sl::AI_MODELS :

  • 0 - MULTI_CLASS_DETECTION: associé à sl::OBJECT_DETECTION_MODEL::MULTI_CLASS_BOX_FAST
  • 1 - MULTI_CLASS_MEDIUM_DETECTION: associé à sl::OBJECT_DETECTION_MODEL::MULTI_CLASS_BOX_MEDIUM
  • 2 - MULTI_CLASS_ACCURATE_DETECTION: associé à sl::OBJECT_DETECTION_MODEL::MULTI_CLASS_BOX_ACCURATE
  • 3 - HUMAN_BODY_FAST_DETECTION: associé à sl::BODY_TRACKING_MODEL::HUMAN_BODY_FAST
  • 4 - HUMAN_BODY_MEDIUM_DETECTION: associé à sl::BODY_TRACKING_MODEL::HUMAN_BODY_MEDIUM
  • 5 - HUMAN_BODY_ACCURATE_DETECTION: associé à sl::BODY_TRACKING_MODEL::HUMAN_BODY_ACCURATE
  • 6 - HUMAN_BODY_38_FAST_DETECTION: associé à sl::BODY_TRACKING_MODEL::HUMAN_BODY_FAST avec sl::BODY_FORMAT::BODY_38
  • 7 - HUMAN_BODY_38_MEDIUM_DETECTION: associé à sl::BODY_TRACKING_MODEL::HUMAN_BODY_MEDIUM avec sl::BODY_FORMAT::BODY_38
  • 8 - HUMAN_BODY_38_ACCURATE_DETECTION: associé à sl::BODY_TRACKING_MODEL::HUMAN_BODY_ACCURATE avec sl::BODY_FORMAT::BODY_38
  • 9 - PERSON_HEAD_DETECTION: associé à sl::OBJECT_DETECTION_MODEL::PERSON_HEAD_BOX_FAST
  • 10 - PERSON_HEAD_ACCURATE_DETECTION: associé à sl::OBJECT_DETECTION_MODEL::PERSON_HEAD_BOX_ACCURATE
  • 11 - REID_ASSOCIATION: associé à sl::BatchParameters::enable
  • 12 - NEURAL_LIGHT_DEPTH: associé à sl::DEPTH_MODE::NEURAL_LIGHT
  • 13 - NEURAL_DEPTH: associé à sl::DEPTH_MODE::NEURAL
  • 14 - NEURAL_PLUS_DEPTH: associé à sl::DEPTH_MODE::NEURAL_PLUS

Remarque : les identifiants numériques suivent l'ordre de l'énumération sl::AI_MODELS et peuvent changer entre les versions majeures du ZED SDK. Vérifiez toujours la liste correspondant à la version du ZED SDK installée en exécutant l'outil avec l'option -h.

Pour plus d'informations sur toutes les commandes disponibles de ZED Diagnostics, utilisez l'option -h ou consultez la Documentation de ZED Diagnostics.