grid_coords — 3D `sdf_csg` op

• Data kinds: कोई नहीं → coordgrid (केवल arguments से तय होने वाला op — यह कोई image या data input नहीं लेता)

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

• Ledger के ज़रिए return value: fullseye.ledger.grid_coords(...) केवल घोषित out type coordgrid का value लौटाता है (मूल function सहायक जानकारी भी लौटाता है)। जो हिस्सा छोड़ दिया गया है उसकी ज़रूरत हो तो fullseye.ledger.grid_coords.raw(...) का उपयोग करें, या sdf_ops.grid_coords को सीधे call करें।

उपयोग

CSG evaluation के लिए voxel-centre coordinates का grid बनाता है (occupancy जैसी ही grid परिपाटी)।

bounds=((xmin,xmax),(ymin,ymax),(zmin,zmax)), res हर axis पर voxels की संख्या है (scalar = cube या लंबाई 3)। voxel i का center world में lo + (i+0.5)/res * span है (occupancy.query_distance के c=(q-lo)/span*res-0.5 से संगत = center-aligned)। return value shape (nx,ny,nz,3) वाला coords और extent=(xmin,xmax,ymin,ymax,zmin,zmax) है।

इस तरह बने coordinates पर sphere_sdf/box_sdf evaluate करके CSG से जोड़ें, तो इन्हें सीधे recon3d के marching cubes या occupancy के zero crossing extraction को दिया जा सकता है।

bounds degenerate हों या res<=0 हो तो 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 करते हैं)

• gear_metrology — py -3.11 examples_3d/gear_metrology.py

• molecule_atom_count — py -3.11 examples_3d/molecule_atom_count.py

• procedural_hand — py -3.11 examples_3d/procedural_hand.py

• render_beauty — py -3.11 examples_3d/render_beauty.py

• sdf_csg — py -3.11 examples_3d/sdf_csg.py

• sfm_recon — py -3.11 examples_3d/sfm_recon.py

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

fuse_to_voxel · sphere_sdf · box_sdf · plane_sdf · cylinder_sdf · torus_sdf · capsule_sdf

इसी category के (`sdf_csg`)

sphere_sdf · box_sdf · plane_sdf · cylinder_sdf · torus_sdf · capsule_sdf · sdf_union · sdf_intersect

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

grid_coords — 3D sdf_csg op