Pular para o conteúdo principal

Solução de Problemas

Esta página fornece diagnóstico e soluções para problemas comuns ao usar o SDK MipMapEngine.

🔍 Ferramentas de Diagnóstico​

Ao encontrar problemas, use primeiro as seguintes ferramentas de diagnóstico:

1. Validação do Arquivo de Configuração​

task_json_check.exe -task_json your_config.json

2. Verificação de Hardware​

hardware_check.exe

3. Status da Licença​

license_manager.exe -info

📋 Erros Comuns e Soluções​

Erros do Arquivo de Configuração​

Erro: Falha na Análise JSON​

Mensagem de erro:

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

Causa: Erro de formato JSON, geralmente vírgula ausente ou extra.

Solução:

  1. Use ferramentas de formatação JSON para verificar a sintaxe
  2. Certifique-se de que não há vírgula após o último elemento
  3. Verifique colchetes ou aspas não fechados

Exemplo de correção:

// Errado
{
  "image_meta_data": [
    {"id": 1, "path": "image1.jpg"},  // Último elemento não deve ter vírgula
  ]
}

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

Erro: Arquivo de Imagem Não Encontrado​

Mensagem de erro:

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

Causa: O caminho da imagem especificado está incorreto ou o arquivo não existe.

Solução:

  1. Verifique a ortografia do caminho do arquivo
  2. Confirme que o arquivo realmente existe
  3. Use o separador de caminho correto (recomenda-se usar /)
  4. Tente usar um caminho absoluto

Exemplos de caminhos:

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

// Windows - Também funciona
"path": "C:\\Projects\\Images\\DJI_0001.JPG"

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

Erro: Parâmetro Fora do Intervalo​

Mensagem de erro:

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

Causa: O valor do parâmetro não está dentro do intervalo permitido.

Solução: Verifique e corrija os valores dos parâmetros:

  • resolution_level: 1 (Alto), 2 (Médio), 3 (Baixo)
  • input_image_type: 1 (RGB), 2 (Multiespectral), 3 (Infravermelho)
  • coordinate_system.type: 1 (Projetado), 2 (Geográfico), 3 (Geocêntrico)

Erros de Processamento de Imagem​

Erro: Imagens Insuficientes​

Mensagem de erro:

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

Causa: Poucas imagens para realizar a reconstrução 3D.

Solução:

  • Forneça pelo menos 5 imagens
  • Garanta sobreposição suficiente entre as imagens (recomendado >60%)
  • Verifique se alguma imagem foi filtrada automaticamente (veja os logs)

Erro: Sem Informações GPS​

Mensagem de erro:

[WARNING] No GPS information found in image EXIF

Causa: Sem informações GPS no EXIF da imagem.

Solução:

  1. Use dados 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. Reduza as restrições de posição:
{
  "use_image_position_constraint": false
}

Problemas de Reconstrução Multi-câmera​

Erro: Incompatibilidade na Contagem de Imagens do Grupo de Câmeras​

Mensagem de erro:

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

Causa: Contagem de imagens inconsistente entre diferentes grupos de câmeras.

Solução:

  1. Verifique se há imagens faltando
  2. Certifique-se de que o disparo síncrono multi-câmera funciona corretamente
  3. Use task_json_check para verificar a configuração de agrupamento

Exemplo de agrupamento correto:

