distance_point_line — 3D geometry op

• データ種: points × primitive → measurement

• 呼び出し: import fullseye as fs; fs.ledger.distance_point_line(p, line_pt, d) (実装を直接呼ぶなら import match3d; match3d.distance_point_line(p, line_pt, d)、台帳から引くなら ops3d.get("distance_point_line"))

使い方

点-直線距離。

`w = p − line_pt の、方向 d̂ に直交する成分の長さ |w − (w·d̂)d̂|` を float で返す

(`d は内部で単位化。2-D/3-D 共通)。p, line_pt, d` は数値の 2 または 3 ベクトル、

次元の混在は ValueError。`d が零ベクトルなら |w|` がそのまま返る。単位は入力座標の単位。

用途: `fit_line_3d の軸からの偏心、line_from_2points` の線に対する点群のばらつき

(1 点ずつ)。

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

• サンプルデータ カタログ(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(measurement を入力に取れる)

vol_gaussian_psf · fuse_to_voxel · fresnel_reflectance · snell_angle

同カテゴリ(geometry)

line_from_2points · plane_from_3points · angle_3points · angle_between_lines · angle_between_planes · angle_line_plane · distance_point_plane · 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.