nice_ticks — ANNOTATE plot op

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

• Call: import fullseye as fs; fs.ledger.nice_ticks(lo, hi, n=5, scale='linear') (implementation को सीधे call करना हो तो import annotate; annotate.nice_ticks(lo, hi, n=5, scale='linear'), registry से लेना हो तो opsannotate.get("nice_ticks"))

उपयोग

[lo, hi] को ढकने वाले "गोल" tick मान (1/2/5 × 10^k, closed form)।

सिरे शामिल किए जाते हैं (यदि lo या hi ठीक tick पर पड़े, तो वह हमेशा दिखता है)। floating-point rounding से 1 सिरा छूट जाने वाली off-by-one से बचने के लिए, जाँच में step*1e-9 की tolerance इस्तेमाल होती है।

scale='log' में 1/2/5 × 10^k के दशमलव ticks (decade steps) लौटाता है (समान अंतराल वाले ticks को log axis पर रखने पर ticks दाईं ओर जाते-जाते दबकर पढ़ने लायक नहीं रहते)।

Raises

ValueError

lo == hi, non-finite, n < 1, log में lo या hi 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 करते हैं)

• annotate_gallery — py -3.11 examples/annotate_gallery.py

• poc_dehazing — py -3.11 examples/poc_dehazing.py

• poc_driving_decisions — py -3.11 examples/poc_driving_decisions.py

• poc_driving_traffic — py -3.11 examples/poc_driving_traffic.py

• poc_measurement_system_analysis — py -3.11 examples/poc_measurement_system_analysis.py

• poc_pxrd_phase_peel — py -3.11 examples/poc_pxrd_phase_peel.py

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

data_to_pixel · plot_series

इसी category के (plot)

axes_transform · data_to_pixel · axes_frame · grid_lines · ticks · plot_series


*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.