symbol_read_pod — SYMBOL read_pod op

• Datenarten: table → table

• Aufruf: import fullseye as fs; fs.ledger.symbol_read_pod(trials_table, *, link='logit', level=0.95) (die Implementierung direkt: import symbolpod; symbolpod.symbol_read_pod(trials_table, *, link='logit', level=0.95); aus dem Register: opssymbol.get("symbol_read_pod"))

• GPU: nein (nur CPU-Referenzimplementierung)

Verwendung

Liefert aus einer Tabelle von Leseversuchen die POD (Treffer = wahre Zeichenkette gelesen) und die Fehllese-Obergrenze (table).

> Die ausführliche Beschreibung unten ist der Originaltext — Zusammenfassung und Überschriften sind übersetzt.

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 を作らない)。

Ausführlicher Anwendungsleitfaden

• Leitfaden zur Familie symbol_reading

Referenzen (Beispieldaten, Literatur)

• Katalog der Beispieldaten (Download-URLs / Lizenzen) — 2-D nutzt skimage.data (BSD/Public Domain) plus synthetische Bilder, 3-D nennt Download-URLs echter Datenquellen (Stanford, PDS, …).

• Herkunft und Literatur der Operatoren — die Quellen der Forschung/Verfahren, auf denen diese Operatorfamilie beruht.

• Der kanonische Algorithmus (Autor, Jahr) und seine Anwendungen stehen im Familienleitfaden oben.

Ausführbare Beispiele (verifizierte Samples, die diesen Operator wirklich aufrufen)

• 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

Typkompatible Folge-Operatoren (nehmen table als Eingabe)

render_symbol · symbol_read_trials · ocr_classify · ocr_read_line · ocr_read_trials

Gleiche Kategorie (read_pod)

symbol_read · symbol_read_trials


*Provenance: symbolpod.py — SYMBOL Operator-Registry. Diese Notiz wird von tools/opdocs.py md erzeugt (nicht von Hand bearbeiten).*

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