print_quality op• 資料種類:signal → table
• 呼叫: import fullseye as fs; fs.ledger.grade_barcode_profile(profile, symbologies=None, *, quiet_zone_x=None)(要直接呼叫實作,import symgrade; symgrade.grade_barcode_profile(profile, symbologies=None, *, quiet_zone_x=None);從台帳取用則 opssymbol.get("grade_barcode_profile"))
• GPU:無(僅 CPU 參考實作)
回傳一條掃描線(反射率的一維序列)的印刷品質參數與等級(table)。
> 以下的詳細說明為原文 —— 摘要與標題已翻譯。
Grade one scan reflectance profile. The profile must cover the symbol and its quiet zones. Quantities (reflectances in [0, 1]):
• r_max / r_min: highest / lowest reflectance over the profile.
• symbol_contrast SC = r_max − r_min; global threshold GT = r_min + SC / 2.
• elements = runs between GT crossings; a space's reflectance is its maximum, a bar's its minimum; the quiet zones are the outer spaces.
• edge_contrast_min ECmin = min over adjacent element pairs of |Rs − Rb|.
• modulation MOD = ECmin / SC.
• defects = ERNmax / SC, where an element's reflectance non-uniformity ERN is the deepest valley trapped between two higher samples inside a space (or the highest peak trapped inside a bar) — monotone edges contribute nothing.
• decodability = the smallest per-character decode margin returned by the reference decode (barcode1d.decode_barcode_profile at GT): for the edge-to-similar-edge symbologies (EAN/UPC, Code 128) the margin of each similar-edge sum from its decision boundary (half a module), for the two-width ones (Code 39, ITF) the margin of the narrowest wide / widest narrow element from the mid threshold, both scaled to 1 = ideal, 0 = on the boundary.
• decode (bool), quiet_zone_ok (both light zones at least the symbology's quiet zone, or quiet_zone_x X, wide), r_min_ok (Rmin ≤ 0.5 Rmax), edge_contrast_ok (ECmin ≥ 0.15).
Grades 4..0 per parameter (grades), profile_grade = the minimum, and limiting = the parameters at that minimum. A profile that does not decode is graded 0 with decode = False (the other quantities are still reported when the profile has edges).
空の入力(16 標本未満)は ValueError。拒否(ValueError): 1-D でない、非有限、quiet_zone_x が負。平らな走査線(縁が無い)は SC = 0 で profile_grade = 0(読めない、と数える)。
• 範例資料目錄(下載 URL / 授權) —— 2-D 用 skimage.data(BSD/公有領域)加合成圖,3-D 給出真實資料源(Stanford/PDS 等)的下載 URL。
• 運算子來歷與參考文獻 —— 該運算子族所依據的研究/方法出處。
• 演算法的正典(作者、年份)與用途見上面的族使用指南。
• poc_symbol_package_1d — py -3.11 examples/poc_symbol_package_1d.py
table 作為輸入)render_symbol · symbol_read_trials · symbol_read_pod · ocr_classify · ocr_read_line · ocr_read_trials
print_quality)grade_barcode1d · grade_datacode2d
*Provenance: symgrade.py — SYMBOL 運算子登記表。本條目由 tools/opdocs.py md 自動產生(請勿手動編輯)。*
© 2026 Kazufumi Furuse — Fullseye operator documentation. Licensed under Apache-2.0.