reaction_chain.h

Go to the documentation of this file.

// ------------------------------------------------------
//
// SPDX-License-Identifier: GPL-2.0-or-later
//
// SPDX-FileCopyrightText: Copyright (C) 2011-2026 by the ASPECT authors.
//
// This file is part of ASPECT.
//
// Detailed license information governing the source code and
// contributions can be found in the folder LICENSES and in
// LICENSE and CONTRIBUTING.md at the top level directory.
//
// ------------------------------------------------------

#ifndef _aspect_material_model_reaction_model_reaction_chain_h
#define _aspect_material_model_reaction_model_reaction_chain_h

#include <aspect/material_model/reaction_model/kinetics/cahn1956_interface.h>
#include <aspect/utilities.h>

namespace aspect
{
  namespace MaterialModel
  {
    namespace ReactionModel
    {
      template <int dim>
      struct ReactionStep
      {
        std::shared_ptr<Cahn1956Interface<dim>> kinetics;
        unsigned int local_reaction_index = numbers::invalid_unsigned_int;
      };

      template <int dim>
      class ReactionChain : public ::aspect::SimulatorAccess<dim>
      {
        public:
          std::vector<ReactionStep<dim>> reactions;

          void initialize();
          unsigned int n_reactions() const;

          std::vector<double> clamp_cumulative_progress(std::vector<double> reaction_progress_values) const;
          std::vector<double> compute_phase_mass_fractions(const std::vector<double> &reaction_progress_values,
                                                           const std::vector<double> &phase_densities) const;

          double net_forward_reaction_rate(const double temperature,
                                           const double pressure,
                                           const double delta_forward_gibbs_energy,
                                           const double cumulative_forward_reaction_progress,
                                           const unsigned int reaction_index) const;

          static void declare_parameters(ParameterHandler &prm);
          void parse_parameters(ParameterHandler &prm);

        private:
          std::vector<std::shared_ptr<Cahn1956Interface<dim>>> kinetics_models;

          double tolerance_in_reaction_progress;
      };
    }
  }
}
#endif