Aller au contenu principal

Dépannage

Cette page fournit le diagnostic et les solutions pour les problèmes courants lors de l'utilisation du SDK MipMapEngine.

🔍 Outils de diagnostic​

Lorsque vous rencontrez des problèmes, veuillez d'abord utiliser les outils de diagnostic suivants :

1. Validation du fichier de configuration​

task_json_check.exe -task_json your_config.json

2. Vérification du matériel​

hardware_check.exe

3. État de la licence​

license_manager.exe -info

📋 Erreurs courantes et solutions​

Erreurs de fichier de configuration​

Erreur : Échec de l'analyse JSON​

Message d'erreur :

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

Cause : Erreur de format JSON, généralement virgule manquante ou supplémentaire.

Solution :

  1. Utilisez des outils de formatage JSON pour vérifier la syntaxe
  2. Assurez-vous qu'il n'y a pas de virgule après le dernier élément
  3. Vérifiez les parenthèses ou guillemets non fermés

Exemple de correction :

// Incorrect
{
  "image_meta_data": [
    {"id": 1, "path": "image1.jpg"},  // Le dernier élément ne doit pas avoir de virgule
  ]
}

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

Erreur : Fichier image introuvable​

Message d'erreur :

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

Cause : Le chemin d'image spécifié est incorrect ou le fichier n'existe pas.

Solution :

  1. Vérifiez l'orthographe du chemin du fichier
  2. Confirmez que le fichier existe réellement
  3. Utilisez le bon séparateur de chemin (recommandé : /)
  4. Essayez d'utiliser un chemin absolu

Exemples de chemins :

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

// Windows - Fonctionne aussi
"path": "C:\\Projects\\Images\\DJI_0001.JPG"

// Chemin relatif
"path": "../images/DJI_0001.JPG"

Erreur : Paramètre hors limites​

Message d'erreur :

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

Cause : La valeur du paramètre n'est pas dans la plage autorisée.

Solution : Vérifiez et corrigez les valeurs des paramètres :

  • resolution_level : 1 (Élevé), 2 (Moyen), 3 (Faible)
  • input_image_type : 1 (RGB), 2 (Multispectral), 3 (Infrarouge)
  • coordinate_system.type : 1 (Projeté), 2 (Géographique), 3 (Géocentrique)

Erreurs de traitement d'image​

Erreur : Images insuffisantes​

Message d'erreur :

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

Cause : Trop peu d'images pour effectuer la reconstruction 3D.

Solution :

  • Fournissez au moins 5 images
  • Assurez un chevauchement suffisant entre les images (recommandé >60%)
  • Vérifiez si des images ont été filtrées automatiquement (voir les journaux)

Erreur : Aucune information GPS​

Message d'erreur :

[WARNING] No GPS information found in image EXIF

Cause : Aucune information GPS dans l'EXIF de l'image.

Solution :

  1. Utilisez des données POS personnalisées :
{
  "id": 1,
  "path": "image.jpg",
  "meta_data": {
    "pos": [114.123, 22.456, 100.5],
    "pos_sigma": [0.5, 0.5, 1.0]
  }
}
  1. Réduire les contraintes de position :
{
  "use_image_position_constraint": false
}

Problèmes de reconstruction multi-caméras​

Erreur : Non-concordance du nombre d'images du groupe de caméras​

Message d'erreur :

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

Cause : Nombre d'images incohérent entre différents groupes de caméras.

Solution :

  1. Vérifiez s'il manque des images
  2. Assurez-vous que le déclenchement synchrone multi-caméras fonctionne correctement
  3. Utilisez task_json_check pour vérifier la configuration du regroupement

Exemple de regroupement correct :

{
  "image_meta_data": [
    // Chaque position doit avoir des images de toutes les caméras
    {"id": 1, "path": "pos1/nadir.jpg", "group": "nadir"},
    {"id": 2, "path": "pos1/forward.jpg", "group": "forward"},
    {"id": 3, "path": "pos1/backward.jpg", "group": "backward"},
    // ... position suivante
    {"id": 4, "path": "pos2/nadir.jpg", "group": "nadir"},
    {"id": 5, "path": "pos2/forward.jpg", "group": "forward"},
    {"id": 6, "path": "pos2/backward.jpg", "group": "backward"}
  ]
}

Problèmes de mémoire et de performances​

Erreur : Mémoire insuffisante​

Message d'erreur :

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

Cause : Mémoire système insuffisante pour traiter la tâche actuelle.

