OpenDroneMap (ODM) — это набор инструментов с открытым исходным кодом для обработки изображений с дронов. ODM преобразует простые двумерные изображения в:

• классифицированные облака точек;
• трёхмерные текстурированные модели;
• ортотрансформированные изображения с географической привязкой;
• цифровые модели рельефа с географической привязкой.

Приложение доступно для Windows, Mac и Linux и работает из командной строки, что делает его идеальным для опытных пользователей, скриптов и интеграции с другим программным обеспечением.

Если вы предпочитаете не вводить команды в оболочке и ищете удобный пользовательский интерфейс, обратите внимание на WebODM.

Быстрый старт

Самый простой способ запустить ODM — через Docker. Чтобы установить Docker, см. docs.docker.com. После установки Docker и проверки его работоспособности вы можете запустить ODM, поместив некоторые изображения (JPEG или TIFF) в папку с именем «images» (например, /datasets/project/images или C:\Users\youruser\datasets\project\images) и просто запустив команду из терминала / командной строки:

# Windows
docker run -ti --rm -v c:/Users/youruser/datasets:/datasets opendronemap/odm --project-path /datasets project

# Mac/Linux
docker run -ti --rm -v /datasets:/datasets opendronemap/odm --project-path /datasets project

Вы можете передать дополнительные параметры, добавив их к команде:

docker run -ti --rm -v /datasets:/datasets opendronemap/odm --project-path /datasets project [--additional --parameters --here]

Например, чтобы создать DSM (--dsm) и увеличить разрешение ортофотоснимка (--orthophoto-resolution 2):

docker run -ti --rm -v /datasets:/datasets opendronemap/odm --project-path /datasets project --dsm --orthophoto-resolution 2

Просмотр результатов

Когда процесс завершится, результаты будут организованы следующим образом: |-- images/ |-- img-1234.jpg |-- ... |-- opensfm/ |-- см. репозиторий mapillary/opensfm для получения дополнительной информации |-- odm_meshing/ |-- odm_mesh.ply # 3D-сетка |-- odm_texturing/ |-- odm_textured_model.obj # Текстурированная сетка |-- odm_textured_model_geo.obj # Географически привязанная текстурированная сетка |-- odm_georeferencing/ |-- odm_georeferenced_model.laz # Облако точек формата LAZ |-- odm_orthophoto/ |-- odm_orthophoto.tif # Ортофото GeoTIFF

Для открытия файлов, созданных в ODM, можно использовать следующее бесплатное программное обеспечение с открытым исходным кодом:

• .tif (GeoTIFF): QGIS;
• .laz (Compressed LAS): CloudCompare;
• .obj (Wavefront OBJ), .ply (Stanford Triangle Format): MeshLab.

Обратите внимание! Открытие файлов .tif, созданных ODM, в таких программах, как Photoshop или GIMP, может не работать (это GeoTIFF, а не обычные TIFF). Вместо этого используйте QGIS.

API

Доступ к ODM можно получить по сети через NodeODM.

Документация

См. http://docs.opendronemap.org для учебных пособий и других руководств.

Форум

У нас есть активное сообщество на форуме (https://community.opendronemap.org/). Вы можете искать там проблемы, которые могут возникнуть у вас с ODM, и задавать вопросы. Мы призываем пользователей ODM участвовать в форуме и общаться с другими пользователями картографирования дронов.

Локальная установка (Ubuntu 16.04)

Вы также можете запустить ODM локально на Ubuntu 16.04 LTS (хотя мы не рекомендуем это делать):

1. Загрузите исходный код отсюда (https://github.com/OpenDroneMap/ODM/archive/master.zip).
2. Запустите bash configure.sh install.
3. Скачайте образец набора данных отсюда (около 550 МБ) и распакуйте его в /datasets/aukerman.
4. Запустите ./run.sh. ### Обновление нативной установки

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

bash configure.sh reinstall

чтобы убедиться, что все зависимые пакеты и модули обновлены.

Сборка из исходного кода

Если вы хотите пересобрать собственный образ Docker (например, если вы изменили исходный код), то в папке ODM можно ввести:

docker build -t my_odm_image --no-cache .

При создании собственного образа Docker, если размер образа важен для вас, следует использовать флаг --squash следующим образом:

docker build --squash -t my_odm_image .

Это позволит очистить промежуточные шаги в процессе сборки Docker, в результате чего получится значительно меньший образ (примерно вдвое меньше).

Для использования флага --squash необходимо включить экспериментальные флаги в Docker. Для этого вставьте следующее в файл /etc/docker/daemon.json:

{
   "experimental": true
}

После этого необходимо перезапустить Docker.

Разработчики

Помогите улучшить наше программное обеспечение! Мы приветствуем вклад каждого, будь то добавление новых функций, повышение скорости, исправление существующих ошибок или добавление поддержки большего количества камер. Ознакомьтесь с нашим кодексом поведения, руководством по внесению вклада и тем, как принимаются решения.

Для пользователей Linux самый простой способ изменить программное обеспечение — убедиться, что установлен Docker, клонировать репозиторий и затем запустить из оболочки:

$ DATA=/path/to/datasets ./start-dev-env.sh

Где /path/to/datasets — это каталог, куда вы можете поместить тестовые наборы данных (он также может указывать на пустой каталог, если у вас нет тестовых наборов данных).

Теперь вы можете вносить изменения в исходный код ODM. Когда вы будете готовы протестировать изменения, вы можете просто вызвать:

(odmdev) [user:/code] master+* ± ./run.sh --project-path /datasets mydataset

Если у вас есть вопросы, присоединяйтесь к чату разработчиков по адресу https://community.opendronemap.org/c/developers-chat/21

1. Старайтесь делать коммиты чистыми и простыми.
2. Отправьте запрос на вытягивание с подробными изменениями и результатами тестов.
3. Получайте удовольствие!