Zum Hauptinhalt springen

Fehlerbehebung

Diese Seite bietet Diagnose und Lösungen für häufige Probleme bei der Verwendung des MipMapEngine SDK.

🔍 Diagnosetools​

Bei Problemen verwenden Sie bitte zuerst die folgenden Diagnosetools:

1. Konfigurationsdatei-Validierung​

task_json_check.exe -task_json your_config.json

2. Hardware-Überprüfung​

hardware_check.exe

3. Lizenzstatus​

license_manager.exe -info

📋 Häufige Fehler und Lösungen​

Konfigurationsdateifehler​

Fehler: JSON-Parsing fehlgeschlagen​

Fehlermeldung:

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

Ursache: JSON-Formatfehler, normalerweise fehlendes oder zusätzliches Komma.

Lösung:

  1. Verwenden Sie JSON-Formatierungstools zur Syntaxprüfung
  2. Stellen Sie sicher, dass nach dem letzten Element kein Komma steht
  3. Prüfen Sie auf nicht geschlossene Klammern oder Anführungszeichen

Beispielkorrektur:

// Falsch
{
  "image_meta_data": [
    {"id": 1, "path": "image1.jpg"},  // Letztes Element sollte kein Komma haben
  ]
}

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

Fehler: Bilddatei nicht gefunden​

Fehlermeldung:

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

Ursache: Angegebener Bildpfad ist falsch oder Datei existiert nicht.

Lösung:

  1. Überprüfen Sie die Pfad-Rechtschreibung
  2. Bestätigen Sie, dass die Datei tatsächlich existiert
  3. Verwenden Sie das korrekte Pfadtrennzeichen (empfohlen: /)
  4. Versuchen Sie einen absoluten Pfad zu verwenden

Pfadbeispiele:

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

// Windows - Funktioniert auch
"path": "C:\\Projects\\Images\\DJI_0001.JPG"

// Relativer Pfad
"path": "../images/DJI_0001.JPG"

Fehler: Parameter außerhalb des Bereichs​

Fehlermeldung:

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

Ursache: Parameterwert liegt nicht im erlaubten Bereich.

Lösung: Überprüfen und korrigieren Sie die Parameterwerte:

  • resolution_level: 1 (Hoch), 2 (Mittel), 3 (Niedrig)
  • input_image_type: 1 (RGB), 2 (Multispektral), 3 (Infrarot)
  • coordinate_system.type: 1 (Projiziert), 2 (Geografisch), 3 (Geozentrisch)

Bildverarbeitungsfehler​

Fehler: Unzureichende Bilder​

Fehlermeldung:

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

Ursache: Zu wenige Bilder für die 3D-Rekonstruktion.

Lösung:

  • Stellen Sie mindestens 5 Bilder bereit
  • Stellen Sie ausreichende Überlappung zwischen Bildern sicher (empfohlen >60%)
  • Prüfen Sie, ob Bilder automatisch gefiltert wurden (siehe Logs)

Fehler: Keine GPS-Informationen​

Fehlermeldung:

[WARNING] No GPS information found in image EXIF

Ursache: Keine GPS-Informationen in Bild-EXIF.

Lösung:

  1. Verwenden Sie benutzerdefinierte POS-Daten:
{
  "id": 1,
  "path": "image.jpg",
  "meta_data": {
    "pos": [114.123, 22.456, 100.5],
    "pos_sigma": [0.5, 0.5, 1.0]
  }
}
  1. Positionsbeschränkungen reduzieren:
{
  "use_image_position_constraint": false
}

Mehrkamera-Rekonstruktionsprobleme​

Fehler: Kameragruppen-Bildanzahl stimmt nicht überein​

Fehlermeldung:

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

Ursache: Inkonsistente Bildanzahl über verschiedene Kameragruppen.

Lösung:

  1. Prüfen Sie, ob Bilder fehlen
  2. Stellen Sie sicher, dass die Mehrkamera-Synchronauslösung richtig funktioniert
  3. Verwenden Sie task_json_check zur Überprüfung der Gruppierungskonfiguration

Korrektes Gruppierungsbeispiel:

{
  "image_meta_data": [
    // Jede Position sollte Bilder von allen Kameras haben
    {"id": 1, "path": "pos1/nadir.jpg", "group": "nadir"},
    {"id": 2, "path": "pos1/forward.jpg", "group": "forward"},
    {"id": 3, "path": "pos1/backward.jpg", "group": "backward"},
    // ... nächste Position
    {"id": 4, "path": "pos2/nadir.jpg", "group": "nadir"},
    {"id": 5, "path": "pos2/forward.jpg", "group": "forward"},
    {"id": 6, "path": "pos2/backward.jpg", "group": "backward"}
  ]
}

Speicher- und Leistungsprobleme​

Fehler: Nicht genügend Arbeitsspeicher​

Fehlermeldung:

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

Ursache: Systemspeicher reicht nicht aus, um die aktuelle Aufgabe zu verarbeiten.