Solution :

  1. Réduire le niveau de précision :
{
  "resolution_level": 3  // Utiliser une faible précision
}
  1. Limiter l'utilisation de la mémoire :
{
  "min_avali_memory_size": 12.0  // Limiter à 12GB
}
  1. Réduire les formats de sortie :
{
  "generate_obj": true,
  "generate_osgb": false,  // Désactiver les sorties inutiles
  "generate_3d_tiles": false
}

Erreur : Mémoire GPU insuffisante​

Message d'erreur :

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

Cause : Mémoire GPU insuffisante.

Solution :

  1. Fermez les autres programmes utilisant le GPU
  2. Réduisez resolution_level
  3. Utilisez le traitement par blocs (pour les grands projets)

Problèmes de licence​

Erreur : Licence invalide​

Message d'erreur :

[ERROR] Invalid license: License has expired

Solution :

  1. Vérifiez l'état de la licence : license_manager.exe -info
  2. Confirmez que l'heure système est correcte
  3. Réactivez la licence
  4. Contactez le support technique pour mettre à jour la licence

Erreur : Service Virbox non en cours d'exécution​

Message d'erreur :

[ERROR] Virbox service not running

Solution :

Windows :

# Démarrer le service
net start "Virbox Service"

# Vérifier l'état du service
sc query "Virbox Service"

Linux :

# Charger le pilote
sudo modprobe virbox

# Vérifier le pilote
lsmod | grep virbox

Problèmes de résultats de sortie​

Problème : Le modèle a des trous​

Causes possibles :

  • Chevauchement insuffisant des images
  • Zones pauvres en texture (surface d'eau, verre, etc.)
  • Mauvaise qualité d'image

Solution :

  1. Augmentez le chevauchement des images à 80%
  2. Utilisez la photographie oblique pour compléter les vues latérales
  3. Évitez de prendre des photos dans des conditions de lumière forte ou d'ombre
  4. Vérifiez et supprimez les images floues

Problème : Texture floue​

Causes possibles :

  • Les images originales sont floues
  • Altitude de vol trop élevée
  • Mauvais réglages de l'appareil photo

Solution :

  1. Utilisez une vitesse d'obturation plus rapide (≥1/1000s)
  2. Réduisez l'altitude de vol
  3. Utilisez un appareil photo de résolution supérieure
  4. Assurez-vous que la mise au point de l'appareil photo est correcte

Problème : Décalage de coordonnées​

Causes possibles :

  • Mauvais paramètres du système de coordonnées
  • Mauvaise précision GPS
  • Aucun point de contrôle utilisé

Solution :

  1. Vérifier la configuration du système de coordonnées :
{
  "coordinate_system": {
    "type": 2,
    "label": "WGS 84",
    "epsg_code": 4326
  }
}
  1. Ajouter des points de contrôle :
{
  "gcp_path": "gcps.txt",
  "gcp_coor_sys": {
    "type": 3,
    "epsg_code": 32650  // Assurer la cohérence avec le réel
  }
}

🛠️ Diagnostic avancé​

Afficher les journaux détaillés​

Emplacement du fichier journal : working_dir/log/log.txt

Trouver les informations clés :

# Afficher les erreurs
grep -i "error" log.txt

# Afficher les avertissements
grep -i "warning" log.txt

# Afficher la progression
grep "PROGRESS" log.txt

Analyse des performances​

Trouver les métriques de performance dans les journaux :

  • [TIMING] - Consommation de temps pour chaque étape
  • [MEMORY] - Utilisation de la mémoire
  • [GPU] - Utilisation du GPU

Vérification des résultats intermédiaires​

Vérifier les résultats intermédiaires pour localiser les problèmes :

  1. Résultats AT : working_dir/AT/mvs.xml
  2. Plage ROI : working_dir/milestones/roi.json
  3. Rapport de qualité : working_dir/report/report.json

📞 Obtenir de l'aide​

Si les solutions ci-dessus ne peuvent pas résoudre votre problème :

  1. Collecter les informations de diagnostic :

    • Sortie de l'exécution de task_json_check
    • Fichier log.txt complet
    • Fichier de configuration (avec données sensibles supprimées)
    • Informations système (configuration matérielle)

  2. Soumettre le problème :

    • GitHub Issues : [Dépôt du projet]
    • Email du support technique : support@mipmap.com
    • Incluez les informations de diagnostic ci-dessus

  3. Vérifier les mises à jour :

    • Vérifiez s'il existe une nouvelle version
    • Consultez le journal des modifications de version
    • Suivez la liste des problèmes connus

Mis à jour en continu. Si vous rencontrez des problèmes non répertoriés, veuillez contacter le support technique.