6 Commits

Author	SHA1	Message	Date
Tarik Moussa	7edf699ac2	test/docs: Scalability Smoke Tests + Komplexitätsdokumentation ... test_scalability_smoke.cpp (3 neue Tests → 176 CGAL-Tests gesamt): SmokeEuclidean.CatHead_SmallOpen — V=131, Newton 3 iter, <1ms SmokeEuclidean.Brezel_LargeGenus2 — V=6910, Newton 3 iter, 69ms (Apple M) SmokeEuclidean.Brezel2_Genus2_CutGraph — V=2622, Cut Graph 10ms, 4 Nähte - Korrektheit-Assertions (iter<30, ||G||<1e-8), kein Timing-Assert (CI-stabil) - Informative Ausgabe: iter, Residuum, Laufzeit als stdout-Print - Korrektur: brezel.obj ist Genus-2 (χ=−2), nicht Genus-1 (Namensgebung aus Java-Original übernommen, nicht topologisch) - Perturbation x0=−0.05 damit Newton tatsächlich iteriert doc/math/complexity.md (neu): - O()-Analyse aller Pipeline-Schritte tabellarisch - Gemessene Timings auf echten Meshes (Apple M, Release, Single-Thread) - HyperIdeal-FD-Hessian als bekannter Bottleneck dokumentiert - Skalierungsprojektion bis V=100K - Speicherverbrauch-Tabelle - Reproduzierbare Messanleitung README.md + CLAUDE.md: Testzähler 173→176, complexity.md verlinkt Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>	2026-05-18 23:05:22 +02:00
Tarik Moussa	c5efc3d3cc	chore/docs: Onboarding-Sprint für externe Mathematiker ... - LICENSE: Copyright Tarik Moussa <Tarik.moussa95@gmail.com> (war user2595) - CITATION.cff: maschinenlesbares Zitat mit 3 Primärreferenzen (Sechelmann 2016, Springborn 2020, Bobenko–Springborn 2004) - scripts/try_it.sh: Clone→Build→Test→Beispiel in einem Skript - doc/math/software-landscape.md: Landkarte aller relevanten Tools, Problem-A vs. Problem-B Abgrenzung, vollständige Feature-Matrix - doc/math/novelty-statement.md: formales Alleinstellungsmerkmal, Zielgruppen, was dieses Projekt nicht ist - code/CMakeLists.txt: cmake --install Target für Header-only-Library - doc/getting-started.md: Testzähler 158→173, Beispiel-Output, try_it.sh - README.md: CI/License/DOI-Badges, Cite-Abschnitt, Issue-Tracker-Link, Copyright, neue Doku-Einträge software-landscape + novelty-statement Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>	2026-05-18 20:35:46 +02:00
Tarik Moussa	d25f3cafe6	docs: geometry-central Vergleich als optionalen Track einarbeiten ... - phases.md: neue Sektion "Optional/Hypothetisch — geometry-central Cross-Comparison" mit GC-1 (Output-Vergleich, sofort möglich), GC-2 (Intrinsic Delaunay Pre-Conditioning, nach Phase 8) und GC-3 (Ptolemäischer Flip-Solver, hypothetisch Phase 10+) - validation.md: neuer Abschnitt 9 mit Vergleichstabelle, Normalisierungs- abgleich, Zeitplan und Springborn-2020-Einordnung - references.md: Gillespie–Springborn–Crane SIGGRAPH 2021 + Sharp 2019 als geometry-central-Referenzen eingetragen; Klarstellung zu Springborn 2020 - validation.md: Testzähler 170→173 / 11 skips→1 skip korrigiert Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>	2026-05-18 01:56:16 +02:00
Tarik Moussa	b235666725	docs: Doxygen-API + Validierungsprotokoll + Porting-Tutorial ... Für einen Mathematiker der unabhängig validieren und eigene Forschung einbringen möchte. Doxygen-Kommentare (code/include/): newton_solver.hpp — newton_euclidean(), newton_spherical(), newton_hyper_ideal() je mit \param, \return, \note, \see inkl. mathematischer Begründung (Konvexität, Vorzeichenkonvention, SparseQR-Fallback-Erklärung) layout.hpp — euclidean_layout(), spherical_layout(), hyper_ideal_layout() mit vollständiger Parameter-Doku, halfedge_uv-Semantik, Poincaré-Disk-Note Neues Dokument: doc/math/validation-protocol.md 7 reproduzierbare Checks mit konkreten Befehlen und erwartetem Output: 0. 170 Tests, 1 Skip 1. Gauss–Bonnet exakt (1e-10) 2. FD-Gradientencheck < 1e-6 für alle 3 Geometrien 3. Newton-Konvergenz < 50 Iterationen 4. τ ∈ SL(2,ℤ)-Fundamentaldomäne (3 Invarianten) 5. Möbius-Arithmetik (Inverse, Compose, from_three) 6. End-to-End-Pipeline 7. Manueller τ-Check für torus_4x4.off (Codebeispiel) Neues Tutorial: doc/tutorials/add-inversive-distance.md Vollständiger Step-by-Step-Port von Phase 9a (Luo 2004): Header anlegen, Energie/Gradient implementieren, FD-Check, Newton-Wrapper, CMakeLists, Java-Referenzvergleich, Checkliste. doc/getting-started.md: Abschnitt "Known issues": macOS-Finder-Duplikate (rm-Befehl), Warnung "First build 30–90s" (Tarball-Extraktion) README.md: Zwei neue Links in der Dokumentationstabelle (validation-protocol, tutorial) Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>	2026-05-18 01:19:44 +02:00
Tarik Moussa	e28aee7051	docs: Mathematiker-Onboarding — Theorie, Validierung, Beispiel-Meshes, 170 Tests ... Ziel: einem interessierten Mathematiker ermöglichen, die bisherige Arbeit unabhängig zu validieren und eigene Forschung beizutragen. Neu: doc/math/discrete-conformal-theory.md Kompakte mathematische Einführung (DCE, Variationsprinzip, drei Geometriemodi, Holonomie, Periodenmatrix) für Riemann-Flächen-Kenner. doc/math/validation.md Analytisch bekannte Sollwerte + wie man sie mit dem Code prüft: Gauss–Bonnet (χ), τ ∈ Fundamentaldomäne (3 Invarianten), Symmetrie- Argumente für τ=i (4-fach) und τ=e^{iπ/3} (6-fach), Newton-Konvergenz, Gradienten-Check (FD), Holonomie-Kommutator. Reviewer-Checkliste. CONTRIBUTING.md (Root) Gitea/GitHub-Standard: CONTRIBUTING.md im Root-Verzeichnis als Kurzreferenz mit Links zu doc/contributing.md und den Math-Docs. code/data/off/torus_4x4.off — 16 Vertices, 32 Flächen, Genus 1 code/data/off/torus_8x8.off — 64 Vertices, 128 Flächen, Genus 1 code/data/off/torus_hex_6x6.off — 36 Vertices, 72 Flächen, 6-fach Sym. Aktualisiert: README.md — 158 → 170 Tests, zwei neue Math-Links in Tabelle doc/api/tests.md — 28 Suiten, 170 Tests, 1 Skip (korrigiert) doc/contributing.md — Testzähler 158+2 → 170+1 Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>	2026-05-18 01:11:00 +02:00
Tarik Moussa	14134b99ce	docs: restructure documentation into focused files ... README.md: reduced from 703 to ~75 lines — what/why, status, quick start, minimal usage example, navigation table to doc/ files. doc/architecture/overall_pipeline.md: trimmed — roadmap, extension points, declarative pipeline YAML, and references sections removed (each now has its own dedicated file). Replaced with a link table. New files: doc/getting-started.md — build modes, single-test invocation, CLI doc/api/pipeline.md — full pipeline API with code for all 3 geometries doc/api/extending.md — new functionals, geometry modes, Java porting guide doc/api/contracts.md — processing unit preconditions/provides table doc/api/cgal-package.md — Phase 8 CGAL package design + YAML pipeline (TODO) doc/math/geometry-modes.md — Euclidean/Spherical/HyperIdeal comparison doc/math/references.md — all papers by module doc/roadmap/phases.md — Phases 1–10 with porting/research boundary doc/roadmap/java-parity.md — Java vs C++ feature parity table doc/contributing.md — language policy, test standards, release flow Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>	2026-05-17 21:17:15 +02:00