annotate_dimension_layout — ANNOTATE paper op

• Data kinds: कोई नहीं → table (केवल arguments से तय होने वाला op — यह कोई image या data input नहीं लेता)

• Call: import fullseye as fs; fs.ledger.annotate_dimension_layout(p0, p1, offset=20.0, extension=6.0, text_gap=8.0) (implementation को सीधे call करना हो तो import annotate; annotate.annotate_dimension_layout(p0, p1, offset=20.0, extension=6.0, text_gap=8.0), registry से लेना हो तो opsannotate.get("annotate_dimension_layout"))

उपयोग

table (dict) लौटाता है: dimension line की geometry (dimension line, extension line, text position) closed form में तय करता है।

n को p0→p1 का बायाँ normal (screen coordinates) मानकर, dimension line p + n*offset है, extension lines p से p + n*(offset+extension) तक हैं, और text dimension line के मध्यबिंदु से n*text_gap पर है। offset का sign तय करता है कि कौन-सी ओर।

Returns

dict

{"p0","p1","line":(q0,q1),"ext0","ext1","text_xy","normal", "angle_deg","length_px"}।

Raises

ValueError

2 points एक ही हैं (कोई दिशा नहीं), non-finite, offset 0 है।

उपयोग की विस्तृत guide

• figure_annotation family guide

पृष्ठभूमि guides (इस op के पीछे की physics और conventions)

• dataset_conventions — Training dataset के conventions — COCO / YOLO / VOC और visual inspection में सावधानियाँ

संदर्भ (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 के स्रोत।

• Algorithm का मानक स्रोत (लेखक, वर्ष) और उपयोग ऊपर की family usage guide में दिए गए हैं।

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

• paper_figure — py -3.11 examples/paper_figure.py

वे अगले ops जिनसे type जुड़ता है (table को input के रूप में लेते हैं)

—

इसी category के (paper)

annotate_leader_layout · annotate_leader · annotate_markers · annotate_legend · annotate_dimension · annotate_angle_layout · annotate_angle · annotate_scale_bar_layout


*Provenance: annotate.py — ANNOTATE operator registry. यह per-op note tools/opdocs.py md से अपने-आप generate होता है (हाथ से edit न करें)।*

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