foothold_candidates — DRIVE walkterrain op

• Data kinds: depth → table

• Call: import fullseye as fs; fs.ledger.foothold_candidates(grid, cell: 'float' = 0.05, window: 'int' = 3, min_score: 'float' = 0.6, min_dist: 'float' = 0.15, max_n: 'int' = 50, extent=None) (implementation को सीधे call करना हो तो import terrain; terrain.foothold_candidates(grid, cell: 'float' = 0.05, window: 'int' = 3, min_score: 'float' = 0.6, min_dist: 'float' = 0.15, max_n: 'int' = 50, extent=None), registry से लेना हो तो opsdrive.get("foothold_candidates"))

• GPU: नहीं (केवल CPU reference implementation)

उपयोग

Terrain से अलग-अलग सुरक्षित कदम रखने के लक्ष्य चुनता है।

> नीचे का विस्तृत विवरण मूल text में है — सारांश और headings का अनुवाद हो चुका है।

Scores every cell with foothold_score, keeps local maxima above *min_score*, and greedily suppresses candidates within *min_dist* (world units) of a better one — turning the continuous flatness field into a short list of "here are places you may put a foot". Returns a list of dicts sorted best-first, each with cell (row, col), score, and xy (world) when *extent* is given. The actionable output a foot-placement planner consumes.

संदर्भ (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 के स्रोत।

• Algorithm का मानक स्रोत (लेखक, वर्ष) और उपयोग ऊपर की family usage guide में दिए गए हैं।

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

• consumer_hillco — py -3.11 examples/consumer_hillco.py

• physical_ai_perception — py -3.11 examples/physical_ai_perception.py

• walking_ops_tour — py -3.11 examples/walking_ops_tour.py

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

course_layout · course_occupancy · course_contains · world_build · world_camera · world_move · lidar_scan · rss_longitudinal_same

इसी category के (walkterrain)

elevation_map · fill_gaps · elevation_traversability · foothold_score · ground_surface · ground_plane · detect_obstacles · fuse_elevation


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

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