perf(allocations): reduced overall allocations by 95%, increaseed jacobian applicatin by 2x

This commit uses global pre allocated work space to dramatically reduce memory usage and allocation time

CMakeLists.txt

@@ -60,6 +60,8 @@ target_sources(mean_field
         libmeanfield/impl/profile.cpp
         libmeanfield/impl/analysis/integral.cpp
         libmeanfield/impl/fem.cpp
+        libmeanfield/impl/fem/reference_tables.cpp
+        libmeanfield/impl/mapping/prepared_cache.cpp
         libmeanfield/impl/mapping/coefficients.cpp
         libmeanfield/impl/mapping/compactification/kelvin.cpp
         libmeanfield/impl/physics/gravity.cpp
@@ -76,6 +78,7 @@ target_sources(mean_field
         libmeanfield/impl/mapping/transformations.cpp
         libmeanfield/impl/deformation/nodal_radial_surface.cpp
         libmeanfield/impl/deformation/radial_extensions.cpp
+        libmeanfield/impl/deformation/safe_newton_step.cpp
         libmeanfield/impl/operators/gravity_field.cpp
         libmeanfield/impl/operators/gravity_field_jacobian.cpp
         libmeanfield/impl/operators/kernels/gravity_kernels.cpp
@@ -121,6 +124,8 @@ target_sources(mean_field
         FILE_SET CXX_MODULES FILES
         libmeanfield/interface/mean_field.cppm
         libmeanfield/interface/fem.cppm
+        libmeanfield/interface/fem/reference_tables.cppm
+        libmeanfield/interface/mapping/prepared_cache.cppm
         libmeanfield/interface/analysis/integral.cppm
         libmeanfield/interface/boundary/context.cppm
         libmeanfield/interface/mapping/coefficients.cppm
@@ -223,6 +228,7 @@ target_sources(mean_field
         libmeanfield/interface/deformation/vacuum_extension.cppm
         libmeanfield/interface/deformation/radial_extensions.cppm
         libmeanfield/interface/deformation/domain_deformation.cppm
+        libmeanfield/interface/deformation/safe_newton_step.cppm
         libmeanfield/interface/models/stellar_model.cppm
         libmeanfield/interface/operators/root_manifest.cppm
         libmeanfield/interface/operators/prepared_constraint.cppm
@@ -279,6 +285,8 @@ add_executable(tests
         tests/integrators/centrifugal.cpp
         tests/integrators/gravity.cpp
         tests/mapping/domain_mapper.cpp
+        tests/fem/reference_tables.cpp
+        tests/mapping/prepared_cache.cpp
         tests/mapping/compactification/kelvin.cpp
         tests/utils/blocks.cpp
         tests/utils/profiling.cpp
@@ -331,6 +339,7 @@ add_executable(tests
         tests/deformation/nodal_radial_surface.cpp
         tests/deformation/radial_extensions.cpp
         tests/deformation/domain_deformation.cpp
+        tests/deformation/safe_newton_step.cpp
         tests/operators/prepared_mass_normalization.cpp
         tests/operators/prepared_angular_momentum.cpp
         tests/operators/prepared_stellar_equilibrium.cpp
@@ -365,10 +374,19 @@ target_link_libraries(tests PRIVATE mean_field test_mod Catch2::Catch2 Boost::bo
 add_executable(sandbox EXCLUDE_FROM_ALL sandbox.cpp)
 target_link_libraries(sandbox PRIVATE mean_field)
 
+# Opt-in diagnostics using the same context and operators as the sandbox.
+add_executable(geometry_quality_experiment EXCLUDE_FROM_ALL experiments/geometry_quality_experiment.cpp)
+target_link_libraries(geometry_quality_experiment PRIVATE mean_field)
+
+# Independent n=1 reference and physical checks; does not change sandbox defaults.
+add_executable(polytrope_validation_experiment EXCLUDE_FROM_ALL experiments/polytrope_validation_experiment.cpp)
+target_link_libraries(polytrope_validation_experiment PRIVATE mean_field)
+
 add_executable(mpi_tests
         tests/mpi/mpi_test_main.cpp
         tests/mpi/distributed_execution.cpp
         tests/mpi/profiling.cpp
+        tests/deformation/safe_newton_step.cpp
 )
 target_link_libraries(mpi_tests PRIVATE mean_field test_mod Catch2::Catch2 Boost::boost)