概述
本文档指导用户从零开始，使用 OpenDroneMap (ODM) 对无人机采集的影像数据进行处理，生成三维点云、数字表面模型（DSM）及正射影像图（Orthomosaic）。适合拥有无人机航拍影像并希望进行三维建模的用户。
系统运行环境要求
ODM 的计算密集型特性对硬件有一定要求，建议配置如下：
- 操作系统：Windows 10/11, macOS, 或 Linux (推荐 Ubuntu)。
- CPU：多核心处理器（4 核以上推荐，8 核或更多更佳）。
- 内存 (RAM)：至少 16GB，处理大面积区域建议 32GB 或以上。
- 硬盘空间：预留充足的存储空间。原始影像、中间文件和最终成果会占用大量空间。建议准备影像大小的 10-20 倍的可用空间。
- 显卡 (GPU)：虽然 ODM 主要依赖 CPU，但拥有支持 CUDA 的 NVIDIA GPU 可以显著加速某些步骤（如深度图计算）。AMD/Intel 集成显卡也可运行，但速度较慢。
数据准备
在开始之前，请确保照片满足以下要求：
- 集中存放：将无人机采集的所有照片集中存放在一个文件夹中。
- GPS 信息：确保照片包含 GPS 信息（EXIF 中的 GPS Latitude, Longitude, Altitude）。这是自动定位的关键。检查方式：右键图片查看属性。
- 拍摄设置：建议使用一致的拍摄设置（分辨率、焦距、光圈）。
- 重叠率：航向重叠建议 70%-80%，旁向重叠建议 60%-70%。
- 图像质量：清理掉模糊、过曝或完全遮挡的照片。
如果没有测试数据，可以参考官方提供的示例数据集。
安装部署
ODM 推荐使用 Docker 容器化部署，避免复杂的依赖配置。以下是各操作系统的安装步骤。
手动安装
从 GitHub 发布页下载 exe 文件，双击安装运行。运行成功后会出现 ODM Console 弹窗。
Docker 安装指南
Windows 系统
- 访问 Docker Desktop 官网下载安装程序。
- 启用"使用 WSL 2 而不是 Hyper-V"选项。
- 启动 Docker，等待系统托盘图标显示"Docker Desktop running"。
macOS 系统
使用 Homebrew 安装：brew install --cask docker
从应用程序文件夹启动 Docker。首次运行需在系统偏好设置→安全性与隐私中允许开发者权限。
Linux 系统
# Ubuntu/Debian 示例
sudo apt-get update
sudo apt-get install docker-ce docker-ce-cli containerd.io
sudo usermod -aG docker $USER
newgrp docker
镜像拉取
验证 Docker 是否安装成功：
docker --version
拉取 odm 镜像：
docker pull opendronemap/odm:latest
中国用户可使用镜像加速服务：
docker pull registry.docker-cn.com/opendronemap/odm
使用指南
目录结构
需要新建一个项目文件夹，并在里面建立一个 images 文件夹（存放要拼接的图片）。图片需自带 GPS 信息，若无 GPS 信息，则需准备 gps.txt 文件存放坐标信息。
执行命令
手动安装版本
在 ODM Console 弹窗中输入命令。例如：
run --feature-type=sift --matcher-type=flann --skip-3dmodel D:\\odm\\_test
其中最后面为存放照片的文件夹路径。等待执行完毕，出现"ODM app finished"提示即表示运行完成。
Docker 版本
在终端中执行以下命令启动基础重建流程：
Linux/Mac 示例：
docker run -ti --rm -v ~/datasets:/datasets opendronemap/odm --project-path /datasets/my_project
Windows 示例：
docker run -ti --rm -v c:/datasets:/datasets opendronemap/odm --project-path /datasets/my_project
参数解析：
-ti：启用交互式终端。--rm：处理完成后自动删除容器。-v：挂载本地目录到容器内（格式：本地路径：容器路径）。--project-path：指定项目根目录。
执行后，ODM 将显示实时进度，典型输出包括初始化版本、加载图片数量及特征匹配结果。
高级参数调优
根据项目需求添加参数可显著提升输出质量：
- 提高重建精度：生成 DSM 并提高正射影像分辨率至 2cm/像素。
docker run -ti --rm -v ~/datasets:/datasets opendronemap/odm --project-path /datasets/my_project --dsm --orthophoto-resolution 2
- 处理大型数据集：启用分块处理，限制内存使用。
docker run -ti --rm -v ~/datasets:/datasets opendronemap/odm --project-path /datasets/my_project --split 100 --max-concurrency 4
- GPU 加速：需 NVIDIA 显卡，使用 GPU 加速特征提取。
docker run -ti --rm -v ~/datasets:/datasets --gpus all opendronemap/odm:gpu --project-path /datasets/my_project --use-gpu
完整参数列表可通过 docker run opendronemap/odm --help 查看。
结果查看
正射影像与 DEM
使用 QGIS 查看。启动后点击"图层"→"添加图层"→"添加光栅图层"，选择 odm_orthophoto.tif 文件，QGIS 会自动识别地理坐标。
点云分析
使用 CloudCompare。打开软件后拖拽 odm_georeferenced_model.laz 文件到窗口。使用快捷键 W 切换线框/实体显示，E 调整点大小，Ctrl+F 启用颜色映射按高程着色。
三维模型查看
使用 MeshLab。打开 odm_textured_model.obj 文件，右键点击模型→"渲染"→"纹理"启用纹理显示。
常见问题与优化
- 影像重叠不足：确保前向重叠>70%，旁向>60%。解决方案：重新规划航线或使用
--min-num-features 8000参数。 - 内存不足：处理 200 张以上影像需 16GB+ 内存。临时解决方案：
--downsample 0.5降低分辨率。 - GPS 数据缺失：部分无人机未记录 GPS。解决方案：添加
--no-gps参数。 - 影像模糊：运动模糊会导致特征匹配失败，建议控制飞行速度。
- 光照变化大：拍摄时光照条件不一致，使用
--use-3dmesh-texturing参数。 - 磁盘空间不足：单个项目需 5-15GB 空间，清理
odm_texturing目录可释放临时文件。 - Docker 权限问题：Linux 用户需加入 docker 用户组，执行
sudo usermod -aG docker $USER。 - 中文字符路径：所有文件夹和文件名不能包含中文。
- 相机参数异常：执行
exiftool images/*.jpg检查焦距信息是否存在。 - 网络超时：首次运行需下载依赖，建议使用国内镜像或加速服务。
