peg_measure_overlay — DRIVE `pegsim` op

• Data kinds: rgb × matrix × matrix → rgb

• Call: import fullseye as fs; fs.ledger.peg_measure_overlay(rgb, truth_uv, est_uv, edge_uv=None, size: 'int' = 12, zoom: 'int' = 3, crop: 'int' = 40) -> 'np.ndarray' (to call the implementation directly, import pegsim; pegsim.peg_measure_overlay(rgb, truth_uv, est_uv, edge_uv=None, size: 'int' = 12, zoom: 'int' = 3, crop: 'int' = 40) -> 'np.ndarray'; from the registry, opsdrive.get("peg_measure_overlay"))

• GPU: yes (mechanical GPU path from the allow-list, CuPy). device="auto" chooses the GPU from the measured size (12,582,912 pixels) up

Usage

Overlay diagram of measurements (numpy only): true value = large green cross, estimate = small red cross, edge points used for circle fitting = yellow dot (imagedraw). At the bottom right, paste an enlargement of 2*crop px square (crop is half width) around the center of gravity of the true value, multiplied by zoom (to visually see the coincidence of subpixels).

rgb is (H, W, 3) uint8; truth_uv and est_uv are (N, 2) (u, v). Returns uint8 of the same size. Raises ValueError: rgb has the wrong shape, no points.

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_pegsim_insertion — py -3.11 examples/poc_pegsim_insertion.py

Ops the type connects to (they accept `rgb` as input)

spin_from_marker_sequence · carla_depth_decode · carla_transform_matrix · carla_pose_to_world · carla_camera_pose · carla_xy_yaw · carla_scene_load · town_chain

Same category (`pegsim`)

peg_params · whitney_clearance · two_point_depth · wedging_check · jamming_diagram · chamfer_capture · contact_state_predict · circle_fit_known_radius

*Provenance: pegsim.py — DRIVE operator registry. This per-op note is generated by tools/opdocs.py md (do not hand-edit).*

peg_measure_overlay — DRIVE pegsim op