encode_barcode1d — SYMBOL barcode1d op

• Data kinds: none → table (an op determined by its arguments alone — it takes no image or data input)

• Call: import fullseye as fs; fs.ledger.encode_barcode1d(text, symbology='code128', *, wide_ratio=2.5, check_digit=False, gs1=False) (to call the implementation directly, import barcode1d; barcode1d.encode_barcode1d(text, symbology='code128', *, wide_ratio=2.5, check_digit=False, gs1=False); from the registry, opssymbol.get("encode_barcode1d"))

• GPU: none (CPU reference implementation only)

Usage

Encode a string into the element widths (in modules) of a 1-D bar code (table).

> The detailed description below is the original text — the summary and the headings are translated.

Encode text as a 1-D symbol. Returns a table: symbology, text (the human-readable data, e.g. EAN-13 with its check digit), widths (element widths in modules, first element a bar, quiet zones excluded), quiet (left, right) in modules, n_modules (symbol length without quiet zones), edges (cumulative element boundaries starting at the left quiet-zone edge = 0), values (symbol character values, Code 128 only) and wide_ratio (two-width symbologies).

symbology: "ean13" (12 or 13 digits; the 13th must be the check digit), "upca" (11 or 12 digits), "code128" (ASCII 32..126, automatic code sets B / C; gs1=True puts FNC1 first and maps '\x1d' to FNC1 — GS1-128), "code39" (0-9 A-Z - . space $ / + %, start/stop * added, optional mod-43 check with check_digit=True), "itf" (an even number of digits; check_digit=True appends the GS1 mod-10 check to make the count even). wide_ratio (two-width symbologies) must lie in [2.0, 3.0].

空の入力(text == "")は ValueError(理由: 符号化する中身が無い)。拒否(ValueError): 文字列でない、未知のシンボル体系、字種の外の文字、桁数違い、検査数字の不一致、wide_ratio が [2.0, 3.0] の外。

Detailed usage guide

• symbol_reading family guide

References (sample data, literature)

• 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.

Runnable examples (verified samples that actually call this op)

• poc_symbol_package_1d — py -3.11 examples/poc_symbol_package_1d.py

Ops the type connects to (they accept table as input)

render_symbol · symbol_read_trials · symbol_read_pod · ocr_classify · ocr_read_line · ocr_read_trials

Same category (barcode1d)

ean_check_digit · barcode_scan_profiles · decode_barcode_profile · read_barcode1d


*Provenance: barcode1d.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.