decode_barcode_profile — SYMBOL barcode1d op

• 데이터 종류: signal → table

• 호출: import fullseye as fs; fs.ledger.decode_barcode_profile(profile, symbologies=None, *, threshold=None, itf_min_length=6)(구현을 직접 호출하려면 import barcode1d; barcode1d.decode_barcode_profile(profile, symbologies=None, *, threshold=None, itf_min_length=6), 원장에서 가져오려면 opssymbol.get("decode_barcode_profile"))

• GPU: 없음(CPU 참조 구현만)

사용법

주사선 1개(반사율의 1차원 열)에서 심볼 하나를 복호한다(table).

> 아래 상세 설명은 원문입니다 —— 요약과 제목은 번역되어 있습니다.

Decode one symbol from a scan reflectance profile (1-D, bars dark). The global threshold is (max + min) / 2 of the profile unless given (the same threshold the print-quality grade uses). Elements come from sub-sample threshold crossings; every run of bar-first elements flanked by light zones at least 5 X wide (X estimated from the candidate itself) is tried with each symbology, in both scan directions. Returns symbology, text, margins (per character decode margin in [0, 1]: 1 = element sums exactly on the module grid, 0 = on the decision boundary), reversed (read right-to-left), x_dim (estimated module width in samples), start / stop (sample positions of the first bar's leading edge and the last bar's trailing edge) and threshold.

限界 / limits: 1 本の走査線に 1 シンボル(最初に一致したもの)。静寂域が 5 X より狭いと探さない。Code 128 の FNC2-4・シフト・コード A の制御文字は読まない。

★ITF は検査数字を持たず、ぼけた他のシンボルの一部が短い ITF に化ける(短読み、short read)。itf_min_length(既定 6 桁)未満の ITF は返さない。実測: EAN-13 をデフォーカスで壊すと、全体系を許した読み取りは 2 桁の ITF などを誤読として返した(tests/test_barcode1d.py)。現場の読み取り器と同じく、symbologies は使う体系だけに絞ること。ITF has no check digit; fragments of a blurred symbol decode as short ITF. ITF reads shorter than itf_min_length are refused; restrict symbologies to what the line uses.

空の入力は ValueError(16 標本未満は「シンボルを含めない」)。拒否(ValueError): 1-D でない、非有限、未知の体系名。どの体系とも一致しなければ Barcode1DError(ValueError の派生)—— 誤読より読み取り不能を選ぶ (検査数字・開始停止・ガードの照合を全部通ったものだけ返す)。

자세한 사용 가이드

• symbol_reading 패밀리 가이드

참고(샘플 데이터·문헌)

• 샘플 데이터 카탈로그(DL URL / 라이선스) —— 2-D 는 skimage.data(BSD/public)+ 합성, 3-D 는 실데이터 소스(Stanford/PDS 등)의 DL 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

같은 카테고리(barcode1d)

encode_barcode1d · ean_check_digit · barcode_scan_profiles · read_barcode1d


*Provenance: barcode1d.py — SYMBOL 연산자 레지스트리. 이 op 노트는 tools/opdocs.py md 가 자동 생성합니다(직접 편집하지 마세요).*

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