diff --git a/src/reactmicp/systems/unsaturated/equilibrium_stagger.cpp b/src/reactmicp/systems/unsaturated/equilibrium_stagger.cpp index f738bea..fda1604 100644 --- a/src/reactmicp/systems/unsaturated/equilibrium_stagger.cpp +++ b/src/reactmicp/systems/unsaturated/equilibrium_stagger.cpp @@ -1,476 +1,476 @@ /*------------------------------------------------------------------------------ Copyright (c)2015 F. Georget , Princeton University All rights reserved. Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met: 1. Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer. 2. Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution. 3. Neither the name of the copyright holder nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission. THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. ------------------------------------------------------------------------------*/ #include "equilibrium_stagger.hpp" #include "variables.hpp" #include "equilibrium_constraints.hpp" #include "../../solver/staggers_base/stagger_structs.hpp" #include "../../../dfpm/meshes/mesh1d.hpp" #include "../../../database/data_container.hpp" #include "../../../utils/compat.hpp" #include "../../../specmicp/adimensional/adimensional_system_solution.hpp" #include "../../../specmicp/adimensional/adimensional_system_solution_extractor.hpp" #include "../../../specmicp/adimensional/adimensional_system_solver.hpp" #include "../../../utils/log.hpp" namespace specmicp { namespace reactmicp { namespace systems { namespace unsaturated { // ============================================ // // Declaration of implementation details // // ============================================ struct EquilibriumStagger::EquilibriumStaggerImpl { scalar_t m_dt {-1}; mesh::Mesh1DPtr m_mesh; database::RawDatabasePtr m_database; std::shared_ptr m_constraints; EquilibriumStaggerImpl( std::shared_ptr variables, std::shared_ptr constraints ): m_mesh(variables->get_mesh()), m_database(variables->get_database()), m_constraints(constraints) {} scalar_t dt() {return m_dt;} int compute_one_node(index_t node, UnsaturatedVariables * const vars); void compute_total_concentrations( index_t node, Vector& total_concentrations, UnsaturatedVariables * const vars ); void analyse_solution( index_t node, AdimensionalSystemSolution& solution, UnsaturatedVariables * const vars ); void initialize_timestep_one_node(index_t node, UnsaturatedVariables* vars); void initialize(UnsaturatedVariables* vars); void initialize_timestep(scalar_t dt, UnsaturatedVariables* vars); StaggerReturnCode restart_timestep(UnsaturatedVariables* vars); units::UnitsSet& get_units() { return m_constraints->get_options().units_set; } }; using TrueConstPtr = UnsaturatedVariables * const; inline TrueConstPtr cast_to_var(solver::VariablesBase * const var) { return static_cast(var); } // ============================================ // // Implementation // // ============================================ EquilibriumStagger::EquilibriumStagger( std::shared_ptr variables, std::shared_ptr constraints ): - m_impl(make_unique(variables, constraints)) + m_impl(utils::make_pimpl(variables, constraints)) { } EquilibriumStagger::~EquilibriumStagger() = default; //! \brief Initialize the stagger at the beginning of the computation //! //! \param var a shared_ptr to the variables void EquilibriumStagger::initialize(VariablesBase * const var) { TrueConstPtr true_vars = cast_to_var(var); m_impl->initialize(true_vars); } //! \brief Initialize the stagger at the beginning of an iteration //! //! This is where the predictor can be saved, the first trivial iteration done, ... //! //! \param dt the duration of the timestep //! \param var a shared_ptr to the variables void EquilibriumStagger::initialize_timestep( scalar_t dt, VariablesBase * const var ) { TrueConstPtr true_vars = cast_to_var(var); m_impl->initialize_timestep(dt, true_vars); } //! \brief Solve the equation for the timestep //! //! \param var a shared_ptr to the variables EquilibriumStagger::StaggerReturnCode EquilibriumStagger::restart_timestep(VariablesBase * const var) { TrueConstPtr true_vars = cast_to_var(var); return m_impl->restart_timestep(true_vars); } int EquilibriumStagger::EquilibriumStaggerImpl::compute_one_node( index_t node, UnsaturatedVariables * const vars ) { AdimensionalSystemConstraints constraints = m_constraints->get_constraints(node); compute_total_concentrations(node, constraints.total_concentrations, vars); // set partial pressure model { user_model_saturation_f callable = vars->get_vapor_pressure_model(); water_partial_pressure_f pv_model = [callable, node](scalar_t sat){ return callable(node, sat); }; constraints.set_water_partial_pressure_model(pv_model); } // We use the current value of the saturation to avoid converging // to the previous solution // This is necessary because the update to the saturation is very small const AdimensionalSystemSolution& previous_solution = vars->get_adim_solution(node); Vector x; AdimensionalSystemSolver the_solver; if (likely(previous_solution.is_valid)) // should always be true { const auto porosity = vars->get_porosity()(node); const auto saturation = vars->get_liquid_saturation()(node); the_solver = AdimensionalSystemSolver( vars->get_database(), constraints, previous_solution, m_constraints->get_options() ); x = previous_solution.main_variables; // we use the new value of the saturation to avoid a change // to small to be detected by the speciaion solver x(0) = porosity*saturation; // x(0) = volume fraction water } else { const auto porosity = vars->get_porosity()(node); const auto saturation = vars->get_liquid_saturation()(node); the_solver = AdimensionalSystemSolver( vars->get_database(), constraints, m_constraints->get_options() ); the_solver.initialise_variables(x, porosity*saturation, -3); } // micpsolver::MiCPPerformance perf = the_solver.solve(x); if (perf.return_code < micpsolver::MiCPSolverReturnCode::Success) { ERROR << "Failed to solve equilibrium at node " << node << ". \n" << "Return code : " << (int) perf.return_code; return -1; } AdimensionalSystemSolution solution = the_solver.get_raw_solution(x); analyse_solution(node, solution, vars); vars->set_adim_solution(node, solution); return 0; } void EquilibriumStagger::EquilibriumStaggerImpl::compute_total_concentrations( index_t node, Vector& total_concentrations, UnsaturatedVariables * const vars ) { total_concentrations.resize(m_database->nb_component()); const scalar_t saturation = vars->get_liquid_saturation()(node); const scalar_t porosity = vars->get_porosity()(node); const scalar_t rt = vars->get_rt(); // water { const scalar_t ctilde_w = vars->get_water_aqueous_concentration()(node); const scalar_t cbar_w = vars->get_solid_concentration(0)(node); scalar_t c_w = saturation*porosity*ctilde_w + cbar_w; if (vars->component_has_gas(0)) { const scalar_t pv_w = vars->get_pressure_main_variables(0)(node); c_w += (1.0-saturation)*porosity*pv_w/rt; } total_concentrations(0) = c_w; } total_concentrations(1) = 0.0; // aqueous components for (index_t component: m_database->range_aqueous_component()) { const scalar_t ctilde_i = vars->get_aqueous_concentration(component)(node); const scalar_t cbar_i = vars->get_solid_concentration(component)(node); scalar_t c_i = saturation*porosity*ctilde_i + cbar_i; if (vars->component_has_gas(component)) { const scalar_t pv_i = vars->get_pressure_main_variables(component)(node); c_i += (1.0-saturation)*porosity*pv_i/rt; } total_concentrations(component) = c_i; } } void EquilibriumStagger::EquilibriumStaggerImpl::analyse_solution( index_t node, AdimensionalSystemSolution& solution, UnsaturatedVariables * const vars ) { AdimensionalSystemSolutionExtractor extr(solution, m_database, get_units()); const scalar_t saturation = extr.saturation_water(); const scalar_t sat_g = 1-saturation; const scalar_t rho_l = extr.density_water(); const scalar_t porosity = extr.porosity(); const scalar_t rt = vars->get_rt(); // porosity SecondaryTransientVariable& porosity_vars = vars->get_porosity(); const scalar_t porosity_0 = porosity_vars.predictor(node); const scalar_t porosity_vel = (porosity - porosity_0)/m_dt; porosity_vars.variable(node) = porosity; porosity_vars.velocity(node) = porosity_vel; // water // saturation MainVariable& satvars = vars->get_liquid_saturation(); const scalar_t saturation_0 = satvars.predictor(node); const scalar_t sat_vel = (saturation - saturation_0)/m_dt; satvars.variable(node) = saturation; satvars.velocity(node) = sat_vel; { // total aqueous concentration SecondaryTransientVariable& cwtilde_vars = vars->get_water_aqueous_concentration(); const scalar_t cwtilde = rho_l*extr.total_aqueous_concentration(0); const scalar_t cwtilde_0 = cwtilde_vars.predictor(node); const scalar_t cwtilde_vel = (cwtilde - cwtilde_0)/m_dt; cwtilde_vars.variable(node) = cwtilde; cwtilde_vars.velocity(node) = cwtilde_vel; // total solid concentration MainVariable& solid_vars = vars->get_solid_concentration(0); const scalar_t cwbar = extr.total_solid_concentration(0); const scalar_t cwbar_0 = solid_vars.predictor(node); const scalar_t cwbar_vel = (cwbar - cwbar_0)/m_dt; solid_vars.variable(node) = cwbar; solid_vars.velocity(node) = cwbar_vel; solid_vars.chemistry_rate(node) = - cwbar_vel; // vapor pressure if (vars->component_has_gas(0)) { MainVariable& pres_vars = vars->get_pressure_main_variables(0); const scalar_t pv = vars->get_vapor_pressure_model()(node, saturation); const scalar_t pv_0 = pres_vars.predictor(node); const scalar_t pv_vel = (pv - pv_0)/m_dt; pres_vars.variable(node) = pv; pres_vars.velocity(node) = pv_vel; const scalar_t transient = ( (pv*porosity*sat_g) - (pv_0*porosity_0*(1-saturation_0)) )/ (rt*m_dt); const scalar_t pv_chem_rate = - transient + pres_vars.transport_fluxes(node); pres_vars.chemistry_rate(node) = pv_chem_rate; } } // aqueous components for (index_t component: m_database->range_aqueous_component()) { // total aqueous concentration MainVariable& aqconc = vars->get_aqueous_concentration(component); const scalar_t ctildei = rho_l*extr.total_aqueous_concentration(component); const scalar_t ctildei_0 = aqconc.predictor(node); const scalar_t ctildei_vel = (ctildei - ctildei_0) / m_dt; aqconc.variable(node) = ctildei; aqconc.velocity(node) = ctildei_vel; // total solid concentration MainVariable& solconc = vars->get_solid_concentration(component); const scalar_t cbari = extr.total_solid_concentration(component); const scalar_t cbari_0 = solconc.predictor(node); const scalar_t cbari_vel = (cbari - cbari_0) / m_dt; solconc.variable(node) = cbari; solconc.velocity(node) = cbari_vel; solconc.chemistry_rate(node) = - cbari_vel; // partial pressure if (vars->component_has_gas(component)) { MainVariable& pres_vars = vars->get_pressure_main_variables(component); index_t id_g = vars->get_id_gas(component); const scalar_t pi = extr.fugacity_gas(id_g)*vars->get_total_pressure(); const scalar_t pi_0 = pres_vars.predictor(node); const scalar_t pi_vel = (pi - pi_0) / m_dt; pres_vars.variable(node) = pi; pres_vars.velocity(node) = pi_vel; const scalar_t transient = ( (pi*porosity*sat_g) - (pi_0*porosity_0*(1.0-saturation_0)) ) / (rt * m_dt); const scalar_t pi_chem_rate = - transient + pres_vars.transport_fluxes(node); pres_vars.chemistry_rate(node) = pi_chem_rate; } } } void EquilibriumStagger::EquilibriumStaggerImpl::initialize_timestep_one_node( index_t node, UnsaturatedVariables * const vars ) { SecondaryTransientVariable& porosity = vars->get_porosity(); porosity.predictor = porosity.variable; porosity.velocity.setZero(); } EquilibriumStagger::StaggerReturnCode EquilibriumStagger::EquilibriumStaggerImpl::restart_timestep( UnsaturatedVariables* vars ) { int sum_retcode = 0; #if SPECMICP_USE_OPENMP #pragma omp parallel for \ reduction(+: sum_retcode) #endif for (index_t node=0; nodenb_nodes(); ++node) { if (m_constraints->is_fixed_node(node)) continue; sum_retcode += compute_one_node(node, vars); } if (sum_retcode != 0) { return StaggerReturnCode::UnknownError; } return StaggerReturnCode::ResidualMinimized; } void EquilibriumStagger::EquilibriumStaggerImpl::initialize_timestep( scalar_t dt, UnsaturatedVariables* vars ) { m_dt = dt; // initialize //water { MainVariable& cbar_w = vars->get_solid_concentration(0); cbar_w.predictor = cbar_w.variable; cbar_w.velocity.setZero(); } // aqueous component for (index_t component: m_database->range_aqueous_component()) { MainVariable& cbar_i = vars->get_solid_concentration(component); cbar_i.predictor = cbar_i.variable; cbar_i.velocity.setZero(); } for (auto node: m_mesh->range_nodes()) { initialize_timestep_one_node(node, vars); } } void EquilibriumStagger::EquilibriumStaggerImpl::initialize( UnsaturatedVariables * const vars ) { // do nothing by default } } //end namespace unsaturated } //end namespace systems } //end namespace reactmicp } //end namespace specmicp diff --git a/src/reactmicp/systems/unsaturated/equilibrium_stagger.hpp b/src/reactmicp/systems/unsaturated/equilibrium_stagger.hpp index 245cf42..8251bb1 100644 --- a/src/reactmicp/systems/unsaturated/equilibrium_stagger.hpp +++ b/src/reactmicp/systems/unsaturated/equilibrium_stagger.hpp @@ -1,98 +1,99 @@ /*------------------------------------------------------------------------------ Copyright (c) 2015 F. Georget , Princeton University All rights reserved. Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met: 1. Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer. 2. Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution. 3. Neither the name of the copyright holder nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission. THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. ------------------------------------------------------------------------------*/ #ifndef SPECMICP_REACTMICP_SYSTEMS_UNSATURATED_EQUILIBRIUMSTAGGER_HPP #define SPECMICP_REACTMICP_SYSTEMS_UNSATURATED_EQUILIBRIUMSTAGGER_HPP #include "../../solver/staggers_base/chemistry_stagger_base.hpp" +#include "../../../utils/pimpl_ptr.hpp" namespace specmicp { namespace reactmicp { namespace systems { namespace unsaturated { class EquilibriumConstraints; class UnsaturatedVariables; class SPECMICP_DLL_PUBLIC EquilibriumStagger: public solver::ChemistryStaggerBase { public: using StaggerReturnCode = solver::StaggerReturnCode; using VariablesBase = solver::VariablesBase; EquilibriumStagger( std::shared_ptr variables, std::shared_ptr constraints ); ~EquilibriumStagger(); //! \brief Initialize the stagger at the beginning of the computation //! //! \param var a shared_ptr to the variables void initialize(VariablesBase * const var); //! \brief Initialize the stagger at the beginning of an iteration //! //! This is where the predictor can be saved, the first trivial iteration done, ... //! //! \param dt the duration of the timestep //! \param var a shared_ptr to the variables void initialize_timestep(scalar_t dt, VariablesBase * const var); //! \brief Solve the equation for the timestep //! //! \param var a shared_ptr to the variables StaggerReturnCode restart_timestep(VariablesBase * const var); private: struct SPECMICP_DLL_LOCAL EquilibriumStaggerImpl; - std::unique_ptr m_impl; + utils::pimpl_ptr m_impl; }; //! \brief Return an equilibrium stagger inline std::shared_ptr equilibrium_stagger( std::shared_ptr variables, std::shared_ptr constraints ) { return std::make_shared(variables, constraints); } } //end namespace unsaturated } //end namespace systems } //end namespace reactmicp } //end namespace specmicp #endif // SPECMICP_REACTMICP_SYSTEMS_UNSATURATED_EQUILIBRIUMSTAGGER_HPP diff --git a/src/reactmicp/systems/unsaturated/transport_stagger.cpp b/src/reactmicp/systems/unsaturated/transport_stagger.cpp index 4d40e52..a217995 100644 --- a/src/reactmicp/systems/unsaturated/transport_stagger.cpp +++ b/src/reactmicp/systems/unsaturated/transport_stagger.cpp @@ -1,1084 +1,1084 @@ /*------------------------------------------------------------------------------- Copyright (c) 2015 F. Georget , Princeton University All rights reserved. Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met: 1. Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer. 2. Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution. 3. Neither the name of the copyright holder nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission. THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. -----------------------------------------------------------------------------*/ #include "transport_stagger.hpp" #include "../../solver/staggers_base/stagger_structs.hpp" #include "variables.hpp" #include "variables_box.hpp" #include "saturation_equation.hpp" #include "saturation_pressure_equation.hpp" #include "pressure_equation.hpp" #include "aqueous_equation.hpp" #include "aqueous_pressure_equation.hpp" #include "../../../database/database_holder.hpp" #include "../../../dfpmsolver/parabolic_driver.hpp" #include "../../../utils/log.hpp" #include namespace specmicp { namespace dfpmsolver { extern template class ParabolicDriver; extern template class ParabolicDriver; extern template class ParabolicDriver; extern template class ParabolicDriver; extern template class ParabolicDriver; } //end namespace dfpmsolver namespace reactmicp { namespace systems { namespace unsaturated { //! \brief Type of the equation //! \internal enum class EquationType { Saturation, LiquidAqueous, Pressure }; //! \brief Format type to a string (for message error) //! \internal static std::string to_string(EquationType eq_type); //! \brief Format DFPM solver retcode to a string static std::string to_string(dfpmsolver::ParabolicDriverReturnCode retcode); // forward declaration of wrapper classes // They are defined at the bootom of this file class TaskBase; class SaturationTask; using VariablesBase = solver::VariablesBase; // =================================== // // // // Declaration of the implementation // // // // =================================== // //! \brief Implementation class for the Unsaturated transport stagger //! \internal //! //! This class does all the work //! It was designed to be OpenMP compatible class UnsaturatedTransportStagger::UnsaturatedTransportStaggerImpl { public: // Constructor // ----------- UnsaturatedTransportStaggerImpl( UnsaturatedVariablesPtr variables, const TransportConstraints& constraints, bool merge_saturation_pressure, bool merge_aqueous_pressure ); // Main functions // -------------- //! \brief Return the residual scalar_t get_residual(UnsaturatedVariables * const vars); //! \brief Return the first residual (start of timestep) scalar_t get_residual_0(UnsaturatedVariables * const vars); //! \brief Return the update (norm of velocity vector) scalar_t get_update(UnsaturatedVariables * const vars); //! \brief Initialize timestep void initialize_timestep( scalar_t dt, UnsaturatedVariables * const vars); //! \brief Restart the timestep solver::StaggerReturnCode restart_timestep(UnsaturatedVariables* vars); // Timestep management // ------------------- //! \brief Save the timestep void save_dt(scalar_t dt) {m_dt = dt;} //! \brief Return the timestep scalar_t get_dt() {return m_dt;} // Task index // ---------- index_t& id_aqueous_task(index_t component) { return m_aq_equation_task[static_cast(component)]; } index_t id_aqueous_task(index_t component) const { return m_aq_equation_task[static_cast(component)]; } index_t& id_gas_task(index_t component) { return m_aq_equation_task[static_cast(component)]; } index_t id_gas_tasj(index_t component) const { return m_aq_equation_task[static_cast(component)]; } //! \brief Return the options of the saturation equation dfpmsolver::ParabolicDriverOptions* get_saturation_options(); //! \brief Return the options of aqueous equation of component dfpmsolver::ParabolicDriverOptions* get_aqueous_options(index_t component); //! \brief Return the options of gas equation of component dfpmsolver::ParabolicDriverOptions* get_gas_options(index_t component); private: scalar_t m_norm_0 {1.0}; // timestep management scalar_t m_dt {-1.0}; //! \brief The saturation equations std::unique_ptr m_saturation_equation; // Equation and solver std::vector> m_equation_list; std::vector m_aq_equation_task; std::vector m_gas_equation_task; std::vector m_merged_gas; }; // Main functions // =============== // call of the implementation UnsaturatedTransportStagger::UnsaturatedTransportStagger( std::shared_ptr variables, const TransportConstraints& constraints, bool merge_saturation_pressure, bool merge_aqueous_pressure ): - m_impl(make_unique( + m_impl(utils::make_pimpl( variables, constraints, merge_saturation_pressure, merge_aqueous_pressure )) { } UnsaturatedTransportStagger::~UnsaturatedTransportStagger() = default; static UnsaturatedVariables * const get_var(VariablesBase * const var) { return static_cast(var); } void UnsaturatedTransportStagger::initialize_timestep( scalar_t dt, VariablesBase* var ) { m_impl->initialize_timestep(dt, get_var(var)); } solver::StaggerReturnCode UnsaturatedTransportStagger::restart_timestep(VariablesBase * const var) { return m_impl->restart_timestep(get_var(var)); } scalar_t UnsaturatedTransportStagger::get_residual(VariablesBase * const var) { return m_impl->get_residual(get_var(var)); } scalar_t UnsaturatedTransportStagger::get_residual_0(VariablesBase * const var) { return m_impl->get_residual_0(get_var(var)); } scalar_t UnsaturatedTransportStagger::get_update(VariablesBase * const var) { return m_impl->get_update(get_var(var)); } dfpmsolver::ParabolicDriverOptions* UnsaturatedTransportStagger::get_saturation_options() { return m_impl->get_saturation_options(); } dfpmsolver::ParabolicDriverOptions* UnsaturatedTransportStagger::get_aqueous_options(index_t component) { return m_impl->get_aqueous_options(component); } dfpmsolver::ParabolicDriverOptions* UnsaturatedTransportStagger::get_gas_options(index_t component) { return m_impl->get_gas_options(component); } // =============================== // // =============================== // // // // Implementation details // // ---------------------- // // // // =============================== // // =============================== // // 2 main sections // - Solver wrappers : wrapper around 1 couple equation/solver // - UnsaturatedTransportStaggerImpl : call the wrappers // =============================== // // // // Solver wrappers // // // // =============================== // // This wrappers are used to abstract the residual computation // and the methods to solve every equations //! \brief Base class for a task //! //! A task is how we solve governing equations, //! and obtain residuals and update //! //! \internal class SPECMICP_DLL_LOCAL TaskBase { public: TaskBase(index_t component, EquationType eq_type): m_type(eq_type), m_component(component) {} //! \brief Compute the squared residuals virtual scalar_t compute_squared_residual( UnsaturatedVariables * const vars ) = 0; //! \brief Compute the squared residuals at the beginning of the timestep virtual scalar_t compute_squared_residual_0( UnsaturatedVariables * const vars ) = 0; //! \brief Compute the squared update of the variables virtual scalar_t compute_squared_update( UnsaturatedVariables * const vars ) = 0; //! \brief Initialize the timestep virtual void initialize_timestep( scalar_t dt, UnsaturatedVariables * const vars ) = 0; //! \brief Solve the governing equation virtual dfpmsolver::ParabolicDriverReturnCode restart_timestep( UnsaturatedVariables * const vars ) = 0; //! \brief Return the component index (in the db) index_t component() {return m_component;} //! \brief The equation type EquationType equation_type() {return m_type;} private: EquationType m_type; index_t m_component; }; //! \brief Base class for a equation solver //! //! \internal template class SPECMICP_DLL_LOCAL EquationTask: public TaskBase { public: using EqT = typename traits::EqT; using SolverT = typename traits::SolverT; EquationTask( index_t component, mesh::Mesh1DPtr the_mesh, typename traits::VariableBoxT& variables, const TransportConstraints& constraints ): TaskBase(component, traits::equation_type), m_equation(the_mesh, variables, constraints), m_solver(m_equation) {} EquationTask( index_t component, mesh::Mesh1DPtr the_mesh, typename traits::VariableBoxT& variables, const TransportConstraints& constraints, scalar_t scaling ): TaskBase(component, traits::equation_type), m_equation(the_mesh, variables, constraints), m_solver(m_equation) { m_equation.set_scaling(scaling); } Derived* derived() {return static_cast(this);} // This function must be implemented by subclass MainVariable& get_var(UnsaturatedVariables * const vars) { return derived()->get_var(vars); } scalar_t compute_squared_residual( UnsaturatedVariables * const vars ) override { Vector residuals; const MainVariable& main = get_var(vars); m_equation.compute_residuals(main.variable, main.velocity, residuals, true); return residuals.squaredNorm()/m_norm_square_0; } scalar_t compute_squared_residual_0( UnsaturatedVariables * const vars ) override { Vector residuals; const MainVariable& main = get_var(vars); m_equation.compute_residuals(main.variable, main.velocity, residuals, false); m_norm_square_0 = residuals.squaredNorm(); if (m_norm_square_0 < 1e-8) m_norm_square_0 = 1.0; return 1.0; } scalar_t compute_squared_update( UnsaturatedVariables * const vars ) override { const MainVariable& main = get_var(vars); return main.velocity.squaredNorm(); } void initialize_timestep( scalar_t dt, UnsaturatedVariables * const vars ) override { m_dt = dt; MainVariable& main = get_var(vars); main.predictor = main.variable; main.transport_fluxes.setZero(); main.velocity.setZero(); m_solver.initialize_timestep(dt, get_var(vars).variable); } dfpmsolver::ParabolicDriverReturnCode restart_timestep( UnsaturatedVariables * const vars ) override { MainVariable& main = get_var(vars); m_solver.velocity() = main.velocity; auto retcode = m_solver.restart_timestep(main.variable); if (retcode > dfpmsolver::ParabolicDriverReturnCode::NotConvergedYet) { main.velocity = m_solver.velocity(); } return retcode; } dfpmsolver::ParabolicDriverOptions& get_options() { return m_solver.get_options(); } const dfpmsolver::ParabolicDriverOptions& get_options() const { return m_solver.get_options(); } scalar_t get_dt() {return m_dt;} protected: scalar_t m_norm_square_0 {-1}; scalar_t m_dt {-1}; EqT m_equation; SolverT m_solver; }; //! \brief Traits struct for the SaturationTask class //! //! \internal struct SPECMICP_DLL_LOCAL SaturationTaskTraits { using EqT = SaturationEquation; using SolverT = dfpmsolver::ParabolicDriver; using VariableBoxT = SaturationVariableBox; static constexpr EquationType equation_type {EquationType::Saturation}; }; //! \brief Wrapper for the saturation equation solver //! //! \internal class SPECMICP_DLL_LOCAL SaturationTask: public EquationTask { using base = EquationTask; public: SaturationTask( index_t component, mesh::Mesh1DPtr the_mesh, SaturationTaskTraits::VariableBoxT&& variables, const TransportConstraints& constraints ): EquationTask( component, the_mesh, variables, constraints) {} SaturationTask( index_t component, mesh::Mesh1DPtr the_mesh, SaturationTaskTraits::VariableBoxT&& variables, const TransportConstraints& constraints, scalar_t scaling ): EquationTask( component, the_mesh, variables, constraints, scaling) {} MainVariable& get_var(UnsaturatedVariables * const vars) { return vars->get_liquid_saturation(); } // Also take into account the solid total concentration scalar_t compute_squared_update( UnsaturatedVariables * const vars ) override { scalar_t solid_update = vars->get_solid_concentration(component()).velocity.squaredNorm(); return solid_update + base::compute_squared_update(vars); } }; //! \brief Traits struct for the SaturationPressureTask class //! //! \internal struct SPECMICP_DLL_LOCAL SaturationPressureTaskTraits { using EqT = SaturationPressureEquation; using SolverT = dfpmsolver::ParabolicDriver; using VariableBoxT = SaturationPressureVariableBox; static constexpr EquationType equation_type {EquationType::Saturation}; }; //! \brief Wrapper for the saturation equation solver //! //! \internal class SPECMICP_DLL_LOCAL SaturationPressureTask: public EquationTask { using base = EquationTask; public: SaturationPressureTask( index_t component, mesh::Mesh1DPtr the_mesh, SaturationPressureTaskTraits::VariableBoxT&& variables, const TransportConstraints& constraints ): EquationTask( component, the_mesh, variables, constraints) {} SaturationPressureTask( index_t component, mesh::Mesh1DPtr the_mesh, SaturationPressureTaskTraits::VariableBoxT&& variables, const TransportConstraints& constraints, scalar_t scaling ): EquationTask( component, the_mesh, variables, constraints, scaling) {} MainVariable& get_var(UnsaturatedVariables * const vars) { return vars->get_liquid_saturation(); } // Also take into account the solid total concentration scalar_t compute_squared_update( UnsaturatedVariables * const vars ) override { scalar_t solid_update = vars->get_solid_concentration(component()).velocity.squaredNorm(); return solid_update + base::compute_squared_update(vars); } }; //! \brief Traits struct for the LiquidAqueousTask class //! //! \internal struct SPECMICP_DLL_LOCAL LiquidAqueousTaskTraits { using EqT = AqueousTransportEquation; using SolverT = dfpmsolver::ParabolicDriver; using VariableBoxT = LiquidAqueousComponentVariableBox; static constexpr EquationType equation_type {EquationType::LiquidAqueous}; }; //! \brief Wrapper for the liquid transport of aqueous component equation //! //! \internal class SPECMICP_DLL_LOCAL LiquidAqueousTask: public EquationTask { using base = EquationTask; public: LiquidAqueousTask( index_t component, mesh::Mesh1DPtr the_mesh, LiquidAqueousTaskTraits::VariableBoxT&& variables, const TransportConstraints& constraints ): EquationTask( component, the_mesh, variables, constraints) {} LiquidAqueousTask( index_t component, mesh::Mesh1DPtr the_mesh, LiquidAqueousTaskTraits::VariableBoxT&& variables, const TransportConstraints& constraints, scalar_t scaling ): EquationTask( component, the_mesh, variables, constraints, scaling) {} MainVariable& get_var(UnsaturatedVariables * const vars) { return vars->get_aqueous_concentration(component()); } // Also take into account the solid total concentration scalar_t compute_squared_update( UnsaturatedVariables * const vars ) override { scalar_t solid_update = vars->get_solid_concentration(component()).velocity.squaredNorm(); return solid_update + base::compute_squared_update(vars); } }; //! \brief Traits struct for the LiquidGasAqueousTask class //! //! \internal struct SPECMICP_DLL_LOCAL LiquidGasAqueousTaskTraits { using EqT = AqueousGasTransportEquation; using SolverT = dfpmsolver::ParabolicDriver; using VariableBoxT = LiquidGasAqueousVariableBox; static constexpr EquationType equation_type {EquationType::LiquidAqueous}; }; //! \brief Wrapper for the liquid transport of aqueous component equation //! //! \internal class SPECMICP_DLL_LOCAL LiquidGasAqueousTask: public EquationTask { using base = EquationTask; public: LiquidGasAqueousTask( index_t component, mesh::Mesh1DPtr the_mesh, LiquidGasAqueousTaskTraits::VariableBoxT&& variables, const TransportConstraints& constraints ): base(component, the_mesh, variables, constraints) {} LiquidGasAqueousTask( index_t component, mesh::Mesh1DPtr the_mesh, LiquidGasAqueousTaskTraits::VariableBoxT&& variables, const TransportConstraints& constraints, scalar_t scaling ): base(component, the_mesh, variables, constraints, scaling) {} MainVariable& get_var(UnsaturatedVariables * const vars) { return vars->get_aqueous_concentration(component()); } // Also take into account the solid total concentration scalar_t compute_squared_update( UnsaturatedVariables * const vars ) override { scalar_t solid_update = vars->get_solid_concentration(component()).velocity.squaredNorm(); return solid_update + base::compute_squared_update(vars); } }; //! \brief Traits struct for the Pressure Task traits //! //! \internal struct SPECMICP_DLL_LOCAL PressureTaskTraits { using EqT = PressureEquation; using SolverT = dfpmsolver::ParabolicDriver; using VariableBoxT = PressureVariableBox; static constexpr EquationType equation_type {EquationType::Pressure}; }; //! \brief Wrapper for the pressure equation solver //! //! \internal class SPECMICP_DLL_LOCAL PressureTask: public EquationTask { using base = EquationTask; public: PressureTask( index_t component, mesh::Mesh1DPtr the_mesh, PressureTaskTraits::VariableBoxT&& variables, const TransportConstraints& constraints ): EquationTask( component, the_mesh, variables, constraints) {} PressureTask( index_t component, mesh::Mesh1DPtr the_mesh, PressureTaskTraits::VariableBoxT&& variables, const TransportConstraints& constraints, scalar_t scaling ): EquationTask( component, the_mesh, variables, constraints, scaling) {} MainVariable& get_var(UnsaturatedVariables * const vars) { return vars->get_pressure_main_variables(component()); } }; // ================================== // // // // UnsaturatedTransportStaggerImpl // // // // ================================== // // constructor // =========== UnsaturatedTransportStagger::UnsaturatedTransportStaggerImpl::UnsaturatedTransportStaggerImpl( UnsaturatedVariablesPtr variables, const TransportConstraints& constraints, bool merge_saturation_pressure, bool merge_aqueous_pressure ): m_merged_gas(variables->get_database()->nb_component(), false) { database::RawDatabasePtr raw_db = variables->get_database(); mesh::Mesh1DPtr the_mesh = variables->get_mesh(); m_aq_equation_task = std::vector( raw_db->nb_component(), no_equation); m_gas_equation_task = std::vector( raw_db->nb_component(), no_equation); dfpmsolver::ParabolicDriverOptions* opts = nullptr; // Saturation equations // ==================== // // There is 2 choices for the saturation equation // Either SaturationPressureEquation or SaturationPressure if (merge_saturation_pressure and variables->component_has_gas(0)) { m_saturation_equation = make_unique( 0, the_mesh, variables->get_saturation_pressure_variables(), constraints, variables->get_aqueous_scaling(0) ); m_merged_gas[0] = true; opts = &(static_cast( m_saturation_equation.get())->get_options()); } else { m_saturation_equation = make_unique( 0, the_mesh, variables->get_saturation_variables(), constraints, variables->get_aqueous_scaling(0) ); opts = &(static_cast( m_saturation_equation.get())->get_options()); } opts->residuals_tolerance = 1e-8; opts->absolute_tolerance = 1e-12; opts->step_tolerance = 1e-12; opts->threshold_stationary_point = 1e-12; opts->maximum_iterations = 500; opts->sparse_solver = sparse_solvers::SparseSolver::SparseLU; opts->quasi_newton = 3; opts->maximum_step_length = 0.1; opts->max_iterations_at_max_length = 5000; const index_t size = raw_db->nb_aqueous_components() + variables->nb_gas(); m_equation_list.reserve(size); // Liquid aqueous diffusion-advection // ================================== for (index_t id: raw_db->range_aqueous_component()) { if (merge_aqueous_pressure and variables->component_has_gas(id)) { m_equation_list.emplace_back( make_unique( id, the_mesh, variables->get_liquid_gas_aqueous_variables(id), constraints, variables->get_aqueous_scaling(id)) ); m_merged_gas[id] = true; } else { m_equation_list.emplace_back( make_unique( id, the_mesh, variables->get_liquid_aqueous_component_variables(id), constraints, variables->get_aqueous_scaling(id)) ); } id_aqueous_task(id) = m_equation_list.size()-1; dfpmsolver::ParabolicDriverOptions& opts = *get_aqueous_options(id); opts.maximum_iterations = 500; opts.residuals_tolerance = 1e-8; opts.absolute_tolerance = 1e-12; opts.step_tolerance = 1e-12; opts.threshold_stationary_point = 1e-12; opts.sparse_solver = sparse_solvers::SparseSolver::SparseLU; opts.maximum_step_length= 1e6; } // Water partial pressure // ====================== // // Depending on the saturation equation chosen we may or may not include // this equations if (variables->component_has_gas(0) and (not m_merged_gas[0])) { m_equation_list.emplace_back( make_unique(0, the_mesh, variables->get_pressure_variables(0), constraints, variables->get_gaseous_scaling(0) )); id_gas_task(0) = m_equation_list.size()-1; dfpmsolver::ParabolicDriverOptions& opts = *get_gas_options(0); opts.maximum_iterations = 500; opts.residuals_tolerance = 1e-8; opts.absolute_tolerance = 1e-12; opts.step_tolerance = 1e-12; opts.threshold_stationary_point = 1e-12; opts.sparse_solver = sparse_solvers::SparseSolver::SparseLU; opts.maximum_step_length= 1e6; } // Gaseous diffusion for (index_t id: raw_db->range_aqueous_component()) { if (variables->component_has_gas(id) and (not m_merged_gas[id])) { m_equation_list.emplace_back( make_unique(id, the_mesh, variables->get_pressure_variables(id), constraints, variables->get_gaseous_scaling(id) )); id_gas_task(id) = m_equation_list.size()-1; dfpmsolver::ParabolicDriverOptions& opts = *get_gas_options(id); opts.maximum_iterations = 500; opts.residuals_tolerance = 1e-8; opts.absolute_tolerance = 1e-12; opts.step_tolerance = 1e-12; opts.threshold_stationary_point = 1e-12; opts.sparse_solver = sparse_solvers::SparseSolver::SparseLU; opts.maximum_step_length= 1e6; } } } dfpmsolver::ParabolicDriverOptions* UnsaturatedTransportStagger::UnsaturatedTransportStaggerImpl::get_saturation_options() { dfpmsolver::ParabolicDriverOptions* opts = nullptr; if (m_merged_gas[0]) { opts = &static_cast( m_saturation_equation.get())->get_options(); } else { opts = &static_cast( m_saturation_equation.get())->get_options(); } return opts; } dfpmsolver::ParabolicDriverOptions* UnsaturatedTransportStagger::UnsaturatedTransportStaggerImpl::get_aqueous_options( index_t component) { dfpmsolver::ParabolicDriverOptions* opts = nullptr; auto id = id_aqueous_task(component); if (id != no_equation) { if (m_merged_gas[component]) { opts = &static_cast( m_equation_list[id].get())->get_options(); } else { opts = &static_cast( m_equation_list[id].get())->get_options(); } } return opts; } dfpmsolver::ParabolicDriverOptions* UnsaturatedTransportStagger::UnsaturatedTransportStaggerImpl::get_gas_options( index_t component) { dfpmsolver::ParabolicDriverOptions* opts = nullptr; auto id = id_gas_task(component); if (id != no_equation) { opts = &static_cast( m_equation_list[id].get())->get_options(); } return opts; } // Residuals // ========= scalar_t UnsaturatedTransportStagger::UnsaturatedTransportStaggerImpl::get_residual( UnsaturatedVariables * const vars ) { auto sum = m_saturation_equation->compute_squared_residual(vars); #if SPECMICP_USE_OPENMP #pragma omp parallel for \ reduction(+: sum) #endif for (std::size_t ideq=0; ideqcompute_squared_residual(vars); } auto norm = std::sqrt(sum); //std::cout << "; " << norm << std::endl; return norm; } scalar_t UnsaturatedTransportStagger::UnsaturatedTransportStaggerImpl::get_residual_0( UnsaturatedVariables * const vars ) { return m_norm_0; } scalar_t UnsaturatedTransportStagger::UnsaturatedTransportStaggerImpl::get_update( UnsaturatedVariables * const vars ) { scalar_t sum = m_saturation_equation->compute_squared_update(vars); #if SPECMICP_USE_OPENMP #pragma omp parallel for \ reduction(+: sum) #endif for (std::size_t ideq=0; ideqcompute_squared_update(vars); } return std::sqrt(sum); } // Solving the equations // ===================== void UnsaturatedTransportStagger::UnsaturatedTransportStaggerImpl::initialize_timestep( scalar_t dt, UnsaturatedVariables * const vars ) { save_dt(dt); vars->get_advection_flux().set_zero(); m_saturation_equation->initialize_timestep(dt, vars); scalar_t sum = m_saturation_equation->compute_squared_residual_0(vars); #if SPECMICP_USE_OPENMP #pragma omp parallel for \ reduction(+: sum) #endif for (std::size_t ideq=0; ideqinitialize_timestep(dt, vars); sum += task->compute_squared_residual_0(vars); } m_norm_0 = 1.0;//std::sqrt(sum); } solver::StaggerReturnCode UnsaturatedTransportStagger::UnsaturatedTransportStaggerImpl::restart_timestep( UnsaturatedVariables * const vars ) { dfpmsolver::ParabolicDriverReturnCode retcode; bool flag_fail = false; bool flag_error_minimized = false; // Saturation equation retcode = m_saturation_equation->restart_timestep(vars); if (dfpmsolver::has_failed(retcode)) { WARNING << "Failed to solve saturation equation, return code :" << to_string(retcode); flag_fail = true; } if (retcode == dfpmsolver::ParabolicDriverReturnCode::ErrorMinimized) flag_error_minimized = true; // Other equation if (not flag_fail) { vars->set_relative_variables(); #if SPECMICP_USE_OPENMP #pragma omp parallel for \ reduction(or: flag_fail) \ reduction(and: flag_error_minimized) #endif for (std::size_t ideq=0; ideqrestart_timestep(vars); if (dfpmsolver::has_failed(retcode)) { WARNING << "Equation of type '" << to_string(task->equation_type()) << "' for component " << task->component() << " has failed with return code : " << to_string(retcode); flag_fail = true; } flag_error_minimized = flag_error_minimized and (retcode == dfpmsolver::ParabolicDriverReturnCode::ErrorMinimized); } } // Return code solver::StaggerReturnCode return_code = solver::StaggerReturnCode::ResidualMinimized; if (flag_error_minimized) { return_code = solver::StaggerReturnCode::ErrorMinimized; } if (flag_fail) return_code = solver::StaggerReturnCode::UnknownError; return return_code; } // ================================ // // // // Helper functions // // // // ================================ // static std::string to_string(EquationType eq_type) { std::string str; switch (eq_type) { case EquationType::LiquidAqueous: str = "Liquid advection-diffusion"; break; case EquationType::Pressure: str = "Gaseous diffusion"; break; case EquationType::Saturation: str = "Saturation equation"; break; default: str = "Unknown equation"; break; } return str; } std::string to_string(dfpmsolver::ParabolicDriverReturnCode retcode) { using RetCode = dfpmsolver::ParabolicDriverReturnCode; std::string str; switch (retcode) { case RetCode::ResidualMinimized: str = "ResidualMinimized"; break; case RetCode::ErrorMinimized: str = "ErrorMinimized"; break; case RetCode::NotConvergedYet: str = "NotConvergedYet"; break; case RetCode::StationaryPoint: str = "StationaryPoint"; break; case RetCode::ErrorLinearSystem: str = "ErrorLinearSystem"; break; case RetCode::MaxStepTakenTooManyTimes: str = "MaxStepTakenTooManyTimes"; break; case RetCode::MaxIterations: str = "MaxIterations"; break; case RetCode::LinesearchFailed: str = "LinesearchFailed"; default: str = "Unknown return code"; break; } return str; } } //end namespace unsaturated } //end namespace systems } //end namespace reactmicp } //end namespace specmicp diff --git a/src/reactmicp/systems/unsaturated/transport_stagger.hpp b/src/reactmicp/systems/unsaturated/transport_stagger.hpp index abb196d..5e23f75 100644 --- a/src/reactmicp/systems/unsaturated/transport_stagger.hpp +++ b/src/reactmicp/systems/unsaturated/transport_stagger.hpp @@ -1,145 +1,146 @@ /*------------------------------------------------------------------------------- Copyright (c) 2015 F. Georget , Princeton University All rights reserved. Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met: 1. Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer. 2. Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution. 3. Neither the name of the copyright holder nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission. THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. -----------------------------------------------------------------------------*/ #ifndef SPECMICP_REACTMICP_UNSATURATED_TRANSPORTSTAGGER_HPP #define SPECMICP_REACTMICP_UNSATURATED_TRANSPORTSTAGGER_HPP //! \file unsaturated/transport_stagger.hpp //! \brief The unsaturated transport stagger #include "../../solver/staggers_base/transport_stagger_base.hpp" +#include "../../../utils/pimpl_ptr.hpp" namespace specmicp { namespace dfpmsolver { struct ParabolicDriverOptions; } //end namespace dfpmsolver namespace reactmicp { namespace systems { namespace unsaturated { class UnsaturatedVariables; class TransportConstraints; class SPECMICP_DLL_PUBLIC UnsaturatedTransportStagger: public solver::TransportStaggerBase { using VariablesBase = solver::VariablesBase; using StaggerReturnCode = solver::StaggerReturnCode; public: UnsaturatedTransportStagger( std::shared_ptr variables, const TransportConstraints& constraints, bool merge_saturation_pressure=false, bool merge_aqueous_pressure=false ); ~UnsaturatedTransportStagger(); //! \brief Initialize the stagger at the beginning of an iteration //! //! This is where the first residual may be computed, the predictor saved, ... //! \param dt the duration of the timestep //! \param var shared_ptr to the variables void initialize_timestep(scalar_t dt, VariablesBase * const var) override; //! \brief Solve the equation for the timetep //! //! \param var shared_ptr to the variables StaggerReturnCode restart_timestep(VariablesBase * const var) override; //! \brief Compute the residuals norm //! //! \param var shared_ptr to the variables scalar_t get_residual(VariablesBase * const var) override; //! \brief Compute the residuals norm //! //! \param var shared_ptr to the variables scalar_t get_residual_0(VariablesBase * const var) override; //! \brief Obtain the norm of the step size //! //! This is used to check if the algorithm has reach a stationary points. //! It should look like : return main_variables.norm() //! //! \param var shared_ptr to the variables scalar_t get_update(VariablesBase * const var) override; //! Return options of saturation equation //! //! \return the options or nullptr if the equation does not exist dfpmsolver::ParabolicDriverOptions* get_saturation_options(); //! return options of aqueous transport equation //! //! \return the options or nullptr if the equation does not exist dfpmsolver::ParabolicDriverOptions* get_aqueous_options(index_t component); //! return options of gas transport equation //! //! \return the options or nullptr if the equation does not exist dfpmsolver::ParabolicDriverOptions* get_gas_options(index_t component); private: // The implementation details class UnsaturatedTransportStaggerImpl; - std::unique_ptr m_impl; + utils::pimpl_ptr m_impl; }; //! \brief Return a shared pointer to the transport stagger //! //! \param variables shared_pointer to the unsaturated variables //! \param constraints The transport constraints //! \param merge_saturation_pressure true if the saturation //! and water vapor pressure equations must be merged inline std::shared_ptr unsaturated_transport_stagger( std::shared_ptr variables, const TransportConstraints& constraints, bool merge_saturation_pressure = false, bool merge_aqueous_pressure = false ) { return std::make_shared( variables, constraints, merge_saturation_pressure, merge_aqueous_pressure ); } } //end namespace unsaturated } //end namespace systems } //end namespace reactmicp } //end namespace specmicp #endif // SPECMICP_REACTMICP_UNSATURATED_TRANSPORTSTAGGER_HPP