28 Commits

Author	SHA1	Message	Date
Tarik Moussa	02fb80ee3e	Phase 7.5: Doxygen infrastructure + Phase 8 design freeze ... Adds the Doxygen documentation pipeline as the bridge from Phase 7 (porting complete) to Phase 8 (CGAL package). Also captures the strategic Phase 8 decisions taken on 2026-05-19. Infrastructure ────────────── * Doxyfile — CGAL-style minimal configuration, HTML-only, INPUT=code/include + doc/, excludes deps/ and macOS Finder duplicates * code/CMakeLists — `doc` target via find_package(Doxygen QUIET); silently disabled if Doxygen is not installed * README — `cmake --build build --target doc` instructions * .gitignore — exclude doc/doxygen/ output Phase 8 strategic decisions (recorded in doc/api/cgal-package.md) ──────────────────────────────────────────────────────────────── * Submission to CGAL: pre-submission-ready, 12+ months horizon, MIT preserved * Mesh-type flexibility: generic FaceGraph + HalfedgeGraph * Parameter style: CGAL Named Parameters * Default kernel: Simple_cartesian<double> (status quo) * Architecture: 3-layer wrapper, no algorithm duplication * Acceptance test: Phase 9a (Inversive-Distance) as first new client CLAUDE.md updated with a compact Phase 8 decision table. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>	2026-05-19 19:56:22 +02:00
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	b02f08625c	docs: detaillierter geometry-central Vergleich (Abgrenzung, Adoption, Mehrwert) ... Neues Dokument doc/architecture/geometry-central-comparison.md: - Gemeinsame mathematische Grundlage (Bobenko–Springborn 2004, Springborn 2020) - Algorithmenvergleich: Newton (fixed triangulation) vs. Ptolemäische Flips - Vollständige Feature-Matrix: was existiert wo, was fehlt wo - Klare Adoptionsempfehlungen: Ptolemäischer Pre-Conditioner ja (GC-2), intrinsische Triangulierungen als Architektur nein (Begründung) - 5 wissenschaftliche Mehrwerte: Kreuz-Validierung, Konvergenzstudie, Period-Matrix als Alleinstellungsmerkmal, Sphärische Geometrie, Springborn 2020 - Praktischer Roadmap GC-1 bis GC-paper mit Aufwandsschätzungen - README-Eintrag ergänzt Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>	2026-05-18 02:06:46 +02:00
Tarik Moussa	d0dd1bad3b	docs: README Testanzahl 170 → 173 (nach Java-Konvergenz-Tests) ... Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>	2026-05-18 01:42:23 +02:00
Tarik Moussa	52604d8544	docs: Konzeptdokument Declarative YAML Pipeline (Phase 8e) ... doc/concepts/declarative-pipeline.md — vollständige Design-Spezifikation: 1. Kernidee: Processing Units mit expliziten require/provide-Contracts 2. Token-Vokabular: 30 Tokens in 7 Kategorien input, setup, Gauss-Bonnet, solver, topology, layout, period/domain/output 3. YAML-Schema: Vollständige Syntax inkl. Parameterdefaults aller Units 4. Validierungsalgorithmus: monoton wachsendes provided-Set, Pre-Execution-Check 5. 5 vollständige Beispiele: A — Euklidische Uniformisierung Torus (τ-Ausgabe) B — Sphärische Uniformisierung (cathead.obj) C — Hyperbolische Uniformisierung Torus (Poincaré-Disk) D — Volle Pipeline mit Periodenmatrix + 5×5-Kachelung E — Absichtlich fehlerhaftes Beispiel mit Validator-Fehlermeldungen 6. C++-Mapping: alle YAML-Unit-Namen → C++-Funktionen + Header 7. Implementierungsplan (Phase 8e): pipeline.hpp + CLI-App + YAML-Abhängigkeit 8. Design-Entscheidungen: YAML vs. JSON/TOML, explizit vs. auto-inference, linear vs. DAG, eine Geometrie pro Datei doc/api/cgal-package.md: Link zum Konzeptdokument ergänzt. README.md: Link in Dokumentationstabelle ergänzt. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>	2026-05-18 01:39:14 +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	95d48c434a	chore: .gitignore + vergessene Doc-Dateien nachgetragen ... .gitignore: build-Verzeichnisse, .DS_Store, .claude/, CMake-Artefakte Doc-Dateien die beim Restructure-Commit fehlten: doc/api/headers.md — alle 24 Public-Header mit Beschreibung doc/api/tests.md — 26 Suiten, 158 Tests, Einzelzahlen doc/architecture/design-decisions.md — Architekturentscheidungen + Begründung doc/architecture/project-structure.md — Verzeichnisbaum + Build-Targets README.md: Links zu den vier neuen Doc-Dateien ergänzt Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>	2026-05-17 21:40:05 +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
Tarik Moussa	6886803a29	fix(ci): decouple CGAL tests from viewer — add WITH_CGAL_TESTS flag ... Root cause: -DWITH_CGAL=ON implied -DWITH_VIEWER=ON, which pulled in GLFW, which requires wayland-scanner — not present in the headless CI container (ubuntu:22.04 ARM64). Fix: new CMake option -DWITH_CGAL_TESTS=ON builds conformallab_cgal_tests without touching the viewer, GLFW, libigl, or any display dependency. Only Boost headers are required (already in the Docker image). Changes ─────── code/CMakeLists.txt - Add WITH_CGAL_TESTS option (OFF by default) - find_package(Boost REQUIRED) now shared between WITH_CGAL and WITH_CGAL_TESTS - WITH_CGAL still implies WITH_VIEWER (for local full builds) - Remove duplicate find_package(Boost) inside the WITH_CGAL block code/tests/CMakeLists.txt - cgal/ subdirectory added for WITH_CGAL OR WITH_CGAL_TESTS .gitea/workflows/cpp-tests.yml - test-cgal job: -DWITH_CGAL=ON → -DWITH_CGAL_TESTS=ON README.md - Build modes table: three rows (default / CGAL_TESTS / CGAL full) - Quick-start: separate headless and full-local sections - Prerequisite table updated Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>	2026-05-14 13:50:56 +02:00
Tarik Moussa	f8686a073c	docs: add phase roadmap with porting/research boundary to README and architecture doc ... Structured the development roadmap into four blocks with an explicit boundary marker separating direct Java ports (Phase 1–7) from infrastructure (Phase 8), remaining porting (Phase 9), and new research territory (Phase 10+). Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>	2026-05-14 13:18:21 +02:00
Tarik Moussa	a937edcafe	docs: Dissertation, GitHub-Repo, Website und LinkedIn von Stefan Sechelmann ergänzt ... README: - Neuer Einstieg mit vollständiger Dissertation-Referenz (Titel, TU Berlin 2016, DOI 10.14279/depositonce-5415, CC BY-SA 4.0) - Links zu Original-Java-Repo, sechel.de und linkedin.com/in/sechel - Neuer Abschnitt "Ursprung & Danksagung" vor der Lizenz doc/architecture/overall_pipeline.md: - Neuer "Origin"-Abschnitt ganz oben mit vollständiger Quellenangabe - Literaturabschnitt erweitert: Dissertation als "Primary source" hervorgehoben, Java-Original-Repo als direkter Port-Bezug dokumentiert Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>	2026-05-14 12:33:30 +02:00
Tarik Moussa	5333ed143a	docs: README vollständig überarbeitet — Phase 7 aktuell, Redundanzen entfernt ... - Status-Banner: Phase 7 ✅, 158 Tests (war: Phase 6, 121 Tests) - Features-Tabelle: Phase 7 Zeilen ergänzt (Priority-BFS, MobiusMap, halfedge_uv, Möbius-Holonomie, Periodenmatrix, Fundamentalbereich) - Bibliotheks-Nutzung: Holonomie/Periodenmatrix/Fundamentalbereich-Beispiele - Öffentliche Header: period_matrix.hpp + fundamental_domain.hpp ergänzt - Projektstruktur: neue Dateien + korrigierte Testzahlen - Test-Suiten: 12 neue Suiten (Phase 7), Gesamt 158 - Mathematischer Umfang: ❌ → ✅ für Holonomie, Periodenmatrix Genus-1, halfedge_uv, exakte Trilateration, Schnittgraph - Veraltete Abschnitte entfernt: "Porting the Java uniformization pipeline" Roadmap (Schritte 1-5 alle umgesetzt), Layout-Vergleich-Codeblöcke mit vorgeschlagenen Implementierungen (jetzt live) - Roadmap: Phase 7 ✅ mit Details, Phase 8 geplant - Sprache: auf Deutsch vereinheitlicht (war gemischt DE/EN) Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>	2026-05-14 10:34:24 +02:00
Tarik Moussa	4fc48b39f0	feat(phase6): exact hyperbolic layout, Gauss–Bonnet, cut graph, normalisation — 121 tests ... New files: - gauss_bonnet.hpp: euler_characteristic, genus, Σ(2π-Θ_v) sum/rhs/deficit, check_gauss_bonnet (throws), enforce_gauss_bonnet (correct sign: Δ=(lhs-rhs)/V) - cut_graph.hpp: CutGraph struct + compute_cut_graph (tree-cotree, Erickson–Whittlesey 2005); boundary edges correctly excluded from cut set - test_phase6.cpp: 26 new tests (GaussBonnet ×8, CutGraph ×6, HyperbolicTrilateration ×4, Normalisation ×4 — all pass) layout.hpp (Phase 6 rewrite): - detail::trilaterate_hyp: exact Möbius + hyperbolic law of cosines replacing old tanh(d/2) - detail::center_poincare_disk: Möbius centering for hyperbolic normalisation - normalise_euclidean: centroid → origin + PCA major-axis rotation - normalise_hyperbolic: Möbius centering in the Poincaré disk - normalise_spherical: Rodrigues rotation → north pole - euclidean_layout / hyper_ideal_layout: optional CutGraph* + HolonomyData* + normalise Bug fixes caught by new tests: - gauss_bonnet.hpp: enforce_gauss_bonnet had wrong sign for delta - cut_graph.hpp: boundary edges were incorrectly marked as cut edges 121 tests pass, 2 skipped (Hessian stubs). Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>	2026-05-13 01:15:41 +02:00
Tarik Moussa	24f7607b2d	docs: detailed layout comparison + uniformization porting roadmap ... Mathematical scope section: - Expanded layout comparison table with 4 concrete differences: (1) hyperbolic trilateration exact vs. tanh(d/2) approximation (2) closed mesh handling: holonomy/period matrices vs. seam flag (3) layout normalisation: Möbius vs. raw BFS output (4) Gauss–Bonnet pre-check: Java has it, C++ does not - Added Möbius trilateration code snippet showing exact implementation path - Added 10-row Java vs. C++ summary matrix For mathematicians section: - New subsection: "Porting the Java uniformization pipeline" Step 1: Gauss–Bonnet check (~30 lines, complete implementation template) Step 2: Homological basis / fundamental polygon cut (CutGraph struct + BFS hook) Step 3: Holonomy tracking (EuclideanHolonomy + MöbiusElement structs) Step 4: Period matrix extraction (genus 1 via holonomy translations, genus ≥ 2 via Fuchsian group) Step 5: Layout normalisation (canonical Möbius post-processing) Priority table: 6 steps, estimated effort, C++ hook location Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>	2026-05-13 00:53:47 +02:00
Tarik Moussa	b7593e3f6d	feat(phase5): Layout, CLI, JSON/XML serialisation — 95 tests ... Phase 5 complete: layout.hpp - euclidean_layout(): BFS unfolding in ℝ² using trilaterate_2d - spherical_layout(): BFS on S² using trilaterate_sph (spherical law of cosines) - hyper_ideal_layout(): BFS in Poincaré disk (tanh(d/2) Euclidean approx) - save_layout_off(): convenience OFF writer for 2-D and 3-D layouts serialization.hpp - save/load_result_json(): nlohmann/json; stores DOF vector + uv/pos layout - save/load_result_xml(): hand-written writer/parser; same schema conformallab_cli.cpp (rewritten) - CLI11 interface: -i/-o/-g/-j/-x/-s/-v - Dispatches to euclidean / spherical / hyper_ideal pipeline - Runs Newton, computes layout, saves OFF + JSON + XML examples/example_layout.cpp - Full round-trip demo: solve → layout → JSON/XML → reload → verify tests/cgal/test_layout.cpp (8 tests) - Euclidean_PreservesEdgeLengths, CorrectVertexCount, TriangleIsNonDegenerate - Spherical_PreservesArcLengths, PositionsOnUnitSphere - HyperIdeal_SuccessAndFinitePositions - Serialization.JSON_RoundTrip, XML_RoundTrip All 95 CGAL tests pass (2 skipped — Hessian stubs unchanged). Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>	2026-05-13 00:53:47 +02:00
Tarik Moussa	3f124eb071	feat(phase4): HyperIdeal Newton solver, SparseQR fallback, examples, docs ... Phase 4 complete — 87 CGAL tests pass, 2 skipped. Newton solver (phase4a): - hyper_ideal_hessian.hpp: symmetric FD Hessian (O(ε²), PSD by convexity) - newton_hyper_ideal(): Newton + backtracking for the HyperIdeal functional - detail::solve_with_fallback(): optional bool* fallback_used parameter - solve_linear_system(): public API exposing LDLT→SparseQR fallback SparseQR fallback tests (SparseQRFallback.*): - FullRankSystem_CorrectSolution: LDLT path, fallback_used=false - SingularMatrix_FallbackActivated: zero-pivot → QR activated, fallback_used=true - Euclidean_ClosedMeshNoPinConverges: gauge-mode null space handled via QR HyperIdeal Newton tests (NewtonSolver.HyperIdeal_*): - ConvergesTriangleAllVariable, ResultFieldsConsistent, ConvergesTetrahedron, SparseQRFallbackNoCrash - Natural-target base point (b=1.0, a=0.5) — x=0 is degenerate in log-space Pipeline tests (test_pipeline.cpp): - End-to-end: all three geometries, mesh I/O round-trip, solve+export Example programs (code/examples/): - example_euclidean.cpp: headless Euclidean pipeline - example_hyper_ideal.cpp: headless HyperIdeal pipeline - example_viewer.cpp: interactive libigl viewer with jet colour map README: - Mathematical scope table: C++ vs Java original (18 rows) - "For mathematicians" section: mental model, step-by-step new-functional guide, half-edge traversal snippets, recommended reading Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>	2026-05-13 00:11:25 +02:00
Tarik Moussa	5841646017	docs: update README — Phase 3 vollständig abgeschlossen (62 Tests) ... Mark all Phase 3 sub-phases (3a–3g) as done in the roadmap. Add euclidean_hessian and spherical_hessian to the feature table. Update status banner: 62 tests, Phase 4 is next. Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>	2026-05-12 17:25:26 +02:00
Tarik Moussa	8c353bb884	feat(phase3d+3e): port EuclideanCyclicFunctional + add SphericalFunctional gauge-fix ... Phase 3d — EuclideanCyclicFunctional: • euclidean_geometry.hpp: t-value / atan2 corner-angle formula with centering trick (μ = (Λ̃₁₂+Λ̃₂₃+Λ̃₃₁)/6) for numerical stability • euclidean_functional.hpp: EuclideanMaps bundle, gradient (G_v = Θ_v − Σα_v, G_e = α_opp⁺ + α_opp⁻ − φ_e), 10-point GL path-integral energy, gradient_check_euclidean — identical halfedge convention to SphericalFunctional • test_euclidean_functional.cpp: 11 tests (1 skip) covering angle formula, right-isosceles triangle, angle sum = π, degenerate detection, gradient checks on triangle/quad-strip/tetrahedron/fan-5/mixed-pinned, NaN check Phase 3e — Spherical gauge-fix: • spherical_gauge_shift(): Newton + backtracking line search to find t* where ΣG_v(x + t·1) = 0 (maximises E along the global scale direction); bisection used when sign change is detectable, Newton+backtrack otherwise • apply_spherical_gauge(): in-place wrapper • 3 new tests: GaugeFix_SpherTetVertexZerosSumGv, GaugeFix_ApplyInPlace, GaugeFix_AlreadyAtGaugeReturnsTNearZero Total: 45 cgal tests pass, 3 skipped (@Ignore Hessian stubs, one per functional) Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>	2026-05-12 07:39:14 +02:00
Tarik Moussa	dc0d3ca005	docs: add Phase 3d–4b roadmap to README ... Six concrete next steps toward Phase 3 completion and Phase 4 (solver): 3d EuclideanCyclicFunctional — most critical missing functional 3e Spherical gauge-fix (1D Brent along additive u constant) 3f Analytic Hessian via CGAL::Weights::cotangent_weight() 3g Consolidate duplicate PI constant 4a Minimal Newton solver with Eigen SimplicialLDLT 4b CGAL::IO read/write OBJ for mesh round-trip testing Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>	2026-05-12 00:25:36 +02:00
Tarik Moussa	a4c2a89e7e	feat(phase3c): port SphericalFunctional onto ConformalMesh; update README ... New headers: - spherical_geometry.hpp: spherical arc length l(λ) and half-angle formula for interior angles of a spherical triangle (SphericalFaceAngles struct) - spherical_functional.hpp: SphericalMaps bundle, setup/assign DOF helpers, compute_lambda0_from_mesh(), gradient (Θ_v − Σα_v; Schläfli edge formula), energy via 10-point Gauss-Legendre path integral, gradient_check_spherical() Updated: - mesh_builder.hpp: add make_spherical_tetrahedron() (vertices on unit sphere) and make_octahedron_face() (single right-angled spherical triangle) - tests/cgal/CMakeLists.txt: enable test_spherical_functional.cpp - README.md: rewrite for CGAL-package goal, two test targets, all headers, updated project tree, Phase progress table, key design decisions Tests (cgal.SphericalFunctional.*): 8 active + 1 skip - OctaFaceAnglesAreRightAngles, SpherTetAngleSumExceedsPi - GradientCheck_{OctaFaceVertex, SpherTetVertex, SpherTetAllDofs, SpherFan4Vertex, MixedPinnedVertices} - AnglesFiniteAtKnownPoint All 30 cgal.* tests pass (2 @Ignore skips). Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>	2026-05-12 00:01:24 +02:00
Tarik Moussa	e59f79a8e2	docs + ci: update README, add ci-cpp Docker image, use container in workflow ... README: - Remove stale Boost mention (unused dep, removed yesterday) - Document three build modes (tests-only / WITH_VIEWER / WITH_CGAL) with a comparison table and per-mode cmake commands - Add project structure overview - Fix C++20 → C++17 (actual standard used) - Fix clone URL and getting-started commands - Add CI section with Dockerfile build instructions CI: - Add .gitea/docker/Dockerfile.ci-cpp — ubuntu:22.04 with cmake, g++, git, and Node.js 20 pre-installed (Node.js needed for actions/checkout@v4 inside containers) - Update cpp-tests.yml to use ci-cpp container instead of installing build tools on every run; add JUnit XML output and summary step Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>	2026-05-09 21:49:44 +02:00
Tarik Moussa	d134add5a6	update readme	2026-03-07 11:25:56 +02:00
Tarik Moussa	14c825dcf0	v0	2026-03-06 21:55:16 +02:00
Tarik Moussa	e1a90dbd85	fix typo	2026-03-06 21:43:54 +02:00
Tarik Moussa	a140f439a6	README.md	2026-02-09 20:05:35 +02:00
user2595	a0dbdb8818	Initial commit	2026-02-09 18:39:03 +01:00