feat(field-support): added field support system, mid migration

currently the barotope and the pressure force operator are migrated to the new support system
2026-08-23 10:13:53 -04:00
parent dc912fd15e
commit 0f3ca8050b
137 changed files with 29975 additions and 16389 deletions
--- a/libmeanfield/interface/operators/kernels/barotropic_closure_kernels.cppm
+++ b/libmeanfield/interface/operators/kernels/barotropic_closure_kernels.cppm
@@ -4,15 +4,26 @@ module;

 export module mean_field:operators.kernels.barotropic_closure;

+export import :eos.polytrope;
 export import :fem;
 export import :mapping.domain_mapper;
-export import :physics.barotrope;

 export namespace mean_field::operators::kernels {
+    /*
+     * Stateless full-MFEM reference kernels for
+     *
+     *     R_rho = \int_{Omega_star} (rho - rho_EOS(h)) q_rho dV.
+     *
+     * These functions intentionally remain expressed in complete MFEM true
+     * vectors. Solver/prepared-facing support reduction belongs to
+     * PreparedBarotropicClosureOperator through FieldDofMap. Keeping this
+     * layer full-space preserves an independent reference implementation for
+     * R K P tests of the reduced prepared operator.
+     */
    void apply_barotropic_closure(
        const fem::FEM &f,
        const mapping::DomainMapperStateless &domainMapper,
-        const physics::PolytropicBarotrope &barotrope,
+        const eos::Polytrope &equationOfState,
        const mfem::Vector &densityTrue,
        const mfem::Vector &enthalpyTrue,
        const mfem::Vector &displacementTrue,
@@ -22,7 +33,7 @@ export namespace mean_field::operators::kernels {
    void apply_barotropic_closure_density_action(
        const fem::FEM &f,
        const mapping::DomainMapperStateless &domainMapper,
-        const physics::PolytropicBarotrope &barotrope,
+        const eos::Polytrope &equationOfState,
        const mfem::Vector &densityVariationTrue,
        const mfem::Vector &displacementTrue,
        mfem::Vector &action
@@ -31,7 +42,7 @@ export namespace mean_field::operators::kernels {
    void apply_barotropic_closure_enthalpy_action(
        const fem::FEM &f,
        const mapping::DomainMapperStateless &domainMapper,
-        const physics::PolytropicBarotrope &barotrope,
+        const eos::Polytrope &equationOfState,
        const mfem::Vector &baseEnthalpyTrue,
        const mfem::Vector &enthalpyVariationTrue,
        const mfem::Vector &displacementTrue,
@@ -41,11 +52,11 @@ export namespace mean_field::operators::kernels {
    void apply_barotropic_closure_displacement_action(
        const fem::FEM &f,
        const mapping::DomainMapperStateless &domainMapper,
-        const physics::PolytropicBarotrope &barotrope,
+        const eos::Polytrope &equationOfState,
        const mfem::Vector &baseDensityTrue,
        const mfem::Vector &baseEnthalpyTrue,
        const mfem::Vector &displacementTrue,
        const mfem::Vector &displacementVariationTrue,
        mfem::Vector &action
    );
-} // namespace mean_field::operators::kernels
+} // namespace mean_field::operators::kernels
--- a/libmeanfield/interface/operators/kernels/gravity_displacement_force_kernels.cppm
+++ b/libmeanfield/interface/operators/kernels/gravity_displacement_force_kernels.cppm
@@ -0,0 +1,59 @@
+module;
+
+#include <mfem.hpp>
+
+export module mean_field:operators.kernels.gravity_displacement_force;
+
+export import :fem;
+export import :mapping.domain_mapper;
+
+export namespace mean_field::operators::kernels {
+    void apply_gravity_displacement_force_residual(
+        const fem::FEM &f,
+        const mapping::DomainMapperStateless &domainMapper,
+        const mfem::Vector &densityTrue,
+        const mfem::Vector &gravityGradientTrue,
+        const mfem::Vector &displacementTrue,
+        mfem::Vector &residualTrue
+    );
+
+    void apply_gravity_displacement_force_density_action(
+        const fem::FEM &f,
+        const mapping::DomainMapperStateless &domainMapper,
+        const mfem::Vector &densityVariationTrue,
+        const mfem::Vector &baseGravityGradientTrue,
+        const mfem::Vector &displacementTrue,
+        mfem::Vector &actionTrue
+    );
+
+    void apply_gravity_displacement_force_gradient_action(
+        const fem::FEM &f,
+        const mapping::DomainMapperStateless &domainMapper,
+        const mfem::Vector &baseDensityTrue,
+        const mfem::Vector &gravityGradientVariationTrue,
+        const mfem::Vector &displacementTrue,
+        mfem::Vector &actionTrue
+    );
+
+    void apply_gravity_displacement_force_displacement_action(
+        const fem::FEM &f,
+        const mapping::DomainMapperStateless &domainMapper,
+        const mfem::Vector &baseDensityTrue,
+        const mfem::Vector &baseGravityGradientTrue,
+        const mfem::Vector &displacementVariationTrue,
+        const mfem::Vector &displacementTrue,
+        mfem::Vector &actionTrue
+    );
+
+    void apply_gravity_displacement_force_complete_action(
+        const fem::FEM &f,
+        const mapping::DomainMapperStateless &domainMapper,
+        const mfem::Vector &baseDensityTrue,
+        const mfem::Vector &densityVariationTrue,
+        const mfem::Vector &baseGravityGradientTrue,
+        const mfem::Vector &gravityGradientVariationTrue,
+        const mfem::Vector &displacementVariationTrue,
+        const mfem::Vector &displacementTrue,
+        mfem::Vector &actionTrue
+    );
+} // namespace mean_field::operators::kernels
--- a/libmeanfield/interface/operators/kernels/pressure_force_kernels.cppm
+++ b/libmeanfield/interface/operators/kernels/pressure_force_kernels.cppm
@@ -6,15 +6,35 @@ export module mean_field:operators.kernels.pressure_force;

 export import :fem;
 export import :mapping.domain_mapper;
-export import :physics.barotrope;
+export import :eos.polytrope;

 export namespace mean_field::operators::kernels {
    void apply_pressure_force_residual(
        const fem::FEM &f,
        const mapping::DomainMapperStateless &domainMapper,
-        const physics::PolytropicBarotrope &barotrope,
+        const eos::Polytrope &barotrope,
        const mfem::Vector &enthalpyTrue,
        const mfem::Vector &displacementTrue,
        mfem::Vector &residualTrue
    );
+
+    void apply_pressure_force_enthalpy_action(
+        const fem::FEM &f,
+        const mapping::DomainMapperStateless &domainMapper,
+        const eos::Polytrope &barotrope,
+        const mfem::Vector &baseEnthalpyTrue,
+        const mfem::Vector &enthalpyVariationTrue,
+        const mfem::Vector &displacementTrue,
+        mfem::Vector &actionTrue
+    );
+
+    void apply_pressure_force_displacement_action(
+        const fem::FEM &f,
+        const mapping::DomainMapperStateless &domainMapper,
+        const eos::Polytrope &barotrope,
+        const mfem::Vector &baseEnthalpyTrue,
+        const mfem::Vector &displacementVariationTrue,
+        const mfem::Vector &displacementTrue,
+        mfem::Vector &actionTrue
+    );
 } // namespace mean_field::operators::kernels
--- a/libmeanfield/interface/operators/kernels/rotation_displacement_force_kernels.cppm
+++ b/libmeanfield/interface/operators/kernels/rotation_displacement_force_kernels.cppm
@@ -0,0 +1,64 @@
+module;
+
+#include <mfem.hpp>
+
+export module mean_field:operators.kernels.rotational_displacement_force;
+
+export import :fem;
+export import :mapping.domain_mapper;
+export import :physics.rigid_rotation;
+
+export namespace mean_field::operators::kernels {
+    /*
+     * Rotational contribution to the displacement row:
+     *
+     *   R_d^rotation(w)
+     *     = -int_{Omega_star} rho grad(Psi_rotation) . w dV
+     *     =  int_{Omega_star}
+     *          rho [Omega x (Omega x (x - x_0))] . w dV.
+     *
+     * RigidRotation stores the positive potential
+     *
+     *   Psi_rotation = 0.5 |Omega x (x - x_0)|^2.
+     *
+     * Vacuum elements are excluded exactly.
+     */
+    void apply_rotational_displacement_force_residual(
+        const fem::FEM &f,
+        const mapping::DomainMapperStateless &domainMapper,
+        const physics::RigidRotation &rotation,
+        const mfem::Vector &densityTrue,
+        const mfem::Vector &displacementTrue,
+        mfem::Vector &residualTrue
+    );
+
+    void apply_rotational_displacement_force_density_action(
+        const fem::FEM &f,
+        const mapping::DomainMapperStateless &domainMapper,
+        const physics::RigidRotation &rotation,
+        const mfem::Vector &densityVariationTrue,
+        const mfem::Vector &displacementTrue,
+        mfem::Vector &actionTrue
+    );
+
+    void apply_rotational_displacement_force_displacement_action(
+        const fem::FEM &f,
+        const mapping::DomainMapperStateless &domainMapper,
+        const physics::RigidRotation &rotation,
+        const mfem::Vector &baseDensityTrue,
+        const mfem::Vector &displacementVariationTrue,
+        const mfem::Vector &displacementTrue,
+        mfem::Vector &actionTrue
+    );
+
+    void apply_rotational_displacement_force_complete_action(
+        const fem::FEM &f,
+        const mapping::DomainMapperStateless &domainMapper,
+        const physics::RigidRotation &rotation,
+        const mfem::Vector &baseDensityTrue,
+        const mfem::Vector &densityVariationTrue,
+        const mfem::Vector &displacementVariationTrue,
+        const mfem::Vector &displacementTrue,
+        mfem::Vector &actionTrue
+    );
+} // namespace mean_field::operators::kernels