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	194effba97	feat(phase3f+3g): analytical Hessians + PI consolidation ... Phase 3g — constants.hpp: - Introduce conformallab::PI and TWO_PI in a single constants.hpp - Remove scattered local PI/pi definitions from hyper_ideal_geometry.hpp, hyper_ideal_utility.hpp, euclidean_functional.hpp, mesh_builder.hpp, spherical_geometry.hpp (backward-compatible PI_SPHER alias kept) Phase 3f — Euclidean Hessian (euclidean_hessian.hpp): - Cotangent-Laplace operator (Pinkall–Polthier 1993) - euclidean_cot_weights() helper + euclidean_hessian() + hessian_check_euclidean() - Correct Pinkall–Polthier 1/2 normalization factor - 8 tests: cot weights, symmetry, null-space (H·1=0), PSD, FD × 4 meshes Phase 3f — Spherical Hessian (spherical_hessian.hpp): - Derives ∂α_i/∂u_j directly from the spherical law of cosines: ∂α1/∂l_opp = sin(l_opp) / [sin(l_a)·sin(l_b)·sin(α1)] ∂α1/∂l_adj = [cot(l_adj)·cos(α1) − cot(l_other)] / sin(α1) then chains with ∂l/∂λ = tan(l/2) - spherical_cot_weights() kept as a standalone helper (tested separately) - 8 tests: cot weights, symmetry, correct null-space & sign-convention (H·1 ≠ 0; H is NSD at equilibrium), FD × 3 meshes All 62 cgal tests pass (3 skipped as before). Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>	2026-05-12 17:22:28 +02:00