yeicor/colmap-openmvs

colmap-openmvs

一款稳定、可用于生产环境的摄影测量管道镜像，整合了https://github.com/colmap/colmap%E4%B8%8Ehttps://github.com/cdcseacave/openMVS%E5%B7%A5%E5%85%B7%EF%BC%8C%E9%80%9A%E8%BF%87%E5%AE%B9%E5%99%A8%E5%8C%96%E5%AE%9E%E7%8E%B0%E9%AB%98%E5%8F%AF%E5%A4%8D%E7%8E%B0%E6%80%A7%E5%92%8C%E6%98%93%E7%94%A8%E6%80%A7%E3%80%82%E6%94%AF%E6%8C%81%E7%BA%AFCPU%E5%8F%8ACUDA%E5%8A%A0%E9%80%9F%E4%B8%A4%E7%A7%8D%E7%8E%AF%E5%A2%83%EF%BC%9A%E5%8F%AF%E5%9C%A8%E4%BB%BB%E6%84%8F%E8%AE%BE%E5%A4%87%E8%BF%90%E8%A1%8C%E5%AE%8C%E6%95%B4%E6%B5%81%E7%A8%8B%EF%BC%8C%E6%88%96%E5%88%A9%E7%94%A8GPU%E5%8A%A0%E9%80%9F%E6%8F%90%E5%8D%87%E5%A4%84%E7%90%86%E9%80%9F%E5%BA%A6%E3%80%82

核心功能

• 端到端摄影测量：从无序图片到纹理3D网格的全自动化流程。
• CPU与CUDA双支持：纯CPU模式兼容无GPU服务器，CUDA模式可处理更大尺寸图片并提升速度，两者均为优先支持场景。
• 最新开发版本：通过自动化测试构建，持续保持版本更新。
• 容器化部署：单命令即可运行，避免依赖冲突问题。
• 智能缓存：仅在输入变化时重新执行对应步骤。
• 详细日志与干运行：支持调试查看每一步流程，或模拟运行无需实际执行。
• 用户权限映射：使用-u $(id -u):$(id -g)确保输出文件权限正确。
• 全面帮助文档：通过--help获取所有内置工具及配置选项的详细信息。

使用场景

• 文物数字化保存与三维展示
• 建筑结构三维建模与分析
• 地形场景重建与可视化
• 虚拟场景创建与游戏资产生成

配置与使用说明

1. 准备图片数据

将图片放置在数据目录下的images子文件夹中：

/你的数据路径/
  images/
    img1.jpg
    img2.jpg
    ...

2. （可选）自定义配置

在数据目录下创建config.sh文件，可覆盖环境变量以微调流程。
查看所有可用配置选项：

sh
docker run --rm -it yeicor/colmap-openmvs:cpu-latest --help

3. 运行Docker镜像

纯CPU模式（兼容所有系统）

sh
docker run --rm -it -u $(id -u):$(id -g) \
  -v /你的数据路径:/data \
  yeicor/colmap-openmvs:cpu-latest /data

CUDA加速模式（需NVIDIA GPU及驱动）

sh
docker run --rm -it --gpus all -u $(id -u):$(id -g) \
  -v /你的数据路径:/data \
  yeicor/colmap-openmvs:cuda-latest /data

开始你的三维重建之旅吧！