symbol_read_pod — SYMBOL read_pod op

• 데이터 종류: table → table

• 호출: import fullseye as fs; fs.ledger.symbol_read_pod(trials_table, *, link='logit', level=0.95)(구현을 직접 호출하려면 import symbolpod; symbolpod.symbol_read_pod(trials_table, *, link='logit', level=0.95), 원장에서 가져오려면 opssymbol.get("symbol_read_pod"))

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

사용법

판독 시행 표에서 POD(적중 = 참 문자열을 읽음)와 오독의 상한을 반환한다(table).

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

Fit the hit/miss POD (pod.pod_hitmiss_fit) to a table from symbol_read_trials. When the factor is worse when larger (defocus, noise …) the fit runs on x = −level so that POD rises with x, and the answers are mapped back: level90 = the degradation read with 90 % probability, level90_95 = its conservative bound at level confidence (a *smaller* degradation), level50 likewise. When the factor is better when larger (module size, contrast, full well) level90_95 is the *larger* value.

method = "hitmiss_glm" then. ★When the outcome is decided by the level (complete separation — every capture read up to one level and none beyond), the slope is not estimable; the op then returns method = "all_success_demonstration": the most severe level at which every trial read (separation_bracket = that level and the first one with a failure), and level90_95 = that level only if it holds at least pod.trials_for_all_success (0.90, level) trials (29 at 95 %), else None. level50 / level90 are None in that case.

★monotone is False when a more degraded level reads more often than a milder one by more than 3 standard errors (nonmonotone_z): the POD models assume monotone degradation, so the fitted numbers are then outside their premise (seen with a reader that cannot read sharp dot-peen marks but reads them once blur merges the dots). The result is still returned, flagged.

Also returns per_level (level, n, hits, misreads, noreads, read_rate), misread_total / decoded_total and misread_rate_upper (one-sided Clopper-Pearson upper bound of misreads per decode at level; with zero misreads in n decodes it is 1 − (1 − level)^(1/n)), fit (the POD table) and factor.

空の入力(0 行)は ValueError。拒否(ValueError): 列の欠け、全部読めた/全部読めない、level が (0, 1) の外。完全分離は拒否せず上の「全数成功の実証」で返す(傾きの無い POD を作らない)。

자세한 사용 가이드

• symbol_reading 패밀리 가이드

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

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

• 연산자의 내력·참고문헌 —— 이 연산자 족의 바탕이 된 연구/기법의 출처.

• 알고리즘의 정전(저자·연도)과 용도는 위의 패밀리 사용 가이드에 적혀 있습니다.

실행 가능한 예제(이 연산자를 실제로 호출하는 검증된 샘플)

• poc_symbol_lot_ocr — py -3.11 examples/poc_symbol_lot_ocr.py

• poc_symbol_package_1d — py -3.11 examples/poc_symbol_package_1d.py

• poc_symbol_part_dpm — py -3.11 examples/poc_symbol_part_dpm.py

타입이 이어지는 다음 연산자(table 를 입력으로 받는 것)

render_symbol · symbol_read_trials · ocr_classify · ocr_read_line · ocr_read_trials

같은 카테고리(read_pod)

symbol_read · symbol_read_trials


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

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