grid_coords — 3D sdf_csg op

Datenarten: keinecoordgrid (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).

> Die ausführliche Beschreibung unten ist der Originaltext — Zusammenfassung und Überschriften sind übersetzt.

`bounds=((xmin,xmax),(ymin,ymax),(zmin,zmax))res` は各軸のボクセル数(スカラ=立方

or 長さ3)。voxel `i の中心は world lo + (i+0.5)/res * span(occupancy.query_distance`

の `c=(q-lo)/span*res-0.5` と整合 = 中心アライン)。返り値は

`coords shape (nx,ny,nz,3)extent=(xmin,xmax,ymin,ymax,zmin,zmax)`。

こうして作った座標に `sphere_sdf/box_sdf を評価し CSG 合成すれば、recon3d` の

marching cubes や `occupancy` のゼロ交差抽出へそのまま渡せる。

Raises ValueError for degenerate bounds or res<=0。

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_metrologypy -3.11 examples_3d/gear_metrology.py

molecule_atom_countpy -3.11 examples_3d/molecule_atom_count.py

procedural_handpy -3.11 examples_3d/procedural_hand.py

render_beautypy -3.11 examples_3d/render_beauty.py

sdf_csgpy -3.11 examples_3d/sdf_csg.py

sfm_reconpy -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.