OpenDroneMap 无人机影像三维重建：安装部署与实战指南

使用指南

目录结构

需要新建一个项目文件夹，并在里面建立一个 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 将显示实时进度，典型输出包括初始化版本、加载图片数量及特征匹配结果。

高级参数调优

根据项目需求添加参数可显著提升输出质量：

1. 提高重建精度：生成 DSM 并提高正射影像分辨率至 2cm/像素。

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

2. 处理大型数据集：启用分块处理，限制内存使用。

docker run -ti --rm -v ~/datasets:/datasets opendronemap/odm --project-path /datasets/my_project --split 100 --max-concurrency 4

3. 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 文件，右键点击模型→"渲染"→"纹理"启用纹理显示。

常见问题与优化

1. 影像重叠不足：确保前向重叠>70%，旁向>60%。解决方案：重新规划航线或使用 --min-num-features 8000 参数。
2. 内存不足：处理 200 张以上影像需 16GB+ 内存。临时解决方案：--downsample 0.5 降低分辨率。
3. GPS 数据缺失：部分无人机未记录 GPS。解决方案：添加 --no-gps 参数。
4. 影像模糊：运动模糊会导致特征匹配失败，建议控制飞行速度。
5. 光照变化大：拍摄时光照条件不一致，使用 --use-3dmesh-texturing 参数。
6. 磁盘空间不足：单个项目需 5-15GB 空间，清理 odm_texturing 目录可释放临时文件。
7. Docker 权限问题：Linux 用户需加入 docker 用户组，执行 sudo usermod -aG docker $USER。
8. 中文字符路径：所有文件夹和文件名不能包含中文。
9. 相机参数异常：执行 exiftool images/*.jpg 检查焦距信息是否存在。
10. 网络超时：首次运行需下载依赖，建议使用国内镜像或加速服务。