docs: citation audit + correct 8 mis-citations; add Phases 12/13
Some checks failed
C++ Tests / test-fast (pull_request) Successful in 1m55s
API Docs / doc-build (pull_request) Successful in 53s
Markdown link check / check (pull_request) Successful in 50s
C++ Tests / test-cgal (pull_request) Has been skipped
C++ Tests / quality-gates (pull_request) Failing after 1m56s

External reviewer pass over the literature references. Verified entries
against arXiv/DOI/publisher and corrected misattributions that had
propagated across the docs.

Corrected citations (consistent across all docs):
- Bowers-Bowers-Lutz 2026: title was the 2017 paper's
  -> "Rigidity of Koebe Polyhedra and Inversive Distance Circle Packings"
- Liouville theorem: "Springborn 2019" -> Pinkall & Springborn,
  Geom. Dedicata 214 (2021)
- Bobenko-Pinkall-Springborn: "G&T 14 (2010)" -> G&T 19(4) (2015), 2155-2215
- Optimal Cone Singularities: "Crane, Soliman, Ben-Chen, Schroeder"
  -> Soliman, Slepcev, Crane, ACM TOG 37(4)
- Schlaefli formula: "Rivin, Springborn 1999" -> Rivin, Schlenker
- Quasiconformal distortion: "Springborn, Veselov" -> Born, Buecking,
  Springborn (arXiv:1505.01341)
- Period matrices: "Bobenko, Buecking 2009" (was Bobenko-Mercat-Schmies'
  title) -> Bobenko-Mercat-Schmies 2011 + genuine Bobenko-Buecking 2021
- Fabricated entry: "Alexa 2020, DOI 10.1145/3414685.3417840" pointed to
  an unrelated paper (Pixelor) -> Bunge, Herholz, Kazhdan, Botsch 2020
- Stripe Patterns: "Bonneel et al. 2015" -> Knoeppel, Crane, Pinkall,
  Schroeder 2015

Equation-number corrections (verified against the PDFs):
- Glickenstein 2011 "eq. 4.6" -> "§5.2" (no such equation label exists)
- Springborn 2020 "eq. 4.6" -> "§4 variational gradient"
- inversive-distance attribution softened to classical inversive distance

Other:
- DBFEnergy bibliography (separate repo) and convergence half-sentence in
  novelty-statement.md §3.3 (Bobenko-Buecking 2021)
- Status legend (implemented vs planned) at top of references.md
- New Phase 12 (decorated DCE & geometric transition, Chain A, near-term)
  and Phase 13 (canonical tessellations & polyhedral realisation, Chain B
  capstone) in phases.md + research-track.md; 10c scope-boundary note
  clarifying infrastructure vs Lutz-specific algorithms

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
This commit is contained in:
Tarik Moussa
2026-05-29 19:17:17 +02:00
parent 18b9c61492
commit 26f4f0637d
11 changed files with 274 additions and 70 deletions

View File

