conformallab/ConformalLabpp
3
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases 1 Wiki Activity

docs: note high-precision requirement for Phase 9c/10 uniformization
Some checks failed
C++ Tests / test-fast (pull_request) Successful in 2m0s
Details
API Docs / doc-build (pull_request) Successful in 53s
Details
Markdown link check / check (pull_request) Successful in 54s
Details
C++ Tests / test-cgal (pull_request) Has been skipped
Details
C++ Tests / quality-gates (pull_request) Failing after 2m14s
Details

Browse Source 
The Java uniformization classes (FundamentalPolygonUtility, CanonicalFormUtility)
rely on the *Big arbitrary-precision geometry (MathContext(50)) because products
of hyperbolic isometry generators grow exponentially and double fails to verify
the group relation ∏gᵢ = Id. Record this planning-relevant prerequisite and
resolve the contradiction in java-parity.md, which previously listed *Big as
permanently out of scope.

- CLAUDE.md: † note on the Phase-9 not-yet-ported table
- java-parity.md: *Big exception (localized high-precision substrate for 9c/10)
- phases.md: precision prerequisite as 9c sub-task + effort estimate
- design-decisions.md: new "Scalar type: double, with one localized exception"

Core flattening (Newton/energy/Eigen solver) stays double; the substrate
(cpp_dec_float_50 / mpreal) is localized to the uniformization module only.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
This commit is contained in:
Tarik Moussa
2026-05-28 07:41:23 +02:00
parent 1ff5382c8b
commit ca936b7652
4 changed files with 42 additions and 4 deletions
Download Patch File Download Diff File Expand all files Collapse all files

9
doc/roadmap/phases.md
View File

@@ -131,8 +131,15 @@ mesh type.
Mathematical source: Poincaré 1882 + Sechelmann 2016 §5
Research component: bridging to conformallab++ cut_graph.hpp
+ holonomy infrastructure.
† PRECISION PREREQUISITE: the canonicalisation composes products of
hyperbolic isometry generators, whose entries grow exponentially.
double fails to verify the group relation ∏gᵢ = Id; Java uses
MathContext(50) (RnBig/PnBig/P2Big). Port a LOCALIZED high-precision
substrate (boost::multiprecision::cpp_dec_float_50 or MPFR mpreal)
inside the uniformization module only — NOT the core or the Eigen
solver. See CLAUDE.md Phase-9 note + java-parity.md exception.
Effort: ~2 weeks for fundamental polygon, +2 weeks for surgery
layer, +1 week integration.
layer, +1 week integration, +~3 days high-precision substrate.
```
9d — Cone metrics + sphere utilities (Java port + research extension)