line_from_2points — 3D geometry op

• Data kinds: points → primitive

• Call: import fullseye as fs; fs.ledger.line_from_2points(a, b) (implementation को सीधे call करना हो तो import match3d; match3d.line_from_2points(a, b), registry से लेना हो तो ops3d.get("line_from_2points"))

उपयोग

2 points → line (उस पर एक point, unit direction)। 2 coordinates से line तय होती है (2D/3D दोनों में)।

लौटाता है (a, u): a इनपुट का पहला (1) point है (float array), u = (b − a)/|b − a|। arguments संख्यात्मक 2 या 3 vector हैं (अन्य कुछ या आयामों का मिश्रण ValueError देता है)। a == b होने पर दिशा zero vector ही लौटती है (exception नहीं आता; caller की ओर |u| > 0 जाँचें)। निर्देशांकों का क्रम मायने नहीं रखता (इनपुट के क्रम में ही लौटता है), इसलिए (x,y,z) हो या (z,y,x), बस एक-सा होना चाहिए।

आगे: इस (a, u) को distance_point_line / distance_line_line / intersect_line_plane / angle_between_lines को दें। point cloud से रेखा लेनी हो तो fit_line_3d।

संदर्भ (sample data, साहित्य)

• Sample data catalog (DL URL / license) — 2-D के लिए skimage.data (BSD/public) + synthetic, 3-D के लिए real data sources (Stanford/PDS आदि) के DL URL।

• Operators का स्रोत और संदर्भ — इस op family के मूल research/methods के स्रोत।

चलाए जा सकने वाले उदाहरण (verified samples जो सच में यह op call करते हैं)

• geometry_metrology — py -3.11 examples_3d/geometry_metrology.py

वे अगले ops जिनसे type जुड़ता है (primitive को 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

इसी 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. यह per-op note tools/opdocs.py md से अपने-आप generate होता है (हाथ से edit न करें)।*

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