2. Configurazione delle Librerie di Dipendenza¶
A Chi È Rivolta Questa Pagina
Questa pagina è destinata agli utenti che hanno bisogno di comprendere la composizione delle dipendenze del software, o che non possono utilizzare lo strumento di distribuzione integrato in produzione. Gli utenti normali dovrebbero utilizzare direttamente il modulo integrato "Environment Deployment" (consigliato).
1. Installare Python 3.12 (Prerequisito Obbligatorio)¶
Questo software richiede un ambiente Python serie 3.12.
Ubuntu 24.04.4 LTS include già la serie Python 3.12, quindi su quel sistema puoi saltare questa sezione.
1.1 Scaricare Python 3.12¶
Si consiglia di scaricare l'ultima release stabile 3.12 dal sito ufficiale di Python:
- Pagina di download ufficiale: Tutte le versioni di Python
- Download consigliato: cerca nella pagina il
Windows installer (64-bit)per la serie 3.12, ad esempio Python 3.12.4.

1.2 Passaggi Chiave dell'Installazione¶
1.2.1 Avviare l'Installazione¶
- Esegui l'installer
.exeappena scaricato. - Importante (obbligatorio): nella prima schermata dell'installer, seleziona "Add Python.exe to PATH".
Se non selezioni questa opzione, non potrai utilizzare il comando python direttamente dal terminale.
- Clicca su "Install Now", oppure scegli un'installazione personalizzata se necessario.

1.2.2 Disabilitare il Limite di Lunghezza del Path (opzionale)¶
Al termine dell'installazione, se appare l'opzione "Disable path length limit", si consiglia di cliccarla. Questo evita errori nella gestione di percorsi file molto annidati, come quelli dei modelli di deep learning.

1.3 Verifica dell'Ambiente¶
Al termine dell'installazione, apri la riga di comando (CMD o PowerShell) e digita il seguente comando per verificare:
2. Dipendenze Principali¶
Per supportare le funzionalità di rilevamento visuale YOLO, elaborazione immagini e analisi dei dati, il software richiede specifiche librerie Python. Questo software include uno strumento di distribuzione dell'ambiente con un clic che supporta sia la modalità online che offline.
2.1 Elenco delle Librerie di Dipendenza Principali¶
- OpenCV (opencv-python): elaborazione immagini e driver delle camere.
- Pillow (PIL): operazioni di base sulle immagini e conversione di formato.
- NumPy: calcolo matriciale ed elaborazione di dati visuali.
- Scikit-learn: valutazione dei modelli algoritmici e preprocessing dei dati.
- Tqdm: visualizzazione della barra di avanzamento durante training ed elaborazione.
3. Distribuzione Online (Consigliata)¶
Se il tuo ambiente dispone attualmente di una connessione a Internet, questo è il modo più rapido per configurare l'ambiente.
Apri il software: entra nell'interfaccia principale e seleziona Environment Deployment nella barra laterale.

- Selezione del mirror:
Huawei Cloud Mirrorcome predefinito. - Installazione: clicca su ogni singola card e attendi il completamento della barra di avanzamento.
-
Verifica:
4. Distribuzione Offline (Per Siti di Produzione)¶
Per i siti industriali che non possono connettersi a Internet, segui i passaggi seguenti per utilizzare il pacchetto offline pre-scaricato.
4.1 Eseguire l'Installazione Offline¶
- Nell'interfaccia "Environment Deployment" del software, seleziona "Offline Install".
- Individua le risorse: nella finestra di directory che si apre, seleziona la cartella del pacchetto offline fornita con il software.

Infine, distribuzione con un clic: clicca su "Install Selected Files". Il software eseguirà i comandi integrati per installare i file whl da un percorso locale, senza richiedere una connessione a Internet.
