Перейти к основному содержимому

Устранение неполадок

На этой странице представлена диагностика и решения распространенных проблем при использовании SDK MipMapEngine.

🔍 Инструменты диагностики​

При возникновении проблем сначала используйте следующие инструменты диагностики:

1. Проверка файла конфигурации​

task_json_check.exe -task_json your_config.json

2. Проверка оборудования​

hardware_check.exe

3. Статус лицензии​

license_manager.exe -info

📋 Распространенные ошибки и решения​

Ошибки файла конфигурации​

Ошибка: Не удалось разобрать JSON​

Сообщение об ошибке:

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

Причина: Ошибка формата JSON, обычно отсутствующая или лишняя запятая.

Решение:

  1. Используйте инструменты форматирования JSON для проверки синтаксиса
  2. Убедитесь, что после последнего элемента нет запятой
  3. Проверьте незакрытые скобки или кавычки

Пример исправления:

// Неправильно
{
  "image_meta_data": [
    {"id": 1, "path": "image1.jpg"},  // Последний элемент не должен иметь запятую
  ]
}

// Правильно
{
  "image_meta_data": [
    {"id": 1, "path": "image1.jpg"}
  ]
}

Ошибка: Файл изображения не найден​

Сообщение об ошибке:

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

Причина: Указанный путь к изображению неверен или файл не существует.

Решение:

  1. Проверьте правописание пути к файлу
  2. Подтвердите, что файл действительно существует
  3. Используйте правильный разделитель пути (рекомендуется использовать /)
  4. Попробуйте использовать абсолютный путь

Примеры путей:

// Windows - Рекомендуется
"path": "C:/Projects/Images/DJI_0001.JPG"

// Windows - Также работает
"path": "C:\\Projects\\Images\\DJI_0001.JPG"

// Относительный путь
"path": "../images/DJI_0001.JPG"

Ошибка: Параметр вне диапазона​

Сообщение об ошибке:

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

Причина: Значение параметра не находится в допустимом диапазоне.

Решение: Проверьте и исправьте значения параметров:

  • resolution_level: 1 (Высокий), 2 (Средний), 3 (Низкий)
  • input_image_type: 1 (RGB), 2 (Мультиспектральный), 3 (Инфракрасный)
  • coordinate_system.type: 1 (Проекционный), 2 (Географический), 3 (Геоцентрический)

Ошибки обработки изображений​

Ошибка: Недостаточно изображений​

Сообщение об ошибке:

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

Причина: Слишком мало изображений для выполнения 3D-реконструкции.

Решение:

  • Предоставьте минимум 5 изображений
  • Обеспечьте достаточное перекрытие между изображениями (рекомендуется >60%)
  • Проверьте, были ли изображения автоматически отфильтрованы (см. логи)

Ошибка: Нет информации GPS​

Сообщение об ошибке:

[WARNING] No GPS information found in image EXIF

Причина: Нет информации GPS в EXIF изображения.

Решение:

  1. Используйте пользовательские данные POS:
{
  "id": 1,
  "path": "image.jpg",
  "meta_data": {
    "pos": [114.123, 22.456, 100.5],
    "pos_sigma": [0.5, 0.5, 1.0]
  }
}
  1. Уменьшите ограничения позиции:
{
  "use_image_position_constraint": false
}

Проблемы многокамерной реконструкции​

Ошибка: Несоответствие количества изображений группы камер​

Сообщение об ошибке:

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

Причина: Несогласованное количество изображений между различными группами камер.

Решение:

  1. Проверьте, отсутствуют ли изображения
  2. Убедитесь, что синхронный триггер многокамерной съемки работает правильно
  3. Используйте task_json_check для проверки конфигурации группировки

Пример правильной группировки:

{
  "image_meta_data": [
    // Каждая позиция должна иметь изображения со всех камер
    {"id": 1, "path": "pos1/nadir.jpg", "group": "nadir"},
    {"id": 2, "path": "pos1/forward.jpg", "group": "forward"},
    {"id": 3, "path": "pos1/backward.jpg", "group": "backward"},
    // ... следующая позиция
    {"id": 4, "path": "pos2/nadir.jpg", "group": "nadir"},
    {"id": 5, "path": "pos2/forward.jpg", "group": "forward"},
    {"id": 6, "path": "pos2/backward.jpg", "group": "backward"}
  ]
}

Проблемы с памятью и производительностью​

Ошибка: Недостаточно памяти​

Сообщение об ошибке:

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

