feat(gmsh): GMSH Frontal-Delaunay tessellation for clean cylinder seams

- Per-solid iteration prevents OOM on multi-part assemblies (25-part bearing:
  2.3GB RAM when processing compound → ~100MB per solid with per-solid approach)
- Fix CharacteristicLengthMax multiplier 5× → 15× and cap MinimumCirclePoints
  at 20 (prevents 63-pts/circle on angular_deflection=0.1rad → 231MB → 21MB)
- Geometry task timeout 120s → 600s for large assemblies
- Production task: reuse _geometry.glb when GMSH enabled (no re-tessellation)
  and cache _production_geom.glb for OCC (mtime vs STEP check)
- Viewer now prefers production GLB when available (shows correct GMSH mesh)
- GMSH OpenMP multithreading (min(cpu_count,16)) for 4.4× speedup

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
This commit is contained in:
2026-03-11 20:45:27 +01:00
parent 9703aec497
commit dbc032ec74
4 changed files with 137 additions and 45 deletions
+47 -10
View File
@@ -316,11 +316,16 @@ def _tessellate_with_gmsh(shape, linear_deflection: float, angular_deflection: f
gmsh.option.setNumber("Mesh.MaxNumThreads2D", n_threads) # parallel surface meshing
gmsh.option.setNumber("Mesh.Algorithm", 6) # Frontal-Delaunay 2D
gmsh.option.setNumber("Mesh.RecombineAll", 0) # keep triangles (no quads)
# CharacteristicLength controls edge length target in mm
gmsh.option.setNumber("Mesh.CharacteristicLengthMin", linear_deflection * 0.5)
gmsh.option.setNumber("Mesh.CharacteristicLengthMax", linear_deflection * 3.0)
# Angular resolution via circle point count: 2π / angular_deflection
min_circle_pts = max(6, int(_math.ceil(2.0 * _math.pi / max(angular_deflection, 0.01))))
# CharacteristicLength is an edge LENGTH target, while OCC linear_deflection is a
# surface DEVIATION tolerance. On a 50mm radius cylinder, OCC with deflection=0.1mm
# produces ~1.4mm edge lengths; we scale by 15x to match density.
# MinimumCirclePoints caps are essential: without a cap, angular_deflection=0.1rad
# yields ceil(2π/0.1)=63 pts/circle which inflates mesh 10-20x vs OCC.
gmsh.option.setNumber("Mesh.CharacteristicLengthMin", linear_deflection)
gmsh.option.setNumber("Mesh.CharacteristicLengthMax", linear_deflection * 15.0)
# 1220 pts/circle produces smooth-looking cylinders and matches OCC density.
# Clamp below ceil(2π/angular_deflection) so angular quality is never degraded.
min_circle_pts = min(20, max(12, int(_math.ceil(2.0 * _math.pi / max(angular_deflection, 0.01)))))
gmsh.option.setNumber("Mesh.MinimumCirclePoints", min_circle_pts)
gmsh.option.setNumber("Mesh.MinimumCurvePoints", 3)
# Reduce noise from GMSH warnings
@@ -512,12 +517,44 @@ def main() -> None:
f"(linear={args.linear_deflection}mm, angular={args.angular_deflection}rad) …")
engine = getattr(args, "tessellation_engine", "occ")
for i in range(1, free_labels.Length() + 1):
shape = shape_tool.GetShape_s(free_labels.Value(i))
if not shape.IsNull():
if engine == "gmsh":
_tessellate_with_gmsh(shape, args.linear_deflection, args.angular_deflection)
if engine == "gmsh":
# GMSH: tessellate each solid individually to cap peak RAM usage.
# On multi-part assemblies (e.g. 25 rolling elements), processing the full
# compound at once uses 2-3 GB RAM. Processing per-solid limits peak RAM to
# max(single_solid_size). OCC BRep_Builder writes triangulation directly to
# the shared face objects — the parent compound is updated automatically.
from OCP.TopExp import TopExp_Explorer as _Explorer
from OCP.TopAbs import TopAbs_SOLID as _SOLID, TopAbs_SHELL as _SHELL
from OCP.BRepMesh import BRepMesh_IncrementalMesh as _BrepMesh
for i in range(1, free_labels.Length() + 1):
root_shape = shape_tool.GetShape_s(free_labels.Value(i))
if root_shape.IsNull():
continue
# Collect solids first; fall back to shells for open bodies
solids = []
exp = _Explorer(root_shape, _SOLID)
while exp.More():
solids.append(exp.Current())
exp.Next()
if not solids:
exp = _Explorer(root_shape, _SHELL)
while exp.More():
solids.append(exp.Current())
exp.Next()
if solids:
for solid in solids:
_tessellate_with_gmsh(solid, args.linear_deflection, args.angular_deflection)
else:
# Fallback for any shapes that are neither solid nor shell
_tessellate_with_gmsh(root_shape, args.linear_deflection, args.angular_deflection)
else:
for i in range(1, free_labels.Length() + 1):
shape = shape_tool.GetShape_s(free_labels.Value(i))
if not shape.IsNull():
BRepMesh_IncrementalMesh(
shape,
args.linear_deflection,