按错误信息检索对应条目。每条包含现象、根因与处理方式。
根因:可执行文件不含当前设备可加载的 GPU 内核。常见来源为调用上游 sm_89 构建,或 Path 中旧版本目录优先命中。
处理:
# 确认实际调用的文件
where.exe DensifyPointCloud
# 读取其内嵌架构
.\tools\check_cuda_arch.ps1 (where.exe DensifyPointCloud)CubinArch 为 sm_89 或 - 时,所调用文件非本仓库构建,应移除 Path 中的旧目录,或改用绝对路径调用本分发包中的可执行文件。CubinArch 为 sm_120 而错误仍存在时,检查显示驱动版本是否满足 CUDA 13.x 的要求。
与 A1 同源,处理方式相同。
根因:使用了任务管理器显示的显卡编号。任务管理器将核显编号为 GPU 0、独立显卡编号为 GPU 1,而 CUDA 仅枚举 NVIDIA 设备,独立显卡的 CUDA 编号为 0。
处理:将设备编号固定为 0。
DensifyPointCloud -i scene.mvs -o scene_dense.mvs --cuda-device 0COLMAP 侧对应参数:
--FeatureExtraction.gpu_index 0
--FeatureMatching.gpu_index 0根因:显示驱动版本低于 CUDA 13.x 的最低要求。
处理:将 NVIDIA 驱动升级至 R580 或更新版本。无需安装 CUDA Toolkit。
根因:显存被其它进程占用,SIFT 特征提取或深度图计算申请显存失败,进程直接终止。
处理:
nvidia-smi查看 Used 列。在执行 GPU 阶段前关闭占用显存的进程。12 GB 显存设备处理 3200px、约百张影像时余量有限,与其它图形应用并行运行可能导致失败。
处理,按改动成本由低到高排列:
- 降低分辨率:COLMAP
image_undistorter与 OpenMVS 同时将--max_image_size设为2000 - 分批处理:将影像划分为 2 至 3 组分别重建
- 降低深度图分辨率:
DensifyPointCloud --resolution-level 1
根因:colmap mapper 仅在已存在的目录内写入 0/、1/ 等子目录,不创建上级目录。
处理:
mkdir build\sparse
colmap mapper --output_path build\sparse ...该现象属正常行为。mapper 可能将数据划分为多个子模型。选取点数最多的模型作为后续输入:
Get-ChildItem build\sparse -Recurse -Filter points3D.bin |
Sort-Object Length -Descending | Select-Object -First 1以其父目录作为 image_undistorter --input_path 的取值。
上一个 COLMAP 进程尚未退出。待其结束后重试,或改用其它 --database_path。
根因:InterfaceCOLMAP --image-folder 使用相对路径。OpenMVS 将该路径拼接到 -i 参数所指目录之后,形成重复层级。
处理:使用绝对路径。
InterfaceCOLMAP -i D:\data\build\dense -o D:\data\build\scene.mvs `
--image-folder D:\data\build\dense\images先以 ReconstructMesh --decimate 0.5 降低面数,再执行纹理映射;或在 RefineMesh 中设置 --max-face-area 64。
本构建未启用 viewer 特性,详见 README 第 10 节。模型查看可使用 CloudCompare 或 MeshLab。
根因:OpenMVS 输出的 PLY 为每个顶点附加 view_indices 与 view_weights 两个可变长属性。CloudCompare 的 PLY 解析器不支持可变长属性,解析中断。
处理:
python tools\ply_strip.py scene_dense.ply scene_dense_clean.ply输出固定为 27 字节/顶点(坐标 12 字节、颜色 3 字节、法向量 12 字节),体积约为原始文件的 43%。
输入文件不符合 OpenMVS 的输出格式(例如为 ASCII PLY,或由其它软件导出)。该工具仅处理 binary_little_endian 且每个顶点在 xyz 之后紧跟两个可变长属性的文件。
OpenMVS 的部分路径处理代码对非 ASCII 路径支持不完善。将工程置于纯 ASCII、无空格目录下可避免此类问题。
这些工具为命令行程序,无图形界面。应在 PowerShell 或命令提示符中调用。
安装 Microsoft Visual C++ 2015-2022 Redistributable (x64):https://aka.ms/vs/17/release/vc_redist.x64.exe
静态链接的未签名可执行文件常触发启发式判定。源码与构建配方完整收录于 source/,可自行编译比对。