bundle_adjust — 3D bundle_adjust op

数据种类:pose × pointstable

调用: import fullseye as fs; fs.ledger.bundle_adjust(cameras, points, obs_cam, obs_pt, obs_uv, K, fix_first=True, max_iter=200)(要直接调用实现,import bundle3d; bundle3d.bundle_adjust(cameras, points, obs_cam, obs_pt, obs_uv, K, fix_first=True, max_iter=200);从台账取用则 ops3d.get("bundle_adjust"))

用法

以重投影误差最小同时优化相机位姿与 3D 点。→ dict{cameras, points, rmse, cost}。

> 以下的详细说明为原文 —— 摘要与标题已翻译。

cameras (nc,6)=[rvec(3)|t(3)] の初期値、points (m,3) の初期値、観測 obs_cam/obs_pt/obs_uv。

fix_first=True で先頭カメラを [I|0] 相当(初期値のまま)に固定し gauge を除く。

scale gauge: 再投影誤差は「カメラ 0 の中心を基準にシーン全体を相似拡大」しても

厳密に変わらないので、それだけでは解の scale が定まらず LM が任意の倍率へ滑る

(実測 ×0.7〜×213、rmse≈0 のまま)。本関数は **構造のカメラ 0 中心からの RMS 距離

(`scale_anchor)を初期値に保つ残差** w·(rms/rms0 − 1)` を 1 本足して固定する。

再投影コストは scale 方向に勾配ゼロなので、この残差は最適解で厳密に 0 になり、

返る scale は初期構造のそれと一致する(基線長 `‖t₁‖` で固定するより、点数で

平均される分だけ初期摂動の影響が小さい)。初期構造が退化(全点がカメラ 0 中心に

一致)していれば拘束は掛けない。返り dict の `scale_anchor` に採用した RMS 距離を載せる。

参考(示例数据・文献)

• 示例数据目录(下载 URL / 许可证) —— 2-D 用 skimage.data(BSD/公有领域)加合成图,3-D 给出真实数据源(Stanford/PDS 等)的下载 URL。

• 算子来历与参考文献 —— 该算子族所依据的研究/方法出处。

可运行的示例(实际调用该算子并已验证的样例)

bundle_adjustpy -3.11 examples_3d/bundle_adjust.py

类型可衔接的下一个算子(可接受 table 作为输入)

fuse_to_voxel · mesh_select_lod

同类别(bundle_adjust)

mean_reprojection_error · project


*Provenance: bundle3d.py — 3D 算子登记表。本条目由 tools/opdocs.py md 自动生成(请勿手工编辑)。*

© 2026 Kazufumi Furuse — Fullseye operator documentation. Licensed under Apache-2.0.