grid_coords — 3D sdf_csg op

• Datenarten: keine → coordgrid (ein Operator, der allein durch seine Argumente bestimmt ist — er nimmt kein Bild und keine Daten entgegen)

• Aufruf: import fullseye as fs; fs.ledger.grid_coords(bounds, res) (die Implementierung direkt: import sdf_ops; sdf_ops.grid_coords(bounds, res); aus dem Register: ops3d.get("grid_coords"))

• Rückgabewert über das Register: fullseye.ledger.grid_coords(...) liefert nur den Wert des deklarierten Out-Typs coordgrid (die zugrunde liegende Funktion gibt zusätzlich Hilfsinformationen zurück). Wird das Verworfene gebraucht, nutze fullseye.ledger.grid_coords.raw(...) oder rufe sdf_ops.grid_coords direkt auf.

Verwendung

Baut das Gitter der Voxelmittelpunkte für die CSG-Auswertung (dieselbe Gitterkonvention wie occupancy).

bounds=((xmin,xmax),(ymin,ymax),(zmin,zmax)), res ist die Voxelzahl je Achse (Skalar = Würfel oder Länge 3). Das Zentrum von voxel i liegt in world bei lo + (i+0.5)/res * span (konsistent mit c=(q-lo)/span*res-0.5 aus occupancy.query_distance = zentrumsausgerichtet). Rückgabe sind coords der Form (nx,ny,nz,3) und extent=(xmin,xmax,ymin,ymax,zmin,zmax).

Wertet man auf so erzeugten Koordinaten sphere_sdf/box_sdf aus und kombiniert sie per CSG, lässt sich das direkt an die marching cubes von recon3d oder die Nulldurchgangsextraktion von occupancy übergeben.

Bei entarteten bounds oder res<=0 wird ValueError ausgelöst.

Referenzen (Beispieldaten, Literatur)

• Katalog der Beispieldaten (Download-URLs / Lizenzen) — 2-D nutzt skimage.data (BSD/Public Domain) plus synthetische Bilder, 3-D nennt Download-URLs echter Datenquellen (Stanford, PDS, …).

• Herkunft und Literatur der Operatoren — die Quellen der Forschung/Verfahren, auf denen diese Operatorfamilie beruht.

Ausführbare Beispiele (verifizierte Samples, die diesen Operator wirklich aufrufen)

• 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

Typkompatible Folge-Operatoren (nehmen coordgrid als Eingabe)

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

Gleiche Kategorie (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. Diese Notiz wird von tools/opdocs.py md erzeugt (nicht von Hand bearbeiten).*

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