grade_barcode1d — SYMBOL print_quality op

• Data kinds: image2d → table

• Call: import fullseye as fs; fs.ledger.grade_barcode1d(image, symbologies=None, *, n_scans=10, aperture_x=0.5, angle_deg=None, expected_text=None) (implementation को सीधे call करना हो तो import symgrade; symgrade.grade_barcode1d(image, symbologies=None, *, n_scans=10, aperture_x=0.5, angle_deg=None, expected_text=None), registry से लेना हो तो opssymbol.get("grade_barcode1d"))

• GPU: नहीं (केवल CPU reference implementation)

उपयोग

image में 1-D symbol का print-quality grade (n_scans scan lines का औसत) लौटाता है (table)।

> नीचे का विस्तृत विवरण मूल text में है — सारांश और headings का अनुवाद हो चुका है।

Grade a 1-D symbol in a reflectance image: read it (barcode1d.read_barcode1d) to find the bar direction and the module width X, filter the image with a circular measuring aperture of aperture_x · X diameter (default 0.5 X), take n_scans profiles evenly over 10 %..90 % of the bar height and grade each (grade_barcode_profile). symbol_grade = mean of the profile grades (0..4), letter its letter; parameters = per-parameter lists over the scans and parameter_grade_mean their mean grades; limiting = the parameters that most often set a profile's grade. With expected_text a profile that decodes to a different string is graded 0 (misread counts them) — a misread is worse than a no-read.

限界 / limits: 開口は円(画素で積分)、反射率は画像の値そのまま。走査線は画像の端まで伸ばし、各走査線で読めたシンボルの両側の静寂域 + 1 X だけを評価に使う。

空の入力は ValueError。拒否(ValueError): 2-D でない、非有限、n_scans < 1、aperture_x が [0, 2] の外。シンボルが見つからなければ barcode1d.Barcode1DError。

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

• symbol_reading family guide

संदर्भ (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 करते हैं)

• poc_symbol_package_1d — py -3.11 examples/poc_symbol_package_1d.py

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

render_symbol · symbol_read_trials · symbol_read_pod · ocr_classify · ocr_read_line · ocr_read_trials

इसी category के (print_quality)

grade_barcode_profile · grade_datacode2d


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

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