ASPECT
Public Member Functions | Static Public Member Functions | Private Types | Private Attributes | List of all members
aspect::MaterialModel::Rheology::PeierlsCreep< dim > Class Template Reference
Inheritance diagram for aspect::MaterialModel::Rheology::PeierlsCreep< dim >:
Inheritance graph
[legend]

Public Member Functions

 PeierlsCreep ()
 
const PeierlsCreepParameters compute_creep_parameters (const unsigned int composition, const std::vector< double > &phase_function_values=std::vector< double >(), const std::vector< unsigned int > &n_phases_per_composition=std::vector< unsigned int >()) const
 
void parse_parameters (ParameterHandler &prm, const std::shared_ptr< std::vector< unsigned int >> &expected_n_phases_per_composition=std::shared_ptr< std::vector< unsigned int >>())
 
double compute_approximate_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_phases_per_composition=std::vector< unsigned int >()) const
 
double compute_exact_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_phases_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_phases_per_composition=std::vector< unsigned int >()) const
 
std::pair< double, double > compute_approximate_strain_rate_and_derivative (const double stress, const double pressure, const double temperature, const PeierlsCreepParameters creep_parameters) const
 
std::pair< double, double > compute_exact_strain_rate_and_derivative (const double stress, const double pressure, const double temperature, const PeierlsCreepParameters creep_parameters) const
 
std::pair< double, double > compute_strain_rate_and_derivative (const double stress, const double pressure, const double temperature, const PeierlsCreepParameters creep_parameters) const
 
- Public Member Functions inherited from aspect::SimulatorAccess< dim >
 SimulatorAccess ()
 
 SimulatorAccess (const Simulator< dim > &simulator_object)
 
virtual ~SimulatorAccess ()
 
virtual void initialize_simulator (const Simulator< dim > &simulator_object)
 
template<typename PostprocessorType >
PostprocessorType * find_postprocessor () const
 
const Introspection< dim > & introspection () const
 
const Simulator< dim > & get_simulator () const
 
const Parameters< dim > & get_parameters () const
 
SimulatorSignals< dim > & get_signals () const
 
MPI_Comm get_mpi_communicator () const
 
TimerOutputget_computing_timer () const
 
const ConditionalOStreamget_pcout () const
 
double get_time () const
 
double get_timestep () const
 
double get_old_timestep () const
 
unsigned int get_timestep_number () const
 
unsigned int get_nonlinear_iteration () const
 
const parallel::distributed::Triangulation< dim > & get_triangulation () const
 
double get_volume () const
 
const Mapping< dim > & get_mapping () const
 
std::string get_output_directory () const
 
bool include_adiabatic_heating () const
 
bool include_latent_heat () const
 
bool include_melt_transport () const
 
int get_stokes_velocity_degree () const
 
double get_adiabatic_surface_temperature () const
 
double get_surface_pressure () const
 
bool convert_output_to_years () const
 
unsigned int get_pre_refinement_step () const
 
unsigned int n_compositional_fields () const
 
void get_refinement_criteria (Vector< float > &estimated_error_per_cell) const
 
void get_artificial_viscosity (Vector< float > &viscosity_per_cell, const bool skip_interior_cells=false) const
 
void get_artificial_viscosity_composition (Vector< float > &viscosity_per_cell, const unsigned int compositional_variable) const
 
const LinearAlgebra::BlockVectorget_current_linearization_point () const
 
const LinearAlgebra::BlockVectorget_solution () const
 
const LinearAlgebra::BlockVectorget_old_solution () const
 
const LinearAlgebra::BlockVectorget_old_old_solution () const
 
const LinearAlgebra::BlockVectorget_reaction_vector () const
 
const LinearAlgebra::BlockVectorget_mesh_velocity () const
 
const DoFHandler< dim > & get_dof_handler () const
 
const FiniteElement< dim > & get_fe () const
 
const LinearAlgebra::BlockSparseMatrixget_system_matrix () const
 
const LinearAlgebra::BlockSparseMatrixget_system_preconditioner_matrix () const
 
