Saltar al contenido principal

Solución de problemas

Esta página proporciona diagnóstico y soluciones para problemas comunes al usar MipMapEngine SDK.

🔍 Herramientas de diagnóstico​

Al encontrar problemas, primero use las siguientes herramientas de diagnóstico:

1. Validación del archivo de configuración​

task_json_check.exe -task_json your_config.json

2. Verificación de hardware​

hardware_check.exe

3. Estado de la licencia​

license_manager.exe -info

📋 Errores comunes y soluciones​

Errores del archivo de configuración​

Error: Fallo al analizar JSON​

Mensaje de error:

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

Causa: Error de formato JSON, generalmente falta una coma o hay una coma extra.

Solución:

  1. Use herramientas de formato JSON para verificar la sintaxis
  2. Asegúrese de que no haya coma después del último elemento
  3. Verifique corchetes o comillas sin cerrar

Ejemplo de corrección:

// Incorrecto
{
  "image_meta_data": [
    {"id": 1, "path": "image1.jpg"},  // El último elemento no debe tener coma
  ]
}

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

Error: Archivo de imagen no encontrado​

Mensaje de error:

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

Causa: La ruta de imagen especificada es incorrecta o el archivo no existe.

Solución:

  1. Verifique la ortografía de la ruta del archivo
  2. Confirme que el archivo realmente existe
  3. Use el separador de ruta correcto (se recomienda usar /)
  4. Intente usar una ruta absoluta

Ejemplos de rutas:

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

// Windows - También funciona
"path": "C:\\Projects\\Images\\DJI_0001.JPG"

// Ruta relativa
"path": "../images/DJI_0001.JPG"

Error: Parámetro fuera de rango​

Mensaje de error:

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

Causa: El valor del parámetro no está dentro del rango permitido.

Solución: Verifique y corrija los valores de los parámetros:

  • resolution_level: 1 (Alto), 2 (Medio), 3 (Bajo)
  • input_image_type: 1 (RGB), 2 (Multiespectral), 3 (Infrarrojo)
  • coordinate_system.type: 1 (Proyectado), 2 (Geográfico), 3 (Geocéntrico)

Errores de procesamiento de imágenes​

Error: Imágenes insuficientes​

Mensaje de error:

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

Causa: Muy pocas imágenes para realizar la reconstrucción 3D.

Solución:

  • Proporcione al menos 5 imágenes
  • Asegure suficiente solapamiento entre imágenes (recomendado >60%)
  • Verifique si alguna imagen fue filtrada automáticamente (ver registros)

Error: Sin información GPS​

Mensaje de error:

[WARNING] No GPS information found in image EXIF

Causa: No hay información GPS en el EXIF de la imagen.

Solución:

  1. Use datos POS personalizados:
{
  "id": 1,
  "path": "image.jpg",
  "meta_data": {
    "pos": [114.123, 22.456, 100.5],
    "pos_sigma": [0.5, 0.5, 1.0]
  }
}
  1. Reduzca las restricciones de posición:
{
  "use_image_position_constraint": false
}

Problemas de reconstrucción multicámara​

Error: Discrepancia en el conteo de imágenes del grupo de cámaras​

Mensaje de error:

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

Causa: Cantidad inconsistente de imágenes entre diferentes grupos de cámaras.

Solución:

  1. Verifique si faltan imágenes
  2. Asegúrese de que el disparo sincrónico multicámara funcione correctamente
  3. Use task_json_check para verificar la configuración de agrupación

Ejemplo de agrupación correcta:

{
  "image_meta_data": [
    // Cada posición debe tener imágenes de todas las cámaras
    {"id": 1, "path": "pos1/nadir.jpg", "group": "nadir"},
    {"id": 2, "path": "pos1/forward.jpg", "group": "forward"},
    {"id": 3, "path": "pos1/backward.jpg", "group": "backward"},
    // ... siguiente posición
    {"id": 4, "path": "pos2/nadir.jpg", "group": "nadir"},
    {"id": 5, "path": "pos2/forward.jpg", "group": "forward"},
    {"id": 6, "path": "pos2/backward.jpg", "group": "backward"}
  ]
}

Problemas de memoria y rendimiento​

Error: Sin memoria​

Mensaje de error:

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

Causa: Memoria del sistema insuficiente para procesar la tarea actual.

