OpenDroneMap (ODM) 无人机影像三维模型重建安装与使用指南
1. 文档概述
本文档指导用户从零开始，使用 OpenDroneMap (ODM) 对无人机采集的影像数据进行处理，生成三维点云、数字表面模型 (DSM)、正射影像图 (Orthomosaic) 等成果。
预期读者为拥有无人机航拍影像 (JPG/PNG 格式) 并希望进行三维建模的用户。
2. 系统运行环境要求
- 操作系统：Windows 10/11, macOS, 或 Linux (推荐 Ubuntu)。
- CPU：多核心处理器（4 核以上推荐，8 核或更多更佳）。
- 内存 (RAM)：至少 16GB，处理大面积区域建议 32GB 或以上。
- 硬盘空间：预留充足的存储空间。原始影像、中间文件和最终成果会占用大量空间。建议准备影像大小的 10-20 倍的可用空间。
- 显卡 (GPU)：虽然 ODM 主要依赖 CPU，但拥有支持 CUDA 的 NVIDIA GPU 可以显著加速某些步骤（如深度图计算）。AMD/Intel 集成显卡也可运行，但速度较慢。
3. 数据准备
- 将无人机采集的所有照片集中存放在一个文件夹中。
- 确保照片包含 GPS 信息（EXIF 中的 GPS Latitude, GPS Longitude, GPS Altitude）。这是自动定位的关键。
- 建议使用一致的拍摄设置（分辨率、焦距、光圈），重叠率建议：航向重叠 70%-80%，旁向重叠 60%-70%。
- 清理掉模糊、过曝或完全遮挡的照片。
- 如果没有数据，可以参考官方提供的数据示例：比如使用 aukerman 数据。
4. ODM 安装部署
4.1 手动安装（推荐）
下载地址：https://github.com/OpenDroneMap/ODM/releases
下载 exe 文件，双击安装运行，运行成功后出现 ODM Console 弹窗。
4.2 Docker 安装指南
ODM 推荐使用 Docker 容器化部署，避免复杂的依赖配置。
4.2.1 Windows 系统
- 访问 Docker Desktop 官网下载安装程序。
- 双击安装文件，启用'使用 WSL 2 而不是 Hyper-V'选项。
- 安装完成后启动 Docker，等待系统托盘图标显示'Docker Desktop running'。
4.2.2 macOS 系统
使用 Homebrew 安装：brew install --cask docker
从应用程序文件夹启动 Docker。首次运行需在系统偏好设置→安全性与隐私中允许开发者权限。
4.2.3 Linux 系统
sudo apt-get update
sudo apt-get install docker-ce docker-ce-cli containerd.io
sudo usermod -aG docker $USER
newgrp docker
4.2.4 镜像包拉取
验证 Docker 是否安装成功：docker --version
拉取 odm 镜像：docker pull opendronemap/odm:latest
中国用户可使用镜像加速服务：docker pull registry.docker-cn.com/opendronemap/odm
5. 系统使用说明
5.1 航拍照片处理
需要新建一个文件夹，并在里面建立一个 images 文件夹（存放要拼接的图片），图片需要自带 GPS 信息。（如果没有 GPS 信息，则需要用 geo.txt 文件存放图片的 GPS 信息）。