const MaterialModel::Interface< dim > & get_material_model () const
 
void compute_material_model_input_values (const LinearAlgebra::BlockVector &input_solution, const FEValuesBase< dim, dim > &input_finite_element_values, const typename DoFHandler< dim >::active_cell_iterator &cell, const bool compute_strainrate, MaterialModel::MaterialModelInputs< dim > &material_model_inputs) const
 
const GravityModel::Interface< dim > & get_gravity_model () const
 
const InitialTopographyModel::Interface< dim > & get_initial_topography_model () const
 
const GeometryModel::Interface< dim > & get_geometry_model () const
 
const AdiabaticConditions::Interface< dim > & get_adiabatic_conditions () const
 
bool has_boundary_temperature () const
 
DEAL_II_DEPRECATED const BoundaryTemperature::Interface< dim > & get_boundary_temperature () const
 
const BoundaryTemperature::Manager< dim > & get_boundary_temperature_manager () const
 
const BoundaryHeatFlux::Interface< dim > & get_boundary_heat_flux () const
 
bool has_boundary_composition () const
 
DEAL_II_DEPRECATED const BoundaryComposition::Interface< dim > & get_boundary_composition () const
 
const BoundaryComposition::Manager< dim > & get_boundary_composition_manager () const
 
const std::map< types::boundary_id, std::unique_ptr< BoundaryTraction::Interface< dim > > > & get_boundary_traction () const
 
DEAL_II_DEPRECATED const InitialTemperature::Interface< dim > & get_initial_temperature () const
 
const InitialTemperature::Manager< dim > & get_initial_temperature_manager () const
 
DEAL_II_DEPRECATED const InitialComposition::Interface< dim > & get_initial_composition () const
 
const InitialComposition::Manager< dim > & get_initial_composition_manager () const
 
const std::set< types::boundary_id > & get_fixed_temperature_boundary_indicators () const
 
const std::set< types::boundary_id > & get_fixed_heat_flux_boundary_indicators () const
 
const std::set< types::boundary_id > & get_fixed_composition_boundary_indicators () const
 
const std::set< types::boundary_id > & get_mesh_deformation_boundary_indicators () const
 
const BoundaryVelocity::Manager< dim > & get_boundary_velocity_manager () const
 
const HeatingModel::Manager< dim > & get_heating_model_manager () const
 
const MeshRefinement::Manager< dim > & get_mesh_refinement_manager () const
 
const MeltHandler< dim > & get_melt_handler () const
 
const VolumeOfFluidHandler< dim > & get_volume_of_fluid_handler () const
 
const NewtonHandler< dim > & get_newton_handler () const
 
const MeshDeformation::MeshDeformationHandler< dim > & get_mesh_deformation_handler () const
 
const LateralAveraging< dim > & get_lateral_averaging () const
 
const AffineConstraints< double > & get_current_constraints () const
 
bool simulator_is_past_initialization () const
 
double get_pressure_scaling () const
 
bool pressure_rhs_needs_compatibility_modification () const
 
bool model_has_prescribed_stokes_solution () const
 
TableHandlerget_statistics_object () const
 
template<typename PostprocessorType >
DEAL_II_DEPRECATED PostprocessorType * find_postprocessor () const
 
const Postprocess::Manager< dim > & get_postprocess_manager () const
 
const Particle::World< dim > & get_particle_world () const
 
Particle::World< dim > & get_particle_world ()
 
bool is_stokes_matrix_free ()
 
const StokesMatrixFreeHandler< dim > & get_stokes_matrix_free () const
 
RotationProperties< dim > compute_net_angular_momentum (const bool use_constant_density, const LinearAlgebra::BlockVector &solution, const bool limit_to_top_faces=false) const
 

Static Public Member Functions

static void declare_parameters (ParameterHandler &prm)
 
- Static Public Member Functions inherited from aspect::SimulatorAccess< dim >
static void get_composition_values_at_q_point (const std::vector< std::vector< double > > &composition_values, const unsigned int q, std::vector< double > &composition_values_at_q_point)
 

Private Types

