fit_plane_3d — 3D `geometry` op

• Data kinds: points → primitive

• Call: import fullseye as fs; fs.ledger.fit_plane_3d(points) (to call the implementation directly, import match3d; match3d.fit_plane_3d(points); from the registry, ops3d.get("fit_plane_3d"))

Usage

Point set → a least-squares plane (through the centroid, normal = the smallest principal axis, plus the RMS residual). Returns (point, normal, resid).

> The detailed description below is the original text — the summary and the headings are translated.

`(N,3) の点群(列数 3 でない・3 点未満は ValueError)の重心 c` と散布行列の最小固有値の

固有ベクトルを法線にする(直交距離の二乗和を最小化。`resid = sqrt(λ_min/N)` = 面からの直交

距離の RMS)。`normal` は単位ベクトルで 符号は任意(外向きにするなら視点や重心との関係で

反転する)。3 点なら厳密に通る面で resid=0(BLAS の負の丸めは 0 に clamp)。

点が直線状(2 番目の固有値も 0)だと法線は不定。外れ値に弱い(`ransac_plane` /

`plane_segmentation` で先にインライアを取る)。3-D 専用。

後段: `distance_point_plane / angle_between_planes / intersect_planes`、高さ場の

平面度なら `surface_form_error(degree=1)`。

References (sample data, literature)

• Sample-data catalog (download URLs / licences) — 2-D uses skimage.data (BSD/public domain) plus synthetic images; 3-D lists download URLs for real data sources (Stanford, PDS, …).

• Operator provenance and references — the sources of the research/methods this op family came from.

Runnable examples (verified samples that actually call this op)

• geometry_metrology — py -3.11 examples_3d/geometry_metrology.py

Ops the type connects to (they accept `primitive` as input)

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

Same category (`geometry`)

line_from_2points · plane_from_3points · angle_3points · angle_between_lines · angle_between_planes · angle_line_plane · distance_point_plane · distance_point_line

*Provenance: match3d.py — 3D operator registry. This per-op note is generated by tools/opdocs.py md (do not hand-edit).*

fit_plane_3d — 3D geometry op