diffusion_creep.h

Go to the documentation of this file.

// ------------------------------------------------------
//
// SPDX-License-Identifier: GPL-2.0-or-later
//
// SPDX-FileCopyrightText: Copyright (C) 2019-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_rheology_diffusion_creep_h
#define _aspect_material_model_rheology_diffusion_creep_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 DiffusionCreepParameters
      {
        double prefactor;
        double activation_energy;
        double activation_volume;
        double stress_exponent;
        double grain_size_exponent;

        DiffusionCreepParameters();
      };

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

          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 DiffusionCreepParameters
          compute_creep_parameters (const unsigned int composition,
                                    const std::vector<double> &phase_function_values = {},
                                    const std::vector<unsigned int> &n_phase_transitions_per_composition = {}) const;

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

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

          std::pair<double, double>
          compute_strain_rate_and_derivative (const double stress,
                                              const double pressure,
                                              const double temperature,
                                              const DiffusionCreepParameters creep_parameters) const;

          std::pair<double, double>
          compute_strain_rate_and_derivative (const double stress,
                                              const double pressure,
                                              const double temperature,
                                              const double grain_size,
                                              const DiffusionCreepParameters creep_parameters) const;

          std::pair<double, double>
          compute_log_strain_rate_and_derivative (const double log_stress,
                                                  const double pressure,
                                                  const double temperature,
                                                  const DiffusionCreepParameters creep_parameters) const;

          std::pair<double, double>
          compute_log_strain_rate_and_derivative (const double log_stress,
                                                  const double pressure,
                                                  const double temperature,
                                                  const double grain_size,
                                                  const DiffusionCreepParameters creep_parameters) 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