colmap

环境要求

• Windows、Linux、Unix 或 BSD 操作系统（README 分别提供了对应二进制）
• 若走 Conda 方式，需先安装 Conda 环境
• 若走 Docker 方式，需先安装 Docker
• 若使用 Python 绑定，需具备 Python 环境（并提供 CUDA 版本轮子）
• 使用 AMD GPU 需通过 HIP/ROCm 从源码编译

安装与启动步骤

1. 1选择安装方式

   README 提供预编译二进制、Conda 包、Docker 镜像、Python 绑定四种途径，按自身平台和需求选一种即可。

2. 2下载预编译二进制

   Windows 用户到 GitHub Releases 下载二进制；Linux/Unix/BSD 用户在 repology 页面查找发行版对应打包版本。

3. 3Conda 安装

   已使用 Conda 的用户可直接从 conda-forge 频道安装，这是 README 明确给出的安装命令。

   conda install colmap

   复制

4. 4使用 Docker 镜像

   README 提供预构建镜像，地址为 https://hub.docker.com/r/colmap/colmap，拉取后即可在容器内使用命令行或图形界面。

5. 5安装 Python 绑定

   需要脚本化调用时，从 https://pypi.org/project/pycolmap 获取绑定；CUDA 环境可选用 pycolmap-cuda12。

6. 6从源码编译（可选）

   需要 HIP/ROCm（AMD GPU）支持或自定义构建时，按官方安装文档 https://colmap.github.io/install.html 自行编译。

如何确认成功

README 未给出验证命令；安装完成后启动 COLMAP 程序，或在 Python 中导入 pycolmap 确认可用。

常见问题

注意事项

• COLMAP 采用新 BSD 许可证，可较自由地用于研究与商业项目。
• 使用其中特定算法时，需按源码说明引用原作者，并考虑引用 ceres-solver、poselib、sift-gpu、vlfeat 等第三方依赖。
• COLMAP 同时提供图形界面与命令行界面，本 README 节选未展开具体参数用法，需查阅官网文档。
• README 节选中的 Getting Started 内容被截断，实际使用前建议访问 https://colmap.github.io 获取完整说明。