surface op• 데이터 종류: 없음 → mesh(인자만으로 정해지는 연산자 —— 이미지나 데이터 입력을 받지 않습니다)
• 호출: import fullseye as fs; fs.ledger.gyroid_isosurface(shape=(64, 64, 64), level=0.0, periods=1.0)(구현을 직접 호출하려면 import render3d; render3d.gyroid_isosurface(shape=(64, 64, 64), level=0.0, periods=1.0), 원장에서 가져오려면 ops3d.get("gyroid_isosurface"))
자이로이드 —— 마디면 근사로 만드는 삼중 주기 곡면。
> 아래 상세 설명은 원문입니다 —— 요약과 제목은 번역되어 있습니다.
Samples `sin x cos y + sin y cos z + sin z cos x over periods` unit
cells and extracts the level set. At `level = 0` the field is **odd under
the body-centred inversion**, so the two sides have exactly equal volume —
a symmetry fact, independent of the meshing, that the existing
`mesh_volume` can be pointed at.
★Honest limit, stated in the contract: this is the *nodal approximation*
to the gyroid, not the exact triply periodic minimal surface. Schoen's gyroid
has `H = 0` everywhere; the nodal surface has a residual mean curvature
(measured, not hidden) of about 12 % of the principal-curvature scale at a
64³ grid —— compare the exact families in :func:minimal_surface, whose
`|H|` median is 1e-4 against a curvature scale of order 1. Use the gyroid as
a scaffold and a picture, not as a claim of minimality.
Parameters
----------
shape : (nz, ny, nx)
level : float
Iso value. 0 gives the balanced surface; non-zero splits the volume.
periods : float
Unit cells along each axis.
Returns a `mesh` (vertices, faces).
★The thickened solid form lives in :func:gyroid_solid_mask, not behind
a keyword here —— one function that returns a mesh or a volume depending on an
argument cannot be given a single declared output type, and a ledger row that
lies about its output is the defect class this library keeps catching
(`indices_to_labels`: one word covering a 1-D mask and a 3-D volume).
Raises `ValueError`: a grid below 8 per axis or over the cap;
non-positive periods; a level outside the field's range (no surface exists
there — reported rather than returning an empty mesh); negative thickness.
• 샘플 데이터 카탈로그(DL URL / 라이선스) —— 2-D 는 skimage.data(BSD/public)+ 합성, 3-D 는 실데이터 소스(Stanford/PDS 등)의 DL URL.
• 연산자의 내력·참고문헌 —— 이 연산자 족의 바탕이 된 연구/기법의 출처.
• minimal_surfaces — py -3.11 examples_3d/minimal_surfaces.py
mesh 를 입력으로 받는 것)mesh_to_voxel · mesh_to_points · to_points · fuse_to_voxel · ambient_occlusion · cast_shadow · supersample_mesh · render_beauty
surface)minimal_surface · minimal_surface_bend · gyroid_solid_mask · curve3d_tube_mesh
*Provenance: render3d.py — 3D 연산자 레지스트리. 이 op 노트는 tools/opdocs.py md 가 자동 생성합니다(직접 편집하지 마세요).*
© 2026 Kazufumi Furuse — Fullseye operator documentation. Licensed under Apache-2.0.