2 Commits

Author	SHA1	Message	Date
Tarik Moussa	62b02f88b9	docs(doxygen): 100% public-API coverage (228 → 0 undocumented) ... Completes the work begun in the previous commit on this branch. Every public symbol under code/include/ now carries a brief Doxygen comment (0 undocumented per scripts/doxygen-coverage.sh, with the `detail::` implementation namespaces excluded as before). Trajectory on this branch: start (after Doxyfile fix): 24.0 % (165 / 437 in the no-detail set was 105 / 437 when detail counted) after PR #17 base commit : 42.4 % (165 / 396) this commit : 100.0 % (396 / 396) Files touched (all .hpp / .h headers under code/include/): * cgal/Conformal_map_traits.h * clausen.hpp, conformal_mesh.hpp, constants.hpp (already docd) * cp_euclidean_functional.hpp, cut_graph.hpp, discrete_elliptic_utility.hpp * euclidean_functional.hpp, euclidean_geometry.hpp, euclidean_hessian.hpp * fundamental_domain.hpp, gauss_bonnet.hpp * hyper_ideal_{functional,geometry,hessian,utility,visualization_utility}.hpp * inversive_distance_functional.hpp, layout.hpp * matrix_utility.hpp, mesh_builder.hpp, mesh_io.hpp * newton_solver.hpp, p2_utility.hpp, period_matrix.hpp, projective_math.hpp * serialization.hpp, spherical_functional.hpp, spherical_geometry.hpp * spherical_hessian.hpp, viewer_utils.h CI: .gitea/workflows/doxygen-pages.yml now enforces `scripts/doxygen-coverage.sh --threshold 100`, so any future regression (a new public function landed without a `///` brief) fails the build before the Doxygen HTML is published to Codeberg Pages. Doxygen warnings remain at 0. Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>	2026-05-24 04:22:49 +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