project — 3D bundle_adjust op

資料種類:pointskeypoints

呼叫: import fullseye as fs; fs.ledger.project(points, rvec, t, K)(要直接呼叫實作,import bundle3d; bundle3d.project(points, rvec, t, K);從台帳取用則 ops3d.get("project"))

用法

用相機 (rvec,t,K) 把 3D 點 (n,3) 投影到 2D (n,2)(透視除法)。

> 以下的詳細說明為原文 —— 摘要與標題已翻譯。

`X_cam = R(rvec) @ X + tx = K @ X_camuv = x[:2] / x[2]` を全点まとめて計算する

(`project_points と同じ規約)。rvec` は回転ベクトル(軸 × 角 [rad]、scipy の

`Rotation.from_rotvec)、t は (3,) 並進、K` は (3,3) 内部行列。返り値は (n,2) float で

列 0 が u(横・列方向)、列 1 が v(縦・行方向)、単位は K に従いピクセル。

注意(検証なし): カメラ後方や像平面上の点(`Z_cam <= 0`)を弾かず、そのまま除算する。

`Z_cam = 0` は 0 割で inf/NaN、負の Z は画像内に見える偽の座標になるので、可視性の判定は

呼び出し側で行う。形状の検証もしない(`np.asarray` で float 化するのみ)。

`bundle_adjust / mean_reprojection_error` の再投影残差はこの関数で作られる。

參考(範例資料・文獻)

• 範例資料目錄(下載 URL / 授權) —— 2-D 用 skimage.data(BSD/公有領域)加合成圖,3-D 給出真實資料源(Stanford/PDS 等)的下載 URL。

• 運算子來歷與參考文獻 —— 該運算子族所依據的研究/方法出處。

可執行的範例(實際呼叫該運算子並已驗證的樣例)

bundle_adjustpy -3.11 examples_3d/bundle_adjust.py

型別可銜接的下一個運算子(可接受 keypoints 作為輸入)

fuse_to_voxel · dlt_pose · pnp_ransac · reprojection_error

同類別(bundle_adjust)

bundle_adjust · mean_reprojection_error


*Provenance: bundle3d.py — 3D 運算子登記表。本條目由 tools/opdocs.py md 自動產生(請勿手動編輯)。*

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