Luce packages
LuceLuce BaseLuciaOS

dymokomi/luce-geocore

Source of release 0.7.5

0.7.5 / docs / VALIDATION.md

# Validation

`luc test` builds and runs the test program `tests/mesh`. Every mesh check also runs with
allocation failure injected at each stage, and must leave no allocation live. The program
then runs itself twice more with pools of one and two workers, and once with
`--small-faces 4`, which sends every
face of more than four corners through the large-face (heap scratch) path, so
every check covers both paths and they must agree.

- Large faces (tests/mesh/large_face_checks.lucb): a regular polygon, a concave
  star, a comb of thin teeth and a spiral corridor of 300 to 20,000 corners,
  in a tilted plane, get valid display triangles directly, through Mesh
  construction (supplied back and validated), MeshBuilder faces with copied and
  reversed display, a folding position edit, Subdivide (both methods), the
  Catmull-Clark display, PolyExtrude, Inset, Triangulate, Duplicate, Split,
  Merge Points, PolyDraw (drawn and through a group), Fill (face and fan),
  Dissolve, the dissolve workspace (a union of 800 corners, and 128 edits
  growing one face to 260) and a codec round trip. Triangulation timings are
  printed and loosely bounded; tests/bench/geometry.lucb has rows for them.

- Curved-polygon display triangulations: exact index retention through detached
  copies, attributes, affine/reflected placement, merging, deletion/compaction
  and face reversal; arbitrary deformation invalidation; builder rollback;
  rejection of out-of-face, partial, reversed and repeated triangles. Allocation
  failure injection exercises 256 construction/copy/operation stages and checks
  that no package allocations remain live.
- Edge dissolve preserves the exact source display surface across planar,
  nonplanar and thin-cell unions at two scales (eight combinations). A pinched
  union is rejected instead of publishing a repeated boundary vertex.
- Local dissolve staging is compared after every accepted/rejected operation
  against sequential immutable dissolves on planar/nonplanar grids in both
  windings. Points, face/corner order, normals, display indices and numeric
  attributes across all four domains match exactly. Neighbor slots remain
  reciprocal. Zero edit budgets, nonmanifold edges and inconsistent winding
  reject without mutation. 192 injected allocation cutoffs check cleanup;
  a separately denied display-validation allocation leaves the edit retryable.
- Polygon face normals use an extent-relative area threshold, consistent with
  polygon triangulation, rather than the generic vector normalization cutoff.
  Scale regressions cover 96 concave-polygon combinations of size, translation,
  plane and winding through both direct construction and the mesh builder;
  they verify analytic area, unit normals and directed display triangles.
  A tiny non-collinear UV wedge is accepted and a collinear face is rejected.
  This is a polygon-construction contract, not a claim that every CAD operation
  is independent of units or tolerances.
- Stranded-ear recovery has 378 scale/pose/winding/start/perturbation cases.
  Every supplied boundary interval survives once, every interior diagonal twice
  with opposite use, and positions, corner order, signed area and positive
  conditioned triangles are checked. Another 96 injected-allocation stages
  exercise cleanup of the exceptional partition tables. Disabling the fallback
  in an isolated negative-control build makes this regression fail.
- Lazy spatial-index checks cover failure/retry at ten allocation cutoffs,
  including BVH growth, and warmed queries with all further allocation refused.
  Attribute snapshots keep the same completed cache after the original closes.
  Eight rounds of eight simultaneous native readers exercise first publication
  on a detached mesh, then 100 repeated query sets per reader; all allocations
  are accounted for after join/close. Two nonplanar quad triangulations verify
  that queries still use the exact retained display surface, not a new diagonal.
- Point/triangle distance avoids the nearly equal products in the Gram
  determinant. It uses signed cross-product areas, a better-conditioned origin,
  and boundary candidates. 4,334 primitive queries cover thin triangles,
  vertex permutations, scales, translations, axis planes, known interior/edge/
  exterior projections, nonzero normal distances, and degenerate vertices.
- Verbs: golden checks of every verb on a 4 by 4 grid carrying uvs, groups
  and ids (`verb_checks`: counts, output selections, propagation,
  determinism, the Edit engine's symmetry, soft falloff, soft weights and
  kept selections); the G6 verbs' element counts and closed surfaces
  (`g6_checks`); PolyDraw (`polydraw_checks`); subdivision and creases
  (`subdivision_checks`).
- Groups: every row of Houdini's group-syntax table
  (`group_language_checks`), selections and their encoder round trips.