Причина: Недостаточно системной памяти для обработки текущей задачи.

Решение:

  1. Снизить уровень точности:
{
  "resolution_level": 3  // Использовать низкую точность
}
  1. Ограничить использование памяти:
{
  "min_avali_memory_size": 12.0  // Ограничить до 12GB
}
  1. Уменьшить форматы вывода:
{
  "generate_obj": true,
  "generate_osgb": false,  // Отключить ненужные выходы
  "generate_3d_tiles": false
}

Ошибка: Недостаточно памяти GPU​

Сообщение об ошибке:

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

Причина: Недостаточно памяти GPU.

Решение:

  1. Закройте другие программы, использующие GPU
  2. Снизьте resolution_level
  3. Используйте блочную обработку (для больших проектов)

Проблемы с лицензией​

Ошибка: Недействительная лицензия​

Сообщение об ошибке:

[ERROR] Invalid license: License has expired

Решение:

  1. Проверьте статус лицензии: license_manager.exe -info
  2. Подтвердите правильность системного времени
  3. Повторно активируйте лицензию
  4. Обратитесь в техподдержку для обновления лицензии

Ошибка: Служба Virbox не запущена​

Сообщение об ошибке:

[ERROR] Virbox service not running

Решение:

Windows：

# Запустить службу
net start "Virbox Service"

# Проверить статус службы
sc query "Virbox Service"

Linux：

# Загрузить драйвер
sudo modprobe virbox

# Проверить драйвер
lsmod | grep virbox

Проблемы с результатами вывода​

Проблема: В модели есть дыры​

Возможные причины:

  • Недостаточное перекрытие изображений
  • Области с малой текстурой (водная поверхность, стекло и т.д.)
  • Плохое качество изображения

Решение:

  1. Увеличьте перекрытие изображений до 80%
  2. Используйте наклонную съемку для дополнения боковых видов
  3. Избегайте съемки при сильном свете или в тени
  4. Проверьте и удалите размытые изображения

Проблема: Размытая текстура​

Возможные причины:

  • Исходные изображения размыты
  • Высота полета слишком большая
  • Неправильные настройки камеры

Решение:

  1. Используйте более быструю скорость затвора (≥1/1000s)
  2. Снизьте высоту полета
  3. Используйте камеру с более высоким разрешением
  4. Убедитесь, что фокус камеры правильный

Проблема: Смещение координат​

Возможные причины:

  • Неправильные настройки системы координат
  • Плохая точность GPS
  • Не используются контрольные точки

Решение:

  1. Проверить конфигурацию системы координат:
{
  "coordinate_system": {
    "type": 2,
    "label": "WGS 84",
    "epsg_code": 4326
  }
}
  1. Добавить контрольные точки:
{
  "gcp_path": "gcps.txt",
  "gcp_coor_sys": {
    "type": 3,
    "epsg_code": 32650  // Обеспечить согласованность с реальными
  }
}

🛠️ Расширенная диагностика​

Просмотр подробных логов​

Расположение файла лога: working_dir/log/log.txt

Найти ключевую информацию:

# Просмотр ошибок
grep -i "error" log.txt

# Просмотр предупреждений
grep -i "warning" log.txt

# Просмотр прогресса
grep "PROGRESS" log.txt

Анализ производительности​

Найти метрики производительности в логах:

  • [TIMING] - Потребление времени для каждого этапа
  • [MEMORY] - Использование памяти
  • [GPU] - Использование GPU

Проверка промежуточных результатов​

Проверить промежуточные результаты для локализации проблем:

  1. Результаты AT: working_dir/AT/mvs.xml
  2. Диапазон ROI: working_dir/milestones/roi.json
  3. Отчет о качестве: working_dir/report/report.json

📞 Получение помощи​

Если вышеуказанные решения не могут решить вашу проблему:

  1. Соберите диагностическую информацию:

    • Вывод от запуска task_json_check
    • Полный файл log.txt
    • Файл конфигурации (с удаленными конфиденциальными данными)
    • Информация о системе (конфигурация оборудования)

  2. Отправить проблему:

    • GitHub Issues: [Репозиторий проекта]
    • Email техподдержки: support@mipmap.com
    • Включите вышеуказанную диагностическую информацию

  3. Проверить обновления:

    • Проверьте наличие новой версии
    • Просмотрите журнал изменений версии
    • Следите за списком известных проблем

Постоянно обновляется. Если вы столкнулись с неперечисленными проблемами, обратитесь в техническую поддержку.