Metashape Python独立模块与桌面版同设置稀疏点云结果不符

我正在自动化转盘物体的摄影测量建模流程，把一个罐子的上下部照片放进同一个Chunk里。用桌面版Metashape按图示设置执行照片对齐后，能得到所有照片对齐的优质稀疏点云；但运行下面的Python代码（参数和桌面版一致）时，仅4张照片对齐，而且相机位置全错。已经确认掩码正确导入，请问问题出在哪里？

maskKeypoints=False
if config["mask_path"]:
    mp = os.path.join(config["mask_path"])
    ext = config["mask_ext"]
    masktemplate = f"{mp}{os.sep}{{filename}}.{ext}"
    chunk.generateMasks(masktemplate,Metashape.MaskingMode.MaskingModeFile)
    maskKeypoints=True
    doc.save()
#match photos/align photos
chunk.matchPhotos(downscale=consts.PhotogrammetryConsts.AlignDownscale["HIGH"],# =1
                   filter_stationary_points=True,
                   reset_matches=True,
                   filter_mask = maskKeypoints,
                   generic_preselection=True,
                   keypoint_limit=40000,
                   tiepoint_limit=0,
                   guided_matching=True)
chunk.alignCameras()
doc.save()

排查方向 #

• 核对下采样常量的实际值：你自定义的consts.PhotogrammetryConsts.AlignDownscale["HIGH"]是否真的等于1？直接替换成downscale=1测试，避免常量映射和桌面版不一致。
• 关闭静止点过滤：转盘拍摄的物体是固定的，filter_stationary_points=True会误过滤掉物体表面的有效匹配点（算法会把这些不动的点当成背景），桌面版大概率没开启这个选项，建议改成False。
• 调整引导匹配设置：引导匹配需要相机有初始位置或有序序列支撑，如果你没给照片设置序列，直接开启可能干扰匹配。试试把guided_matching=False，看是否能改善对齐效果。
• 确认掩码过滤逻辑：虽然掩码已导入，但要确保filter_mask的作用和桌面版一致——比如桌面版是“仅在掩码内检测关键点”还是“忽略掩码区域”？如果你的掩码是遮罩背景，要确认脚本里的设置没有搞反检测区域。
• 检查照片序列/分组：桌面版是否给上下部照片设置了不同序列？脚本默认把所有照片混在一起，可能导致上下部照片间匹配点不足。可以手动给照片划分序列，或者在matchPhotos里启用reference_preselection（如果适用）。

内容的提问来源于stack exchange，提问作者Rokujolady