query_distance — 3D occupancy op

Data kinds: sdf × pointssignal

Call: import fullseye as fs; fs.ledger.query_distance(esdf_grid, bounds, res, query_points, mode='trilinear') (to call the implementation directly, import occupancy; occupancy.query_distance(esdf_grid, bounds, res, query_points, mode='trilinear'); from the registry, ops3d.get("query_distance"))

Usage

The ESDF values (M,) at arbitrary world coordinates (M,3) (`mode` = 'trilinear' interpolation or 'nearest').

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

`bounds/res は ESDF を作った格子と同じもの(res` はスカラ = 立方、

または長さ 3 の軸ごとのボクセル数)。world→連続ボクセル座標は

`c=(q-lo)/span*res-0.5`(voxel i の中心が c=i)。三線形補間はボクセル中心 8 近傍を

重み付け(格子外はエッジにクランプ=最近端の値で外挿)。planner がノード/経路上の任意点で

離隔を問い合わせる用途。返り値は ESDF と同じ world 単位。

Raises ValueError for res<=0, degenerate bounds, non-(M,3) query, or unknown mode.

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.

Runnable examples (verified samples that actually call this op)

occupancy_esdfpy -3.11 examples_3d/occupancy_esdf.py

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

fuse_to_voxel

Same category (occupancy)

occupancy_grid · esdf · inflate


*Provenance: occupancy.py — 3D 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.