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 族使用指南

参考(示例数据、文献)

• 示例数据目录(下载 URL / 许可证) —— 2-D 用 skimage.data(BSD/公有领域)加合成图,3-D 给出真实数据源(Stanford/PDS 等)的下载 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 算子登记表。本条目由 tools/opdocs.py md 自动生成(请勿手工编辑)。*

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