gyroid_solid_mask — 3D surface op

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

• Call: import fullseye as fs; fs.ledger.gyroid_solid_mask(shape=(64, 64, 64), level=0.0, periods=1.0, thickness=0.3) (implementation को सीधे call करना हो तो import render3d; render3d.gyroid_solid_mask(shape=(64, 64, 64), level=0.0, periods=1.0, thickness=0.3), registry से लेना हो तो ops3d.get("gyroid_solid_mask"))

उपयोग

printable solid के रूप में gyroid: level set के ±*thickness* के अंदर का shell।

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

Returns a volume (float 0/1), so it feeds the existing voxel ops (vol_label / skeletonize_vol / mesh_slice_stack) directly and needs no marching cubes —— this form works on bare numpy, while gyroid_isosurface needs scikit-image.

★Why this earns its place: at level = 0 the field is odd under the body-centred inversion, so the solid fraction of the two sides is *exactly* equal —— a symmetry fact the mask can be checked against (the measured fraction above 0 converges on 0.5 as the grid refines), and the shell volume grows linearly in *thickness* for small *thickness* because the level set has finite area. Both are independent of how the field was sampled.

Raises ValueError: a grid below 8 per axis or over the cap; non-positive periods; a non-finite level; a negative thickness.

संदर्भ (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 करते हैं)

• minimal_surfaces — py -3.11 examples_3d/minimal_surfaces.py

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

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

इसी category के (surface)

minimal_surface · minimal_surface_bend · gyroid_isosurface · curve3d_tube_mesh


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

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