@@ -250,16 +250,16 @@ per-phase entry in <code>doc/roadmap/</code>.</p>
<tr><td>Quasi-isothermic maps (Lawson correspondence, ~800 lines, discrete Beltrami-field solver)</td>
<td>scoped as a 6-class Java port: <code>QuasiisothermicLayout</code>, <code>DBFSolution</code>, <code>SinConditionApplication</code>, <code>QuasiisothermicDelaunay</code>, <code>QuasiisothermicUtility</code>, <code>ConformalStructureUtility</code></td>
<td><span class="pill new">10e</span> planned</td></tr>
<tr><td>Higher-genus + hyperelliptic surfaces (BobenkoBücking 2009; block-diagonal period matrices with Z₂ symmetry)</td>
<tr><td>Higher-genus + hyperelliptic surfaces (BobenkoMercatSchmies 2011 / BobenkoBücking 2021 period matrices; block-diagonal Z₂ symmetry)</td>
<td>port of <code>HyperellipticUtility</code> + <code>HyperIdealHyperellipticUtility</code> scoped; existing period-matrix code as scaffolding</td>
<td><span class="pill new">10b</span> planned</td></tr>
<tr><td>Möbius centring as a variational problem (Lorentz energy, full gradient + Hessian)</td>
<td>currently iterative Fréchet mean in <code>normalise_hyperbolic()</code>; the principled variational alternative is scoped via the Java <code>MobiusCenteringFunctional</code> port</td>
<td><span class="pill new">9d.4</span> planned</td></tr>
<tr><td>Boundary-First / interactive flattening (Crane et al. 2017 BFF; Bonneel et al. 2015 <i>Stripe Patterns</i>)</td>
<tr><td>Boundary-First / interactive flattening (SawhneyCrane 2017 BFF; KnöppelCranePinkallSchröder 2015 <i>Stripe Patterns</i>)</td>
<td>not on the roadmap as ports; documented in <code>references.md</code> as comparison points / inspiration</td>
<td></td></tr>
<tr><td>Schläfli-based variational machinery (RivinSpringborn 1999)</td>
<tr><td>Schläfli-based variational machinery (RivinSchlenker 1999)</td>
<td>derivation done; implementation gated on the reader's view of whether the ~6× speedup over our block-FD path matters at their mesh sizes</td>
<td><span class="pill new">9b-analytic</span> ready</td></tr>
</tbody>
@@ -320,15 +320,16 @@ sufficient answer.</p>
Decorated-DCE / canonical-tessellation / hyperideal line:
BobenkoLutz 2024 IMRN; BobenkoLutz 2025 <i>DCG</i>; Lutz 2023
<i>Geom. Dedicata</i>; Lutz 2024 PhD; BowersBowersLutz 2026.
Cones, polyhedra, period matrices: Crane et al. 2018;
Springborn 2019; BobenkoBücking 2009; RivinSpringborn 1999.
Polygon Laplacians: AlexaWardetzky 2011; Alexa 2020. Integrable
and practical-flattening context: SpringbornVeselov 2015;
Crane et al. 2017 (BFF); Bonneel et al. 2015 (Stripe Patterns).
Cones, polyhedra, period matrices: SolimanSlepčevCrane 2018;
PinkallSpringborn 2021 (discrete Liouville); BobenkoMercatSchmies
2011 / BobenkoBücking 2021; RivinSchlenker 1999.
Polygon Laplacians: AlexaWardetzky 2011; Bunge et al. 2020. Integrable
and practical-flattening context: BornBückingSpringborn 2015;
SawhneyCrane 2017 (BFF); Knöppel et al. 2015 (Stripe Patterns).
</li>
<li><span class="pill research">+1 RESEARCH phase</span> with no Java
parent — Phase 9f (polygon Laplacian on non-triangular meshes,
Alexa-Wardetzky 2011 / Alexa 2020) — the first phase a reviewer
Alexa-Wardetzky 2011 / Bunge et al. 2020) — the first phase a reviewer
can shape at design stage.</li>
<li><span class="pill new">output_uv_map</span> now covers 4 of 5 DCE
solvers (Inversive-Distance added; CP-Euclidean deferred to
@@ -427,9 +428,9 @@ folder for the per-document table.</p>
<table>
<tr><th>Document</th><th>What it covers</th></tr>
<tr><td><a href="https://codeberg.org/TMoussa/ConformalLabpp/src/branch/main/doc/math/references.md"><code>references.md</code></a> <span class="pill new">+13 refs</span></td>
<td>Per-phase literature index. 13 new citations added: decorated DCE in non-Euclidean geometries (BobenkoLutz 2025); canonical tessellations (Lutz 2023 / 2024); hyperideal polyhedra rigidity (BowersBowersLutz 2026); polygon Laplacians (AlexaWardetzky 2011 / Alexa 2020); optimal cone placement (Crane et al. 2018); Schläfli identity (RivinSpringborn 1999); hyperbolic polyhedra (Springborn 2019); polyhedral period matrices (BobenkoBücking 2009); integrable cluster dynamics (SpringbornVeselov 2015); BFF (Crane et al. 2017); stripe patterns (Bonneel et al. 2015).</td></tr>
<td>Per-phase literature index. 13 new citations added: decorated DCE in non-Euclidean geometries (BobenkoLutz 2025); canonical tessellations (Lutz 2023 / 2024); hyperideal polyhedra rigidity (BowersBowersLutz 2026); polygon Laplacians (AlexaWardetzky 2011 / Bunge et al. 2020); optimal cone placement (SolimanSlepčevCrane 2018); Schläfli identity (RivinSchlenker 1999); discrete Liouville theorem (PinkallSpringborn 2021); polyhedral period matrices (BobenkoMercatSchmies 2011 / BobenkoBücking 2021); quasiconformal distortion (BornBückingSpringborn 2015); BFF (SawhneyCrane 2017); stripe patterns (KnöppelCranePinkallSchröder 2015).</td></tr>
<tr><td><a href="https://codeberg.org/TMoussa/ConformalLabpp/src/branch/main/doc/math/hyperideal-hessian-derivation.md"><code>hyperideal-hessian-derivation.md</code></a></td>
<td>Full LaTeX-formatted derivation of the analytic HyperIdeal Hessian via the Schläfli identity (805 lines, 8 sections + 2 appendices). Cited sources: Schläfli 1858, Milnor 1982, Vinberg 1993, ChoKim 1999, Glickenstein 2011, RivinSpringborn 1999, Springborn 2020.</td></tr>
<td>Full LaTeX-formatted derivation of the analytic HyperIdeal Hessian via the Schläfli identity (805 lines, 8 sections + 2 appendices). Cited sources: Schläfli 1858, Milnor 1982, Vinberg 1993, ChoKim 1999, Glickenstein 2011, RivinSchlenker 1999, Springborn 2020.</td></tr>
</table>
</details>