grain_boundary_sliding.h

Go to the documentation of this file.

/*
  Copyright (C) 2019 - 2025 by the authors of the ASPECT code.

  This file is part of ASPECT.

  ASPECT is free software; you can redistribute it and/or modify
  it under the terms of the GNU General Public License as published by
  the Free Software Foundation; either version 2, or (at your option)
  any later version.

  ASPECT is distributed in the hope that it will be useful,
  but WITHOUT ANY WARRANTY; without even the implied warranty of
  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  GNU General Public License for more details.

  You should have received a copy of the GNU General Public License
  along with ASPECT; see the file LICENSE.  If not see
  <http://www.gnu.org/licenses/>.
*/

#ifndef _aspect_material_model_rheology_grain_boundary_sliding_h
#define _aspect_material_model_rheology_grain_boundary_sliding_h

#include <aspect/global.h>
#include <aspect/material_model/interface.h>
#include <aspect/material_model/utilities.h>
#include <aspect/simulator_access.h>

namespace aspect
{
  namespace MaterialModel
  {
    namespace Rheology
    {
      struct GrainBoundarySlidingParameters
      {
        double prefactor;
        double activation_energy;
        double activation_volume;
        double stress_exponent;
        double grain_size_exponent;

        GrainBoundarySlidingParameters();
      };

      template <int dim>
      class GrainBoundarySliding : public ::aspect::SimulatorAccess<dim>
      {
        public:
          GrainBoundarySliding();

          static
          void
          declare_parameters (ParameterHandler &prm);

          void
          parse_parameters (ParameterHandler &prm,
                            const std::unique_ptr<std::vector<unsigned int>> &expected_n_phases_per_composition = nullptr);


          const GrainBoundarySlidingParameters
          compute_slide_parameters (const unsigned int composition,
                                    const std::vector<double> &phase_function_values = std::vector<double>(),
                                    const std::vector<unsigned int> &n_phase_transitions_per_composition = std::vector<unsigned int>()) const;

          double
          compute_viscosity (const double strain_rate,
                             const double pressure,
                             const double temperature,
                             const unsigned int composition,
                             const std::vector<double> &phase_function_values = std::vector<double>(),
                             const std::vector<unsigned int> &n_phase_transitions_per_composition = std::vector<unsigned int>()) const;

          double
          compute_viscosity (const double strain_rate,
                             const double pressure,
                             const double temperature,
                             const double grain_size,
                             const unsigned int composition,
                             const std::vector<double> &phase_function_values = std::vector<double>(),
                             const std::vector<unsigned int> &n_phase_transitions_per_composition = std::vector<unsigned int>()) const;

        private:

          std::vector<double> prefactors;

          std::vector<double> stress_exponents;

          std::vector<double> grain_size_exponents;

          std::vector<double> activation_energies;

          std::vector<double> activation_volumes;

          double fixed_grain_size;
      };
    }
  }
}
#endif