{
  "image_meta_data": [
    // Cada posição deve ter imagens de todas as câmeras
    {"id": 1, "path": "pos1/nadir.jpg", "group": "nadir"},
    {"id": 2, "path": "pos1/forward.jpg", "group": "forward"},
    {"id": 3, "path": "pos1/backward.jpg", "group": "backward"},
    // ... próxima posição
    {"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 Memória e Desempenho​

Erro: Sem Memória​

Mensagem de erro:

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

Causa: Memória do sistema insuficiente para processar a tarefa atual.

Solução:

  1. Reduzir o nível de precisão:
{
  "resolution_level": 3  // Usar baixa precisão
}
  1. Limitar o uso de memória:
{
  "min_avali_memory_size": 12.0  // Limitar a 12GB
}
  1. Reduzir formatos de saída:
{
  "generate_obj": true,
  "generate_osgb": false,  // Desativar saídas desnecessárias
  "generate_3d_tiles": false
}

Erro: GPU Sem Memória​

Mensagem de erro:

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

Causa: Memória GPU insuficiente.

Solução:

  1. Feche outros programas que usam GPU
  2. Reduza resolution_level
  3. Use processamento em bloco (para projetos grandes)

Problemas de Licença​

Erro: Licença Inválida​

Mensagem de erro:

[ERROR] Invalid license: License has expired

Solução:

  1. Verifique o status da licença: license_manager.exe -info
  2. Confirme que a hora do sistema está correta
  3. Reative a licença
  4. Entre em contato com o suporte técnico para atualizar a licença

Erro: Serviço Virbox Não Está em Execução​

Mensagem de erro:

[ERROR] Virbox service not running

Solução:

Windows：

# Iniciar serviço
net start "Virbox Service"

# Verificar status do serviço
sc query "Virbox Service"

Linux：

# Carregar driver
sudo modprobe virbox

# Verificar driver
lsmod | grep virbox

Problemas de Resultados de Saída​

Problema: Modelo Tem Buracos​

Possíveis causas:

  • Sobreposição insuficiente de imagens
  • Áreas com pouca textura (superfície da água, vidro, etc.)
  • Má qualidade da imagem

Solução:

  1. Aumente a sobreposição de imagens para 80%
  2. Use fotografia oblíqua para complementar as vistas laterais
  3. Evite fotografar em condições de luz forte ou sombra
  4. Verifique e remova imagens borradas

Problema: Textura Borrada​

Possíveis causas:

  • Imagens originais estão borradas
  • Altitude de voo muito alta
  • Configurações inadequadas da câmera

Solução:

  1. Use velocidade do obturador mais rápida (≥1/1000s)
  2. Reduza a altitude de voo
  3. Use câmera de maior resolução
  4. Certifique-se de que o foco da câmera está correto

Problema: Deslocamento de Coordenadas​

Possíveis causas:

  • Configurações incorretas do sistema de coordenadas
  • Má precisão do GPS
  • Nenhum ponto de controle usado

Solução:

  1. Verificar configuração do sistema de coordenadas:
{
  "coordinate_system": {
    "type": 2,
    "label": "WGS 84",
    "epsg_code": 4326
  }
}
  1. Adicionar pontos de controle:
{
  "gcp_path": "gcps.txt",
  "gcp_coor_sys": {
    "type": 3,
    "epsg_code": 32650  // Garantir consistência com o real
  }
}

🛠️ Diagnóstico Avançado​

Visualizar Logs Detalhados​

Localização do arquivo de log: working_dir/log/log.txt

Encontrar informações-chave:

# Visualizar erros
grep -i "error" log.txt

# Visualizar avisos
grep -i "warning" log.txt

# Visualizar progresso
grep "PROGRESS" log.txt

Análise de Desempenho​

Encontrar métricas de desempenho nos logs:

  • [TIMING] - Consumo de tempo para cada etapa
  • [MEMORY] - Uso de memória
  • [GPU] - Utilização de GPU

Verificação de Resultados Intermediários​

Verificar resultados intermediários para localizar problemas:

  1. Resultados AT: working_dir/AT/mvs.xml
  2. Intervalo ROI: working_dir/milestones/roi.json
  3. Relatório de qualidade: working_dir/report/report.json

📞 Obter Ajuda​

Se as soluções acima não puderem resolver seu problema:

  1. Coletar informações de diagnóstico:

    • Saída da execução de task_json_check
    • Arquivo log.txt completo
    • Arquivo de configuração (com dados sensíveis removidos)
    • Informações do sistema (configuração de hardware)

  2. Enviar problema:

    • GitHub Issues: [Repositório do Projeto]
    • Email de suporte técnico: support@mipmap.com
    • Incluir as informações de diagnóstico acima

  3. Verificar atualizações:

    • Verifique se há uma nova versão
    • Revise o changelog da versão
    • Acompanhe a lista de problemas conhecidos

Atualizado continuamente. Se encontrar problemas não listados, entre em contato com o suporte técnico.