跳轉到

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:

python_download.png

1.2 Passaggi Chiave dell'Installazione

1.2.1 Avviare l'Installazione

  1. Esegui l'installer .exe appena scaricato.
  2. 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.

  3. Clicca su "Install Now", oppure scegli un'installazione personalizzata se necessario.

toPATH.png

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.

Disablepathlengthlimit.png

1.3 Verifica dell'Ambiente

Al termine dell'installazione, apri la riga di comando (CMD o PowerShell) e digita il seguente comando per verificare:

# Verifica la versione di Python (va bene qualsiasi output che mostri 3.12.x)
python --version

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.

pythonKU.png

  1. Selezione del mirror: Huawei Cloud Mirror come predefinito.
  2. Installazione: clicca su ogni singola card e attendi il completamento della barra di avanzamento.
  3. Verifica:

    # Digita il seguente comando nel terminale; dovrebbero apparire i numeri di versione corrispondenti.
    pip list | findstr "opencv pillow numpy scikit-learn tqdm"
    

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

  1. Nell'interfaccia "Environment Deployment" del software, seleziona "Offline Install".
  2. Individua le risorse: nella finestra di directory che si apre, seleziona la cartella del pacchetto offline fornita con il software.

pythonKU2.png

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.

pythonKU3.png