map_image — MV resample op

• Data kinds: image2d × table → image2d

• Call: import fullseye as fs; fs.ledger.map_image(image, image_map, fill=0.0) (to call the implementation directly, import mvimage; mvimage.map_image(image, image_map, fill=0.0); from the registry, opsmv.get("map_image"))

• HALCON equivalent: map_image (the HALCON reference is a useful guide to its meaning and parameters)

• GPU: none (CPU reference implementation only)

Usage

Resample an image through an inverse map (each output pixel reads an input coordinate).

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

image_map は row_map / col_map の dict(gen_radial_distortion_map の返りをそのまま渡せる)。線形補間で読み、画像の外は fill で埋める。image_map に写像の鍵が無い(x_map / y_map は画素 → ワールドの順写像で、このままでは穴が開く)と ValueError。空の入力(image が 0 要素)は ValueError。

Args:

image: (H, W) の画像。

image_map: row_map と col_map を持つ dict。形が出力の形になる。

fill: 入力の外を読んだ画素の値。

Returns:

image_map と同じ形の float 画像。

Detailed usage guide

• machine_vision_classics 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)

• machine_vision_tour — py -3.11 examples/machine_vision_tour.py

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

binocular_disparity_ms · binocular_distance_ms · reconstruct_surface_stereo · rectify_to_world_plane · change_radial_distortion_image · crop_rectangle2 · atan2_image · area_center_gray

Same category (resample)

rectify_to_world_plane · change_radial_distortion_image · crop_rectangle2


*Provenance: mvimage.py — MV 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.