Solución:

  1. Reducir el nivel de precisión:
{
  "resolution_level": 3  // Usar baja precisión
}
  1. Limitar el uso de memoria:
{
  "min_avali_memory_size": 12.0  // Limitar a 12GB
}
  1. Reducir formatos de salida:
{
  "generate_obj": true,
  "generate_osgb": false,  // Desactivar salidas innecesarias
  "generate_3d_tiles": false
}

Error: GPU sin memoria​

Mensaje de error:

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

Causa: Memoria GPU insuficiente.

Solución:

  1. Cierre otros programas que usen GPU
  2. Reduzca resolution_level
  3. Use procesamiento por bloques (para proyectos grandes)

Problemas de licencia​

Error: Licencia inválida​

Mensaje de error:

[ERROR] Invalid license: License has expired

Solución:

  1. Verifique el estado de la licencia: license_manager.exe -info
  2. Confirme que la hora del sistema sea correcta
  3. Reactive la licencia
  4. Contacte al soporte técnico para actualizar la licencia

Error: Servicio Virbox no está ejecutándose​

Mensaje de error:

[ERROR] Virbox service not running

Solución:

Windows：

# Iniciar servicio
net start "Virbox Service"

# Verificar estado del servicio
sc query "Virbox Service"

Linux：

# Cargar controlador
sudo modprobe virbox

# Verificar controlador
lsmod | grep virbox

Problemas de resultados de salida​

Problema: El modelo tiene agujeros​

Posibles causas:

  • Solapamiento insuficiente de imágenes
  • Áreas con poca textura (superficie del agua, vidrio, etc.)
  • Mala calidad de imagen

Solución:

  1. Aumente el solapamiento de imágenes al 80%
  2. Use fotografía oblicua para complementar las vistas laterales
  3. Evite tomar fotos en condiciones de luz fuerte o sombra
  4. Verifique y elimine imágenes borrosas

Problema: Textura borrosa​

Posibles causas:

  • Las imágenes originales están borrosas
  • Altitud de vuelo demasiado alta
  • Configuración incorrecta de la cámara

Solución:

  1. Use velocidad de obturación más rápida (≥1/1000s)
  2. Reduzca la altitud de vuelo
  3. Use una cámara de mayor resolución
  4. Asegúrese de que el enfoque de la cámara sea correcto

Problema: Desplazamiento de coordenadas​

Posibles causas:

  • Configuración incorrecta del sistema de coordenadas
  • Mala precisión del GPS
  • No se usaron puntos de control

Solución:

  1. Verificar configuración del sistema de coordenadas:
{
  "coordinate_system": {
    "type": 2,
    "label": "WGS 84",
    "epsg_code": 4326
  }
}
  1. Agregar puntos de control:
{
  "gcp_path": "gcps.txt",
  "gcp_coor_sys": {
    "type": 3,
    "epsg_code": 32650  // Asegurar consistencia con el real
  }
}

🛠️ Diagnóstico avanzado​

Ver registros detallados​

Ubicación del archivo de registro: working_dir/log/log.txt

Encontrar información clave:

# Ver errores
grep -i "error" log.txt

# Ver advertencias
grep -i "warning" log.txt

# Ver progreso
grep "PROGRESS" log.txt

Análisis de rendimiento​

Encontrar métricas de rendimiento en los registros:

  • [TIMING] - Consumo de tiempo para cada etapa
  • [MEMORY] - Uso de memoria
  • [GPU] - Utilización de GPU

Verificación de resultados intermedios​

Verificar resultados intermedios para localizar problemas:

  1. Resultados AT: working_dir/AT/mvs.xml
  2. Rango ROI: working_dir/milestones/roi.json
  3. Informe de calidad: working_dir/report/report.json

📞 Obtener ayuda​

Si las soluciones anteriores no pueden resolver su problema:

  1. Recopilar información de diagnóstico:

    • Salida de ejecutar task_json_check
    • Archivo log.txt completo
    • Archivo de configuración (con datos sensibles eliminados)
    • Información del sistema (configuración de hardware)

  2. Enviar problema:

    • GitHub Issues: [Repositorio del proyecto]
    • Email de soporte técnico: support@mipmap.com
    • Incluya la información de diagnóstico anterior

  3. Buscar actualizaciones:

    • Verifique si hay una nueva versión
    • Revise el registro de cambios de versión
    • Siga la lista de problemas conocidos

Actualizado continuamente. Si encuentra problemas no listados, contacte al soporte técnico.