line_from_2points — 3D geometry op

Data kinds: pointsprimitive

Call: import fullseye as fs; fs.ledger.line_from_2points(a, b) (to call the implementation directly, import match3d; match3d.line_from_2points(a, b); from the registry, ops3d.get("line_from_2points"))

Usage

Two points → a line (a point on it and a unit direction). Two coordinates fix the line (2-D and 3-D alike).

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

返り値 `(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`。

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_metrologypy -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)

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. This per-op note is generated by tools/opdocs.py md (do not hand-edit).*

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