geometry op• 資料種類:primitive → measurement
• 呼叫: import fullseye as fs; fs.ledger.distance_line_line(p1, d1, p2, d2)(要直接呼叫實作,import match3d; match3d.distance_line_line(p1, d1, p2, d2);從台帳取用則 ops3d.get("distance_line_line"))
兩直線間距離(含歪斜/skew)。平行時退化為點-線距離。
★這是無限直線之間的距離。用於手腳、機器人連桿、管線之類的有限線段時, 即使彼此分離也可能回傳 0(實測: (0,0,0)-(1,0,0) 與(5,0,0)-(6,0,0) 得 0.0,真值 4.0)。線段之間請使用 distance_segment_segment —— 在安全距離判定中搞混這一點, 會偏向低估危險的一側。
取 n = d̂1 × d̂2,若 |n| < 1e-9(平行)則回傳 distance_point_line(p2, p1, d1),否則回傳 |(p2 − p1)·n̂|(公垂線的長度),型別為 float。相交直線為 0。p1, d1, p2, d2 為數值 2 維或 3 維向量,維度混用則 ValueError。2-D 中不平行的直線必相交,距離應為 0,但 np.cross 會變成純量,導致 @ 失敗(2-D 只有平行的情況能通過)。請在 3-D 中使用。單位為輸入座標的單位。
用途: 2 條軸(fit_line_3d)的同軸度、孔距。
• 範例資料目錄(下載 URL / 授權) —— 2-D 用 skimage.data(BSD/公有領域)加合成圖,3-D 給出真實資料源(Stanford/PDS 等)的下載 URL。
• 運算子來歷與參考文獻 —— 該運算子族所依據的研究/方法出處。
• geometry_metrology — py -3.11 examples_3d/geometry_metrology.py
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_point_line
*Provenance: match3d.py — 3D 運算子登記表。本條目由 tools/opdocs.py md 自動產生(請勿手動編輯)。*
© 2026 Kazufumi Furuse — Fullseye operator documentation. Licensed under Apache-2.0.