Passa al contenuto principale

Risoluzione dei problemi

Questa pagina fornisce diagnosi e soluzioni per i problemi comuni durante l'uso dell'SDK MipMapEngine.

🔍 Strumenti di diagnostica​

Quando si incontrano problemi, utilizzare prima i seguenti strumenti di diagnostica:

1. Validazione del file di configurazione​

task_json_check.exe -task_json your_config.json

2. Controllo hardware​

hardware_check.exe

3. Stato della licenza​

license_manager.exe -info

📋 Errori comuni e soluzioni​

Errori del file di configurazione​

Errore: Analisi JSON fallita​

Messaggio di errore:

[ERROR] JSON parse failed: expected ',' or '}' at line 45

Causa: Errore di formato JSON, solitamente virgola mancante o extra.

Soluzione:

  1. Utilizzare strumenti di formattazione JSON per controllare la sintassi
  2. Assicurarsi che non ci sia virgola dopo l'ultimo elemento
  3. Controllare parentesi o virgolette non chiuse

Esempio di correzione:

// Sbagliato
{
  "image_meta_data": [
    {"id": 1, "path": "image1.jpg"},  // L'ultimo elemento non deve avere virgola
  ]
}

// Corretto
{
  "image_meta_data": [
    {"id": 1, "path": "image1.jpg"}
  ]
}

Errore: File immagine non trovato​

Messaggio di errore:

[ERROR] Image file not found: C:/images/DJI_0001.JPG

Causa: Il percorso dell'immagine specificato è errato o il file non esiste.

Soluzione:

  1. Controllare l'ortografia del percorso del file
  2. Confermare che il file esista effettivamente
  3. Utilizzare il separatore di percorso corretto (si consiglia /)
  4. Provare a utilizzare un percorso assoluto

Esempi di percorsi:

// Windows - Consigliato
"path": "C:/Projects/Images/DJI_0001.JPG"

// Windows - Funziona anche
"path": "C:\\Projects\\Images\\DJI_0001.JPG"

// Percorso relativo
"path": "../images/DJI_0001.JPG"

Errore: Parametro fuori range​

Messaggio di errore:

[ERROR] Invalid resolution_level: 5 (should be 1-3)

Causa: Il valore del parametro non è nell'intervallo consentito.

Soluzione: Controllare e correggere i valori dei parametri:

  • resolution_level: 1 (Alto), 2 (Medio), 3 (Basso)
  • input_image_type: 1 (RGB), 2 (Multispettrale), 3 (Infrarosso)
  • coordinate_system.type: 1 (Proiettato), 2 (Geografico), 3 (Geocentrico)

Errori di elaborazione immagini​

Errore: Immagini insufficienti​

Messaggio di errore:

[ERROR] Insufficient images for reconstruction. Minimum 5 images required, found 3.

Causa: Troppo poche immagini per eseguire la ricostruzione 3D.

Soluzione:

  • Fornire almeno 5 immagini
  • Assicurare sovrapposizione sufficiente tra le immagini (consigliato >60%)
  • Controllare se qualche immagine è stata filtrata automaticamente (vedere i log)

Errore: Nessuna informazione GPS​

Messaggio di errore:

[WARNING] No GPS information found in image EXIF

Causa: Nessuna informazione GPS nell'EXIF dell'immagine.

Soluzione:

  1. Utilizzare dati POS personalizzati:
{
  "id": 1,
  "path": "image.jpg",
  "meta_data": {
    "pos": [114.123, 22.456, 100.5],
    "pos_sigma": [0.5, 0.5, 1.0]
  }
}
  1. Ridurre i vincoli di posizione:
{
  "use_image_position_constraint": false
}

Problemi di ricostruzione multi-camera​

Errore: Discrepanza nel conteggio immagini del gruppo camera​

Messaggio di errore:

[ERROR] Camera group image count mismatch: nadir(50), oblique_f(48)

Causa: Conteggio immagini incoerente tra diversi gruppi di telecamere.

Soluzione:

  1. Controllare se mancano immagini
  2. Assicurarsi che il trigger sincrono multi-camera funzioni correttamente
  3. Utilizzare task_json_check per verificare la configurazione del raggruppamento

Esempio di raggruppamento corretto:

{
  "image_meta_data": [
    // Ogni posizione dovrebbe avere immagini da tutte le telecamere
    {"id": 1, "path": "pos1/nadir.jpg", "group": "nadir"},
    {"id": 2, "path": "pos1/forward.jpg", "group": "forward"},
    {"id": 3, "path": "pos1/backward.jpg", "group": "backward"},
    // ... posizione successiva
    {"id": 4, "path": "pos2/nadir.jpg", "group": "nadir"},
    {"id": 5, "path": "pos2/forward.jpg", "group": "forward"},
    {"id": 6, "path": "pos2/backward.jpg", "group": "backward"}
  ]
}

Problemi di memoria e prestazioni​

Errore: Memoria esaurita​

