ransac_plane — 3D robust_fit op

データ種: pointsprimitive

呼び出し: import fullseye as fs; fs.ledger.ransac_plane(points, thresh, iters=500, seed=0) (実装を直接呼ぶなら import ransac_fit; ransac_fit.ransac_plane(points, thresh, iters=500, seed=0)、台帳から引くなら ops3d.get("ransac_plane"))

使い方

外れ値に頑健な RANSAC 平面適合。

3 点をサンプル → 平面法線(2 辺の外積)→ 点-平面距離 |n·(p-p0)| < `thresh` の

inlier を最大化 → 最終 inlier で最小二乗リフィット(法線=共分散の最小主軸)。

Args:

points: (N,3) 点群。

thresh: inlier とみなす点-平面距離のしきい値。

iters: RANSAC 反復数。

seed: 乱数シード(決定論)。

Returns:

(params, inlier_mask, info)。params = {"normal": (3,), "d": float, "point": (3,)}

で平面は `normal·x + d = 0`。inlier_mask=(N,) bool。

背景知識ガイド(この op の手前にある物理・規約)

blas_threads_and_memory — 行列分解が遅い理由の知識 — BLAS スレッド・キャッシュ・メモリ配置

参考(サンプルデータ・文献)

• サンプルデータ カタログ(DL URL / ライセンス) — 2-D は skimage.data(BSD/public)+ 合成、3-D は実データ源(Stanford/PDS 等)の DL URL。

• 演算子の来歴・参考文献 — この op 族の元になった研究/手法の出典。

実行できる例(この op を実際に呼ぶ検証済みサンプル)

ransac_primpy -3.11 examples_3d/ransac_prim.py

型が繋がる次の op(primitive を入力に取れる)

fuse_to_voxel · angle_between_lines · angle_between_planes · angle_line_plane · distance_point_plane · distance_point_line · distance_line_line · distance_segment_segment

同カテゴリ(robust_fit)

ransac_sphere · ransac_line · ransac_cylinder · fit_cone · fit_torus · fit_ellipsoid


*Provenance: ransac_fit.py — 3D operator registry. この per-op ノートは tools/opdocs.py md が自動生成(手編集しない)。*

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