enum  PeierlsCreepScheme { viscosity_approximation, exact }
 

Private Attributes

enum aspect::MaterialModel::Rheology::PeierlsCreep::PeierlsCreepScheme peierls_creep_flow_law
 
std::vector< double > prefactors
 
std::vector< double > stress_exponents
 
std::vector< double > activation_energies
 
std::vector< double > activation_volumes
 
std::vector< double > peierls_stresses
 
std::vector< double > fitting_parameters
 
std::vector< double > glide_parameters_p
 
std::vector< double > glide_parameters_q
 
double strain_rate_residual_threshold
 
unsigned int stress_max_iteration_number
 

Detailed Description

template<int dim>
class aspect::MaterialModel::Rheology::PeierlsCreep< dim >

Peierls creep is a low temperature, high stress viscous deformation mechanism. Crystal deformation occurs through dislocation glide, which requires high stresses. It is considered an important deformation mechanism in the lithosphere and subducting slabs (Kumamoto et al., 2017, Science Advances). The approximate form of the Peierls flow law used here is based on a derivation from Kameyama et al., 1999, Earth and Planetary Science Letters.

Definition at line 64 of file peierls_creep.h.

Member Enumeration Documentation

§ PeierlsCreepScheme

Enumeration for selecting which type of Peierls creep flow law to use. The options are currently "exact" (which requires a Newton-Raphson iteration in compute_viscosity) and "viscosity_approximation", which uses a simplified expression where the strain rate has a power law dependence on the stress (so that the equation can be directly inverted for viscosity). This approximation requires specifying one fitting parameter (gamma) to obtain the best fit in the expected stress range for a given problem (gamma = stress / peierls_stress). The derivation for this approximation (derived by Magali Billen) can be found at: https://ucdavis.app.box.com/s/cl5mwhkjeabol4otrdukfcdwfvg9me4w/file/705438695737.

Enumerator
viscosity_approximation 
exact 

Definition at line 180 of file peierls_creep.h.

Constructor & Destructor Documentation

§ PeierlsCreep()

Constructor.

Member Function Documentation

§ compute_creep_parameters()

template<int dim>
const PeierlsCreepParameters aspect::MaterialModel::Rheology::PeierlsCreep< dim >::compute_creep_parameters ( const unsigned int  composition,
const std::vector< double > &  phase_function_values = std::vector< double >(),
const std::vector< unsigned int > &  n_phases_per_composition = std::vector< unsigned int >() 
) const

Compute the creep parameters for the Peierls creep law.

§ declare_parameters()

template<int dim>
static void aspect::MaterialModel::Rheology::PeierlsCreep< dim >::declare_parameters ( ParameterHandler prm)
static

Declare the parameters this function takes through input files.

§ parse_parameters()

template<int dim>
void aspect::MaterialModel::Rheology::PeierlsCreep< dim >::parse_parameters ( ParameterHandler prm,
const std::shared_ptr< std::vector< unsigned int >> &  expected_n_phases_per_composition = std::shared_ptr< std::vector< unsigned int >>() 
)

Read the parameters from the parameter file. If expected_n_phases_per_composition points to a vector of unsigned integers this is considered the number of phase transitions for each compositional field and will be checked against the parsed parameters.

§ compute_approximate_viscosity()

template<int dim>
double aspect::MaterialModel::Rheology::PeierlsCreep< dim >::compute_approximate_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_phases_per_composition = std::vector< unsigned int >() 
) const

Compute the viscosity based on the approximate Peierls creep flow law.

§ compute_exact_viscosity()

template<int dim>
double aspect::MaterialModel::Rheology::PeierlsCreep< dim >::compute_exact_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_phases_per_composition = std::vector< unsigned int >() 
) const

Compute the viscosity based on the exact Peierls creep flow law.

§ compute_viscosity()

template<int dim>
double aspect::MaterialModel::Rheology::PeierlsCreep< dim >::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_phases_per_composition = std::vector< unsigned int >() 
) const

Compute the viscosity based on the selected Peierls creep flow law. This function uses either the compute_approximate_viscosity or the compute_exact_viscosity function.