Messaggio di errore:

[ERROR] Out of memory. Required: 24GB, Available: 16GB

Causa: Memoria di sistema insufficiente per elaborare l'attività corrente.

Soluzione:

  1. Abbassare il livello di precisione:
{
  "resolution_level": 3  // Usare bassa precisione
}
  1. Limitare l'uso della memoria:
{
  "min_avali_memory_size": 12.0  // Limitare a 12GB
}
  1. Ridurre i formati di output:
{
  "generate_obj": true,
  "generate_osgb": false,  // Disabilitare output non necessari
  "generate_3d_tiles": false
}

Errore: GPU senza memoria​

Messaggio di errore:

[ERROR] CUDA out of memory. Tried to allocate 2.00 GiB

Causa: Memoria GPU insufficiente.

Soluzione:

  1. Chiudere altri programmi che usano la GPU
  2. Abbassare resolution_level
  3. Utilizzare elaborazione a blocchi (per progetti grandi)

Problemi di licenza​

Errore: Licenza non valida​

Messaggio di errore:

[ERROR] Invalid license: License has expired

Soluzione:

  1. Controllare lo stato della licenza: license_manager.exe -info
  2. Confermare che l'ora di sistema sia corretta
  3. Riattivare la licenza
  4. Contattare il supporto tecnico per aggiornare la licenza

Errore: Servizio Virbox non in esecuzione​

Messaggio di errore:

[ERROR] Virbox service not running

Soluzione:

Windows：

# Avviare il servizio
net start "Virbox Service"

# Controllare lo stato del servizio
sc query "Virbox Service"

Linux：

# Caricare il driver
sudo modprobe virbox

# Controllare il driver
lsmod | grep virbox

Problemi dei risultati di output​

Problema: Il modello ha buchi​

Possibili cause:

  • Sovrapposizione insufficiente delle immagini
  • Aree povere di texture (superficie d'acqua, vetro, ecc.)
  • Scarsa qualità dell'immagine

Soluzione:

  1. Aumentare la sovrapposizione delle immagini all'80%
  2. Utilizzare fotografia obliqua per integrare le viste laterali
  3. Evitare di scattare in condizioni di luce forte o ombra
  4. Controllare e rimuovere immagini sfocate

Problema: Texture sfocata​

Possibili cause:

  • Le immagini originali sono sfocate
  • Altitudine di volo troppo elevata
  • Impostazioni della fotocamera errate

Soluzione:

  1. Utilizzare velocità dell'otturatore più veloce (≥1/1000s)
  2. Abbassare l'altitudine di volo
  3. Utilizzare una fotocamera con risoluzione più alta
  4. Assicurarsi che la messa a fuoco della fotocamera sia corretta

Problema: Offset delle coordinate​

Possibili cause:

  • Impostazioni del sistema di coordinate errate
  • Scarsa precisione GPS
  • Nessun punto di controllo utilizzato

Soluzione:

  1. Controllare la configurazione del sistema di coordinate:
{
  "coordinate_system": {
    "type": 2,
    "label": "WGS 84",
    "epsg_code": 4326
  }
}
  1. Aggiungere punti di controllo:
{
  "gcp_path": "gcps.txt",
  "gcp_coor_sys": {
    "type": 3,
    "epsg_code": 32650  // Garantire coerenza con l'effettivo
  }
}

🛠️ Diagnostica avanzata​

Visualizzare log dettagliati​

Posizione del file di log: working_dir/log/log.txt

Trovare informazioni chiave:

# Visualizzare errori
grep -i "error" log.txt

# Visualizzare avvisi
grep -i "warning" log.txt

# Visualizzare progresso
grep "PROGRESS" log.txt

Analisi delle prestazioni​

Trovare metriche di prestazioni nei log:

  • [TIMING] - Consumo di tempo per ogni fase
  • [MEMORY] - Utilizzo della memoria
  • [GPU] - Utilizzo GPU

Controllo dei risultati intermedi​

Controllare i risultati intermedi per localizzare i problemi:

  1. Risultati AT: working_dir/AT/mvs.xml
  2. Intervallo ROI: working_dir/milestones/roi.json
  3. Report di qualità: working_dir/report/report.json

📞 Ottenere aiuto​

Se le soluzioni sopra non possono risolvere il problema:

  1. Raccogliere informazioni diagnostiche:

    • Output dall'esecuzione di task_json_check
    • File log.txt completo
    • File di configurazione (con dati sensibili rimossi)
    • Informazioni di sistema (configurazione hardware)

  2. Inviare il problema:

    • GitHub Issues: [Repository del progetto]
    • Email del supporto tecnico: support@mipmap.com
    • Includere le informazioni diagnostiche sopra

  3. Verificare aggiornamenti:

    • Controllare se c'è una nuova versione
    • Rivedere il changelog della versione
    • Seguire la lista dei problemi noti

Aggiornato continuamente. Se si incontrano problemi non elencati, contattare il supporto tecnico.