print_quality op• Data kinds: signal → table
• Call: import fullseye as fs; fs.ledger.grade_barcode_profile(profile, symbologies=None, *, quiet_zone_x=None) (to call the implementation directly, import symgrade; symgrade.grade_barcode_profile(profile, symbologies=None, *, quiet_zone_x=None); from the registry, opssymbol.get("grade_barcode_profile"))
• GPU: none (CPU reference implementation only)
Return the print-quality parameters and grades of one scan line (a 1-D reflectance profile) (table).
> The detailed description below is the original text — the summary and the headings are translated.
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(読めない、と数える)。
• Sample-data catalog (download URLs / licences) — 2-D uses skimage.data (BSD/public domain) plus synthetic images; 3-D lists download URLs for real data sources (Stanford, PDS, …).
• Operator provenance and references — the sources of the research/methods this op family came from.
• The canonical algorithm (author, year) and its uses are named in the family usage guide above.
• poc_symbol_package_1d — py -3.11 examples/poc_symbol_package_1d.py
table as input)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 operator registry. This per-op note is generated by tools/opdocs.py md (do not hand-edit).*
© 2026 Kazufumi Furuse — Fullseye operator documentation. Licensed under Apache-2.0.