¿Por qué mi aplicación se bloquea al usar el modo de profundidad NEURAL?

Last updated: August 13, 2026

A partir de la versión 5.0 del ZED SDK, todos los modos de profundidad disponibles están basados en IA e impulsados por nuestro motor de IA TERRA IA:

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

Puedes encontrar una descripción detallada de cada modo de profundidad en la Documentación de los modos de profundidad.

Cada modelo de IA de profundidad, al igual que los demás modelos de IA disponibles en los módulos de Detección de objetos y Seguimiento del cuerpo del ZED SDK, debe descargarse de los servidores de Stereolabs y optimizarse para la GPU instalada en el dispositivo host la primera vez que se utiliza. El ZED SDK realiza estas operaciones automáticamente.

La descarga es necesaria porque cada modelo de IA ocupa una cantidad significativa de espacio en disco; incluirlos todos en el instalador del ZED SDK daría como resultado un paquete de instalación muy grande.

El paso de optimización permite que el motor de IA del ZED SDK alcance el máximo rendimiento al adaptar el modelo a la arquitectura de la GPU NVIDIA instalada en el equipo host.

Este procedimiento debe ejecutarse una sola vez después de instalar una nueva versión del ZED SDK, para cada modo de profundidad que utilices.

La descarga y optimización de un modelo de IA puede tardar varios minutos, dependiendo del modelo de GPU y de la velocidad de la conexión a Internet; si tu aplicación no gestiona correctamente esta fase, la interfaz de usuario dejará de responder.

Cómo evitar el bloqueo

Sugerimos descargar y optimizar los modelos de IA de profundidad antes de iniciar tu aplicación ejecutando la herramienta ZED Diagnostic desde la línea de comandos:

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

La opción -nrlo_all descarga y optimiza todos los modos de profundidad basados en IA. También puede optimizar un único modo de profundidad:

  • -nrlo descarga y optimiza el modelo de profundidad NEURAL
  • -nrlo_plus descarga y optimiza el modelo de profundidad NEURAL PLUS
  • -nrlo_light descarga y optimiza el modelo de profundidad NEURAL LIGHT

Si planea utilizar otros módulos de IA (Detección de objetos, Seguimiento del cuerpo), puede descargar y optimizar todos los modelos de IA a la vez con la opción -aio.

Como alternativa, puede utilizar la interfaz gráfica de usuario de la herramienta ZED Diagnostic: después de ejecutar una prueba de diagnóstico, haga clic en el botón AI MODELS, seleccione los modelos que desea optimizar y haga clic en Optimize Selection. La optimización de los modelos de IA también puede activarse desde la interfaz gráfica de usuario de la herramienta ZED Depth Viewer.

Para obtener más información sobre todas las opciones disponibles, consulte la documentación de ZED Diagnostics.

Nota: si un modelo optimizado se corrompe o la optimización se bloquea, puede restablecer todos los modelos de IA descargados y optimizados con la opción -aic (o el botón CLEAR ALL MODELS en la interfaz gráfica de usuario) y, a continuación, ejecutar de nuevo la optimización.

Nota: los modos de profundidad basados en IA requieren una GPU NVIDIA compatible con CUDA. La última versión del ZED SDK está disponible en la página de Desarrolladores.