Come posso ottimizzare manualmente i modelli di IA di ZED SDK?

Last updated: October 22, 2026

ZED SDK fornisce modelli di IA per la stima della profondità (modalità di profondità NEURAL LIGHT, NEURALE e NEURAL PLUS), il Rilevamento oggetti e il tracking, nonché il rilevamento e il tracking del corpo umano (tracciamento dello scheletro).

I modelli di IA non sono inclusi nel programma di installazione di ZED SDK a causa delle loro dimensioni, ma possono essere scaricati dai nostri server durante l'installazione e ottimizzati per la GPU disponibile sul dispositivo host.

Se si decide di non scaricare e ottimizzare i modelli di IA durante l'installazione di ZED SDK, il processo viene eseguito automaticamente da ZED SDK la prima volta che viene utilizzato il modello di IA richiesto.

Esistono situazioni in cui i modelli di IA devono essere puliti e ottimizzati manualmente:

la GPU del dispositivo host è stata sostituita;
ZED SDK è stato aggiornato a una nuova versione;
il processo di download non è riuscito per motivi imprevisti (ad esempio interruzione di corrente, perdita della connessione Internet, ecc.);
il processo di ottimizzazione si è interrotto per motivi imprevisti;
comportamento imprevisto dell'elaborazione di ZED SDK (ad esempio mappa di profondità errata nelle modalità di profondità NEURALE, rilevamenti di oggetti errati, rilevamento dello scheletro errato, ecc.).

Nota: tutte le operazioni descritte di seguito possono essere eseguite anche dall'interfaccia grafica dello strumento ZED Diagnostics facendo clic sul pulsante AI MODELS, disponibile dopo aver completato un test diagnostico. Consultare la documentazione di ZED Diagnostics. Sui dispositivi headless (ad esempio NVIDIA® Jetson™ senza display), aggiungere l'opzione -c per eseguire lo strumento in modalità riga di comando.

Come eseguire i comandi

Aprire una console shell ed eseguire lo strumento con l'opzione descritta nella tabella seguente.

Linux / NVIDIA® Jetson™ (la cartella corrente non è rilevante):
```
ZED_Diagnostic <option>
```
Windows (Prompt dei comandi o PowerShell):
```
cd "C:\Program Files (x86)\ZED SDK\tools"
& ".\ZED Diagnostic.exe" <option>
```
Nel Prompt dei comandi (cmd.exe), omettere il carattere iniziale &: "ZED Diagnostic.exe" <option>

Sostituire <option> con una delle seguenti:

Opzione	Operazione
`-aic`	Pulisce (rimuove) tutti i modelli IA scaricati e ottimizzati; utile per liberare spazio su disco o reimpostare le ottimizzazioni se qualcosa non funziona correttamente
`-nrlo_light`	Scarica e ottimizza il modello di profondità NEURAL LIGHT
`-nrlo`	Scarica e ottimizza il modello di profondità NEURALE
`-nrlo_plus`	Scarica e ottimizza il modello di profondità NEURAL PLUS
`-nrlo_all`	Scarica e ottimizza tutti i modelli di profondità basati sull'IA
`-ais X`	Scarica e ottimizza un singolo modello IA (vedere l'elenco di seguito)
`-aid`	Scarica tutti i modelli IA senza ottimizzarli (utile per preparare una distribuzione offline; l'ottimizzazione viene eseguita successivamente sul dispositivo di destinazione)
`-aio`	Scarica e ottimizza tutti i modelli IA in un unico passaggio (può richiedere del tempo)

Scaricare e ottimizzare un singolo modello IA

Con l'opzione -ais X, sostituisci "X" con un numero intero in base all'enumerazione sl::AI_MODELS:

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

Nota: gli ID numerici seguono l'ordine dell'enum sl::AI_MODELS e possono cambiare tra le versioni principali di ZED SDK. Verifica sempre l'elenco corrispondente alla versione di ZED SDK installata eseguendo lo strumento con il flag -h.

Per ulteriori informazioni su tutti i comandi disponibili di Diagnostica ZED, usa il flag -h o consulta la Documentazione di Diagnostica ZED.