Perché la mia applicazione si blocca quando utilizzo la modalità di profondità NEURALE?

Last updated: August 13, 2026

A partire da ZED SDK v5.0, tutte le modalità di profondità disponibili sono basate sull'IA e alimentate dal nostro motore 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

Puoi trovare una descrizione dettagliata di ciascuna modalità di profondità nella documentazione sulle modalità di profondità.

Ogni modello di IA per la profondità, come gli altri modelli di IA disponibili con i moduli Rilevamento oggetti e Tracciamento del corpo dello ZED SDK, deve essere scaricato dai server di Stereolabs e ottimizzato per la GPU installata sul dispositivo host al primo utilizzo. Lo ZED SDK esegue automaticamente queste operazioni.

Il download è necessario perché ogni modello di IA occupa una quantità significativa di spazio su disco; includerli tutti nel programma di installazione dello ZED SDK comporterebbe un pacchetto di installazione molto grande.

Il passaggio di ottimizzazione consente al motore di IA dello ZED SDK di raggiungere prestazioni complete adattando il modello all'architettura della GPU NVIDIA installata sulla macchina host.

Questa procedura deve essere eseguita una sola volta dopo l'installazione di una nuova versione dello ZED SDK, per ogni modalità di profondità utilizzata.

Il download e l'ottimizzazione di un modello di IA possono richiedere diversi minuti, a seconda del modello di GPU e della velocità della connessione Internet; se questa fase non viene gestita correttamente dall'applicazione, si verificherà un blocco dell'interfaccia utente.

Come evitare il blocco

Suggeriamo di scaricare e ottimizzare i modelli di IA per la profondità prima di avviare l'applicazione eseguendo lo strumento ZED Diagnostic dalla riga di comando:

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

L'opzione -nrlo_all scarica e ottimizza tutte le modalità di profondità basate sull'IA. È inoltre possibile ottimizzare una singola modalità di profondità:

  • -nrlo scarica e ottimizza il modello di profondità NEURALE
  • -nrlo_plus scarica e ottimizza il modello di profondità NEURALE PLUS
  • -nrlo_light scarica e ottimizza il modello di profondità NEURALE LIGHT

Se si prevede di utilizzare altri moduli di IA (Rilevamento oggetti, Tracciamento del corpo), è possibile scaricare e ottimizzare tutti i modelli di IA contemporaneamente con l'opzione -aio.

In alternativa, è possibile utilizzare l'interfaccia grafica dello strumento ZED Diagnostic: dopo aver eseguito un test diagnostico, fare clic sul pulsante MODELLI AI, selezionare i modelli da ottimizzare e fare clic su Ottimizza selezione. L'ottimizzazione dei modelli di IA può essere avviata anche dall'interfaccia grafica dello strumento ZED Depth Viewer.

Per ulteriori informazioni su tutte le opzioni disponibili, consultare la documentazione di ZED Diagnostics.

Nota: se un modello ottimizzato si danneggia o l'ottimizzazione si blocca, è possibile reimpostare tutti i modelli di IA scaricati e ottimizzati con l'opzione -aic (o il pulsante CANCELLA TUTTI I MODELLI nell'interfaccia grafica), quindi eseguire nuovamente l'ottimizzazione.

Nota: le modalità di profondità basate sull'IA richiedono una GPU NVIDIA con supporto CUDA. L'ultima versione di ZED SDK è disponibile nella pagina degli Sviluppatori.