Lösung:

  1. Präzisionsstufe senken:
{
  "resolution_level": 3  // Niedrige Präzision verwenden
}
  1. Speichernutzung begrenzen:
{
  "min_avali_memory_size": 12.0  // Auf 12GB begrenzen
}
  1. Ausgabeformate reduzieren:
{
  "generate_obj": true,
  "generate_osgb": false,  // Unnötige Ausgaben deaktivieren
  "generate_3d_tiles": false
}

Fehler: GPU-Speicher erschöpft​

Fehlermeldung:

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

Ursache: Unzureichender GPU-Speicher.

Lösung:

  1. Schließen Sie andere Programme, die GPU verwenden
  2. Senken Sie resolution_level
  3. Verwenden Sie Blockverarbeitung (für große Projekte)

Lizenzprobleme​

Fehler: Ungültige Lizenz​

Fehlermeldung:

[ERROR] Invalid license: License has expired

Lösung:

  1. Überprüfen Sie den Lizenzstatus: license_manager.exe -info
  2. Bestätigen Sie, dass die Systemzeit korrekt ist
  3. Reaktivieren Sie die Lizenz
  4. Kontaktieren Sie den technischen Support für Lizenzaktualisierung

Fehler: Virbox-Dienst läuft nicht​

Fehlermeldung:

[ERROR] Virbox service not running

Lösung:

Windows：

# Dienst starten
net start "Virbox Service"

# Dienststatus prüfen
sc query "Virbox Service"

Linux：

# Treiber laden
sudo modprobe virbox

# Treiber prüfen
lsmod | grep virbox

Ausgabeergebnisprobleme​

Problem: Modell hat Löcher​

Mögliche Ursachen:

  • Unzureichende Bildüberlappung
  • Texturarme Bereiche (Wasseroberfläche, Glas usw.)
  • Schlechte Bildqualität

Lösung:

  1. Erhöhen Sie die Bildüberlappung auf 80%
  2. Verwenden Sie Schrägfotografie zur Ergänzung der Seitenansichten
  3. Vermeiden Sie Aufnahmen bei starkem Licht oder Schattenbedingungen
  4. Prüfen und entfernen Sie unscharfe Bilder

Problem: Verschwommene Textur​

Mögliche Ursachen:

  • Originalbilder sind unscharf
  • Flughöhe zu hoch
  • Falsche Kameraeinstellungen

Lösung:

  1. Verwenden Sie schnellere Verschlusszeit (≥1/1000s)
  2. Senken Sie die Flughöhe
  3. Verwenden Sie eine Kamera mit höherer Auflösung
  4. Stellen Sie sicher, dass der Kamerafokus korrekt ist

Problem: Koordinatenversatz​

Mögliche Ursachen:

  • Falsche Koordinatensystemeinstellungen
  • Schlechte GPS-Genauigkeit
  • Keine Kontrollpunkte verwendet

Lösung:

  1. Koordinatensystemkonfiguration prüfen:
{
  "coordinate_system": {
    "type": 2,
    "label": "WGS 84",
    "epsg_code": 4326
  }
}
  1. Kontrollpunkte hinzufügen:
{
  "gcp_path": "gcps.txt",
  "gcp_coor_sys": {
    "type": 3,
    "epsg_code": 32650  // Konsistenz mit tatsächlich sicherstellen
  }
}

🛠️ Erweiterte Diagnose​

Detaillierte Logs anzeigen​

Log-Datei-Speicherort: working_dir/log/log.txt

Wichtige Informationen finden:

# Fehler anzeigen
grep -i "error" log.txt

# Warnungen anzeigen
grep -i "warning" log.txt

# Fortschritt anzeigen
grep "PROGRESS" log.txt

Leistungsanalyse​

Leistungsmetriken in Logs finden:

  • [TIMING] - Zeitverbrauch für jede Phase
  • [MEMORY] - Speichernutzung
  • [GPU] - GPU-Auslastung

Zwischenergebnisse prüfen​

Zwischenergebnisse prüfen, um Probleme zu lokalisieren:

  1. AT-Ergebnisse: working_dir/AT/mvs.xml
  2. ROI-Bereich: working_dir/milestones/roi.json
  3. Qualitätsbericht: working_dir/report/report.json

📞 Hilfe erhalten​

Wenn die obigen Lösungen Ihr Problem nicht lösen können:

  1. Diagnoseinformationen sammeln:

    • Ausgabe von task_json_check
    • Vollständige log.txt-Datei
    • Konfigurationsdatei (mit entfernten sensiblen Daten)
    • Systeminformationen (Hardware-Konfiguration)

  2. Problem einreichen:

    • GitHub Issues: [Projekt-Repository]
    • Technischer Support E-Mail: support@mipmap.com
    • Fügen Sie die obigen Diagnoseinformationen bei

  3. Nach Updates suchen:

    • Prüfen Sie, ob es eine neue Version gibt
    • Überprüfen Sie das Versions-Änderungsprotokoll
    • Folgen Sie der Liste bekannter Probleme

Wird kontinuierlich aktualisiert. Wenn Sie auf nicht aufgeführte Probleme stoßen, kontaktieren Sie bitte den technischen Support.