occupancy_grid — 3D occupancy op

• Data kinds: points → voxel

• Call: import fullseye as fs; fs.ledger.occupancy_grid(points, bounds, res) (implementation को सीधे call करना हो तो import occupancy; occupancy.occupancy_grid(points, bounds, res), registry से लेना हो तो ops3d.get("occupancy_grid"))

उपयोग

point cloud (N,3) → 3-D occupancy voxel grid bool (जिस voxel में point गिरता है वह occupied)।

bounds=((xmin,xmax),(ymin,ymax),(zmin,zmax)) grid द्वारा घेरा गया volume है, और res हर axis पर voxels की संख्या है (scalar = cube res³, या लंबाई 3 का हर axis के लिए)। Voxels half-open intervals [lo+i/res*span, lo+(i+1)/res*span) हैं, और ऊपरी सिरे (frac==1) के points अंतिम voxel में शामिल होते हैं। bounds के बाहर के points छोड़ दिए जाते हैं (उन्हें किनारे की cells पर clamp करने से सीमा पर नकली obstacles जमा हो जाते)। match3d.points_to_voxel जहाँ density (float) बनाता है, वहीं इसकी ख़ासियत यह है कि यह planning के लिए occupancy (bool) बनाता है।

res<=0, (N,3) न होने वाले points, या degenerate bounds पर ValueError उठाता है।

संदर्भ (sample data, साहित्य)

• Sample data catalog (DL URL / license) — 2-D के लिए skimage.data (BSD/public) + synthetic, 3-D के लिए real data sources (Stanford/PDS आदि) के DL URL।

• Operators का स्रोत और संदर्भ — इस op family के मूल research/methods के स्रोत।

चलाए जा सकने वाले उदाहरण (verified samples जो सच में यह op call करते हैं)

• occupancy_esdf — py -3.11 examples_3d/occupancy_esdf.py

वे अगले ops जिनसे type जुड़ता है (voxel को input के रूप में लेते हैं)

voxel_to_mips · voxel_to_mesh · signed_distance_field · to_points · sobel3d · hessian3d · curvature_maps · edt_jfa

इसी category के (occupancy)

esdf · inflate · query_distance


*Provenance: occupancy.py — 3D operator registry. यह per-op note tools/opdocs.py md से अपने-आप generate होता है (हाथ से edit न करें)।*

© 2026 Kazufumi Furuse — Fullseye operator documentation. Licensed under Apache-2.0.