translate_measure — MEASURE1D caliper op

• Data kinds: measurehandle → measurehandle

• Call: import fullseye as fs; fs.ledger.translate_measure(measure, drow, dcol) (to call the implementation directly, import measuring1d; measuring1d.translate_measure(measure, drow, dcol); from the registry, opsmeasure1d.get("translate_measure"))

Usage

Translates a measurement object (translate_measure).

Returns a shallow copy with (drow, dcol) [px] added to rows / cols (the input dict is not changed). origin of gen_measure_rectangle2 and center of gen_measure_arc are moved by the same amount, so the geometry of the extension at both ends (_extended_coords) does not shift. phi / dir / angles / radius / width / spacing stay as they are -- no rotation or radius change.

• measure: dict from gen_measure_rectangle2 / gen_measure_arc. It also works with any dict that has rows / cols (other keys pass through).

• drow, dcol: displacement [px]. Fractions allowed.

• shape (image size) is not rechecked, so moving outside the image raises no exception; measure_pos just extrapolates with the edge values.

• Returns: a dict of the same structure (type measurehandle).

Typical use: apply the workpiece offset obtained by registration to the measuring line, then run measure_pos / measure_pairs. If the tilt changes, rebuild gen_measure_rectangle2 with the new phi.

Detailed usage guide

• subpixel_measuring 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_dimensional_inspection — py -3.11 examples/poc_dimensional_inspection.py

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

measure_pos · measure_pairs · fuzzy_measure_pairing

Same category (caliper)

gen_measure_rectangle2 · gen_measure_arc · measure_pos · measure_pairs · fuzzy_measure_pairing


*Provenance: measuring1d.py — MEASURE1D 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.