fullseye

line_from_2points — 3D geometry op

• データ種: points → primitive
• 呼び出し: import fullseye as fs; fs.ledger.line_from_2points(a, b) (実装を直接呼ぶなら import match3d; match3d.line_from_2points(a, b)、台帳から引くなら ops3d.get("line_from_2points"))

使い方

2 点 → 直線(通過点, 単位方向)。2 座標で線が定まる(2D/3D 共通)。

返り値 (a, u): a は入力の 1 点目(float 配列)、u = (b − a)/|b − a|。引数は数値の 2 または 3 ベクトル(それ以外・次元の混在は ValueError)。a == b のときは方向が零ベクトルの まま返る(例外は出ない。呼び手で |u| > 0 を確かめる)。座標の並び順は問わない(入力の 順のまま返る)ので、(x,y,z) でも (z,y,x) でも一貫していればよい。 後段: distance_point_line / distance_line_line / intersect_line_plane / angle_between_lines にこの (a, u) を渡す。点群から直線を取るなら fit_line_3d。

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

• サンプルデータ カタログ(DL URL / ライセンス) — 2-D は skimage.data(BSD/public)+ 合成、3-D は実データ源(Stanford/PDS 等)の DL URL。
• 演算子の来歴・参考文献 — この op 族の元になった研究/手法の出典。

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

• geometry_metrology — py -3.11 examples_3d/geometry_metrology.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

同カテゴリ(geometry)

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

---

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

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

This site is open source. Improve this page.