§ compute_approximate_strain_rate_and_derivative()

template<int dim>
std::pair<double, double> aspect::MaterialModel::Rheology::PeierlsCreep< dim >::compute_approximate_strain_rate_and_derivative ( const double  stress,
const double  pressure,
const double  temperature,
const PeierlsCreepParameters  creep_parameters 
) const

Compute the strain rate and first stress derivative as a function of stress based on the approximate Peierls creep law.

§ compute_exact_strain_rate_and_derivative()

template<int dim>
std::pair<double, double> aspect::MaterialModel::Rheology::PeierlsCreep< dim >::compute_exact_strain_rate_and_derivative ( const double  stress,
const double  pressure,
const double  temperature,
const PeierlsCreepParameters  creep_parameters 
) const

Compute the strain rate and first stress derivative as a function of stress based on the exact Peierls creep law.

§ compute_strain_rate_and_derivative()

template<int dim>
std::pair<double, double> aspect::MaterialModel::Rheology::PeierlsCreep< dim >::compute_strain_rate_and_derivative ( const double  stress,
const double  pressure,
const double  temperature,
const PeierlsCreepParameters  creep_parameters 
) const

Compute the strain rate and first stress derivative as a function of stress based on the selected Peierls creep law. This function uses either the compute_approximate_strain_rate_and_derivative or the compute_exact_strain_rate_and_derivative function.

Member Data Documentation

§ peierls_creep_flow_law

§ prefactors

template<int dim>
std::vector<double> aspect::MaterialModel::Rheology::PeierlsCreep< dim >::prefactors
private

List of Peierls creep prefactors (A).

Definition at line 189 of file peierls_creep.h.

§ stress_exponents

template<int dim>
std::vector<double> aspect::MaterialModel::Rheology::PeierlsCreep< dim >::stress_exponents
private

List of Peierls creep stress exponents (n).

Definition at line 194 of file peierls_creep.h.

§ activation_energies

template<int dim>
std::vector<double> aspect::MaterialModel::Rheology::PeierlsCreep< dim >::activation_energies
private

List of Peierls creep activation energies (E).

Definition at line 199 of file peierls_creep.h.

§ activation_volumes

template<int dim>
std::vector<double> aspect::MaterialModel::Rheology::PeierlsCreep< dim >::activation_volumes
private

List of Peierls creep activation volumes (V).

Definition at line 204 of file peierls_creep.h.

§ peierls_stresses

template<int dim>
std::vector<double> aspect::MaterialModel::Rheology::PeierlsCreep< dim >::peierls_stresses
private

List of Peierls stresses (sigma_p).

Definition at line 209 of file peierls_creep.h.

§ fitting_parameters

template<int dim>
std::vector<double> aspect::MaterialModel::Rheology::PeierlsCreep< dim >::fitting_parameters
private

List of Peierls fitting parameters (gamma).

Definition at line 214 of file peierls_creep.h.

§ glide_parameters_p

template<int dim>
std::vector<double> aspect::MaterialModel::Rheology::PeierlsCreep< dim >::glide_parameters_p
private

List of the first Peierls parameter related to dislocation glide (p).

Definition at line 220 of file peierls_creep.h.

§ glide_parameters_q

template<int dim>
std::vector<double> aspect::MaterialModel::Rheology::PeierlsCreep< dim >::glide_parameters_q
private

List of the second Peierls parameter related to dislocation glide (q).

Definition at line 226 of file peierls_creep.h.

§ strain_rate_residual_threshold

template<int dim>
double aspect::MaterialModel::Rheology::PeierlsCreep< dim >::strain_rate_residual_threshold
private

Parameters governing the iteration for the exact Peierls viscosity.

Definition at line 232 of file peierls_creep.h.

§ stress_max_iteration_number

template<int dim>
unsigned int aspect::MaterialModel::Rheology::PeierlsCreep< dim >::stress_max_iteration_number
private

Definition at line 233 of file peierls_creep.h.


The documentation for this class was generated from the following file: