docs(reviewer): Tier-2 exhausted (genus≥2 → Phase 13); Tier-3 Lawson scoped as mini-project

- regular_uniformization.xml / LetterB01_canonical_group.xml are genus≥2
  hyperbolic Fuchsian-group uniformizations (12-edge fundamental polygon), not
  genus-1 → Phase 13, not Tier 2.
- Tier-2 is therefore exhausted (only Wente, deferred to Phase 9f quad/cyclic).
- Tier-3 Lawson HyperIdeal golden vectors require a low-level halfedge genus-2
  multi-edge generator (4 verts/12 edges) + jtem Triangulator replication;
  scoped as a dedicated follow-up.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
This commit is contained in:
Tarik Moussa
2026-05-30 00:57:10 +02:00
committed by Tarik Moussa
parent 822a27da69
commit 267ae965ab

View File

@@ -104,10 +104,28 @@ Assertion strategy: because the values are symmetric per DOF-class, assert
| **1** | `EuclideanCyclicConvergenceTest` | `cathead.obj` *(already in C++)* | MTJ BiCGstab (no PETSc) | `α_opp+α_opp = π0.1` @1e-12 (per-edge φ target) | `euclidean_functional` ✅, `phi_e` ✅, cathead ✅ | **near-zero** |
| **1** | `SphericalConvergenceTest` | octahedron | MTJ Newton (no PETSc) | self-consistency (const. curvature) | spherical ✅, `make_octahedron_face` ✅ | low |
| **2** | Wente genus-1 uniformization | `wente_torus02.obj` + `wente_uniformization.xml` | — (stored result) | exact `IsometryPSL2R` uniformizing-group generators | holonomy/`MobiusMap` ✅; **needs XML reader** | medium |
| **2** | `regular_uniformization.xml` | (stored) | — | uniformization data | needs XML reader | medium |
| ~~2~~ **4** | `regular_uniformization.xml`, `LetterB01_canonical_group.xml` | (stored) | — | full `IsometryPSL2R` Fuchsian group + 12-edge `FundamentalPolygon` | **genus ≥ 2 hyperbolic** (not genus-1) → Phase 13 | future |
| **3** | HyperIdeal Lawson convergence (3 golden vectors) | combinatorial `createLawsonSquareTiled` | — (hard-coded u\*) | symmetric u\* | needs **low-level half-edge generator** (§5) | high |
| **4** | genus-2 (`genus2.xml`/`lawson2498.obj`), holomorphic forms (`HolomorphicEuclideanUniformization_*.xml`), Schottky (`genus2.xml`), hyperelliptic | assets present in Java | — | various | Phases 10a/10c/11/13 | future |
**Tier-2 status (2026-05-30): exhausted.** The only genus-1 case is Wente
(deferred to Phase 9f, quad/cyclic). `regular_uniformization.xml` and
`LetterB01_canonical_group.xml` are **genus ≥ 2 hyperbolic** uniformizations
(full PSL(2,) Fuchsian groups + a 12-edge fundamental polygon) → Phase 13, not
Tier 2.
**Tier-3 status: a dedicated mini-project (gated on a mesh generator).** The
Lawson golden vectors require `createLawsonSquareTiled`: a genus-2 surface with
**4 vertices / 12 edges → multi-edges** (≥2 edges per vertex pair). CGAL
`add_face` / polygon-soup / OFF are all vertex-pair-keyed and **cannot** build
it; it needs hand-wired **low-level Surface_mesh halfedge construction**
(`add_edge` + explicit `set_next`/`set_vertex`/`set_face`, then `is_valid`),
plus replicating the external jtem `Triangulator` diagonal choice. The golden
vector is perfectly symmetric (4×1.1462 / 12×1.7627 / 6×2.6339), so a
*symmetry-preserving* triangulation may reproduce the three values without an
exact Triangulator match — but that is unverified. Recommended as its own
focused PR (`make_lawson_square_tiled` + golden-vector oracle), not a quick add.
**Key correction:** the Lawson generator (originally flagged HIGH) is actually
**Tier 3** — higher effort than Tier 1/2. Cheapest first wins: