OpenDroneMap 无人机影像三维重建指南
OpenDroneMap (ODM) 是一套开源的摄影测量软件包，能够利用无人机采集的二维影像生成三维点云、数字表面模型（DSM）及正射影像图。本文档旨在帮助开发者快速搭建环境并完成基础重建流程。
系统运行环境要求
为了保证重建效率，建议配置如下：
- 操作系统：Windows 10/11, macOS 或 Linux (推荐 Ubuntu)。
- CPU：多核心处理器，4 核以上起步，处理 200 张以上影像建议 8 核或更多。
- 内存 (RAM)：至少 16GB，大面积区域建议 32GB 或以上。
- 硬盘空间：原始影像、中间文件和最终成果占用较大，建议预留影像大小 10-20 倍的可用空间。
- 显卡 (GPU)：虽然 ODM 主要依赖 CPU，但拥有支持 CUDA 的 NVIDIA GPU 可显著加速深度图计算等步骤。AMD/Intel 集成显卡也可运行，但速度较慢。
数据准备
数据质量直接决定重建效果，请确保以下几点：
- 照片存储：将所有无人机采集的照片集中存放在一个文件夹中。
- GPS 信息：照片必须包含 EXIF 中的 GPS 经纬度及高度信息，这是自动定位的关键。可通过图片属性查看确认。
- 拍摄设置：建议使用一致的分辨率、焦距和光圈。重叠率建议航向 70%-80%，旁向 60%-70%。
- 图像质量：清理掉模糊、过曝或完全遮挡的照片。若没有自有数据，可参考官方示例数据集进行测试。
部署方式
Docker 安装（推荐）
使用 Docker 容器化部署可以避免复杂的依赖配置问题。
1. 安装 Docker Desktop
- Windows：访问官网下载安装程序，启用 "使用 WSL 2 而不是 Hyper-V" 选项，启动后等待托盘图标显示运行状态。
- macOS：使用 Homebrew 安装
brew install --cask docker，并在系统偏好设置中允许开发者权限。 - Linux：以 Ubuntu 为例，执行以下命令：
sudo apt-get update
sudo apt-get install docker-ce docker-ce-cli containerd.io
sudo usermod -aG docker $USER
newgrp docker
2. 拉取镜像
验证安装成功后，拉取最新镜像：
docker pull opendronemap/odm:latest
国内用户如遇网络问题，可使用镜像加速服务：
docker pull registry.docker-cn.com/opendronemap/odm
手动安装
如需本地运行，可从 GitHub Releases 下载 exe 文件并双击安装。运行成功后会弹出 ODM Console 窗口。
核心命令解析
基础重建流程
在终端中执行以下命令启动重建。注意挂载本地目录到容器内，以便读写数据。
Linux/Mac 示例：
docker run -ti -- -v ~/datasets:/datasets opendronemap/odm --project-path /datasets/my_project
