OpenDroneMap 无人机影像三维模型重建安装与使用指南

镜像包拉取

验证 Docker 是否安装成功：

docker --version  # 应显示 Docker version 20.10+

拉取 odm 镜像：

docker pull opendronemap/odm:latest

中国用户可使用镜像加速服务：

docker pull registry.docker-cn.com/opendronemap/odm

系统使用说明

航拍照片处理

需要新建一个文件夹，并在里面建立一个 images 文件夹（存放要拼接的图片），图片需要自带 GPS 信息，（如果没有 GPS 信息，则需要用 geo.txt 文件存放图片的 GPS 信息）。

手动安装 ODM 执行（推荐）

在 ODM Console 弹窗中输入 run --feature-type=sift --matcher-type=flann --skip-3dmodel D:\odm\test 运行，其中最后面 D:\odm\test 为存放照片的文件夹路径。

run --feature-type=sift --matcher-type=flann --skip-3dmodel D:\odm\test

等待执行，（24 张照片，大概跑了 10 分钟）出现 ODM app finished 以下页面，则表示运行完毕。

文件夹中，除了准备的 images、geo.txt 和 test.py 准备文件，剩下的都是生成的结果文件，按需选择相应的结果。使用 meshlab 软件查看 ply 文件，可以看到三维模型。

Docker 版本 ODM 执行

基础重建命令详解

在终端中执行以下命令启动基础重建流程：

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：指定项目根目录
• my_project：项目名称（对应 datasets 下的文件夹）

执行命令后，ODM 将显示实时进度，典型输出如下：

[INFO] Initializing ODM 3.1.9 [INFO] Maximum photo dimensions: 5472px [INFO] Loading 120 images [INFO] Found GPS coordinates in EXIF data [INFO] Running OpenSfM reconstruction [INFO] Feature matching complete (12456 features matched)

高级参数调优

根据项目需求添加参数可显著提升输出质量。以下是最常用的优化参数：

提高重建精度

生成数字表面模型 (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 加速特征提取，处理速度提升 2-3 倍：

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)

1. 下载安装 QGIS（国内用户建议使用 OSGeo 中国镜像）。
2. 启动后点击'图层'→'添加图层'→'添加光栅图层'。
3. 选择 odm_orthophoto.tif 文件，QGIS 会自动识别地理坐标并定位。

点云分析（CloudCompare）

1. 安装 CloudCompare。
2. 打开软件后拖拽 odm_georeferenced_model.laz 文件到窗口。
3. 使用快捷键：
   • W：切换线框/实体显示
   • E：调整点大小
   • Ctrl+F：启用颜色映射，按高程着色

三维模型查看（MeshLab）

1. 安装 MeshLab。
2. 打开 odm_textured_model.obj 文件。
3. 右键点击模型→'渲染'→'纹理'启用纹理显示。

常见问题解决与性能优化

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. 网络超时：首次运行需下载依赖，建议使用国内镜像或加速服务。