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

Public Member Functions

virtual void evaluate (const MaterialModel::MaterialModelInputs< dim > &in, MaterialModel::MaterialModelOutputs< dim > &out) const
 
virtual bool is_compressible () const
 
virtual double reference_viscosity () const
 
virtual void parse_parameters (ParameterHandler &prm)
 
- Public Member Functions inherited from aspect::MaterialModel::Interface< dim >
virtual ~Interface ()
 
virtual void initialize ()
 
virtual void update ()
 
virtual void create_additional_named_outputs (MaterialModelOutputs &outputs) const
 
virtual void fill_additional_material_model_inputs (MaterialModel::MaterialModelInputs< dim > &input, const LinearAlgebra::BlockVector &solution, const FEValuesBase< dim > &fe_values, const Introspection< dim > &introspection) const
 
const NonlinearDependence::ModelDependenceget_model_dependence () 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_free_surface_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 WorldBuilder::World & get_world_builder () const
 
const FreeSurfaceHandler< dim > & get_free_surface_handler () const
 
const LateralAveraging< dim > & get_lateral_averaging () const
 
const ConstraintMatrix & get_current_constraints () const
 
bool simulator_is_initialized () 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
 

Static Public Member Functions

static void declare_parameters (ParameterHandler &prm)
 
- Static Public Member Functions inherited from aspect::MaterialModel::Interface< dim >
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 Member Functions

std::vector< double > calculate_isostrain_viscosities (const std::vector< double > &volume_fractions, const double &pressure, const double &temperature, const SymmetricTensor< 2, dim > &strain_rate) const
 

Private Attributes

double reference_T
 
double min_strain_rate
 
double min_visc
 
double max_visc
 
double veff_coefficient
 
double ref_visc
 
double strain_rate_residual_threshold
 
unsigned int stress_max_iteration_number
 
double thermal_diffusivity
 
double heat_capacity
 
double grain_size
 
std::vector< double > densities
 
std::vector< double > thermal_expansivities
 
MaterialUtilities::CompositionalAveragingOperation viscosity_averaging
 
std::vector< double > prefactors_diffusion
 
std::vector< double > stress_exponents_diffusion
 
std::vector< double > grain_size_exponents_diffusion
 
std::vector< double > activation_energies_diffusion
 
std::vector< double > activation_volumes_diffusion
 
std::vector< double > prefactors_dislocation
 
std::vector< double > stress_exponents_dislocation
 
std::vector< double > activation_energies_dislocation
 
std::vector< double > activation_volumes_dislocation
 

Additional Inherited Members

- Public Types inherited from aspect::MaterialModel::Interface< dim >
typedef MaterialModel::MaterialModelInputs< dim > MaterialModelInputs
 
typedef MaterialModel::MaterialModelOutputs< dim > MaterialModelOutputs
 
- Protected Attributes inherited from aspect::MaterialModel::Interface< dim >
NonlinearDependence::ModelDependence model_dependence
 

Detailed Description

template<int dim>
class aspect::MaterialModel::DiffusionDislocation< dim >

A material model based on a viscous rheology including diffusion and dislocation creep.

The effective viscosity is defined as the harmonic mean of the two effective viscosity functions describing diffusion and dislocation creep:

\[ v_\text{eff} = \left( \frac{1}{v_\text{eff}^\text{diff}} + \frac{1}{v_\text{eff}^\text{dis}} \right)^{-1} \]

where

\[ v_\text{eff}^\text{diff} = A_\text{diff}^{-1} \exp\left(\frac{E_\text{diff} + PV_\text{diff}}{RT}\right), \]

and

\[ v_\text{eff}^\text{dis} = A_\text{dis}^{\frac{-1}{n_\text{dis}}} \dot{\varepsilon}^{\frac{1-n}{n}} \exp\left(\frac{E_\text{diff} + PV_\text{diff}}{n_\text{dis}RT}\right) \]

where $\dot{\varepsilon}$ is the second invariant of the strain rate tensor, $A_i$ are prefactors where $i$ corresponds to diffusion or dislocation creep, $E_i$ are the activation energies, $V_i$ are the activation volumes, $\rho_m$ is the mantle density, $R$ is the gas constant, $T$ is temperature, and $P$ is pressure.

Several model parameters (reference densities, thermal expansivities and rheology parameters) can be defined per-compositional field. For each material parameter the user supplies a comma delimited list of length N+1, where N is the number of compositional fields. The additional field corresponds to the value for background mantle. They should be ordered ``background, composition1, composition2...''

If a list of values is given for the density and thermal expansivity, the volume weighted sum of the values of each of the compositional fields is used in their place, for example $\rho = \sum \left( \rho_i V_i \right)$

The individual output viscosities for each compositional field are also averaged. The user can choose from a range of options for this viscosity averaging. If only one value is given for any of these parameters, all compositions are assigned the same value. The first value in the list is the value assigned to "background mantle" (regions where the sum of the compositional fields is < 1.0).

Definition at line 79 of file diffusion_dislocation.h.

Member Function Documentation

§ evaluate()

template<int dim>
virtual void aspect::MaterialModel::DiffusionDislocation< dim >::evaluate ( const MaterialModel::MaterialModelInputs< dim > &  in,
MaterialModel::MaterialModelOutputs< dim > &  out 
) const
virtual

Function to compute the material properties in out given the inputs in in. If MaterialModelInputs.strain_rate has the length 0, then the viscosity does not need to be computed.

Implements aspect::MaterialModel::Interface< dim >.

§ is_compressible()

template<int dim>
virtual bool aspect::MaterialModel::DiffusionDislocation< dim >::is_compressible ( ) const
virtual

Return whether the model is compressible or not. Incompressibility does not necessarily imply that the density is constant; rather, it may still depend on temperature or pressure. In the current context, compressibility means whether we should solve the continuity equation as $\nabla \cdot (\rho \mathbf u)=0$ (compressible Stokes) or as $\nabla \cdot \mathbf{u}=0$ (incompressible Stokes).

This material model is incompressible.

Implements aspect::MaterialModel::Interface< dim >.

§ reference_viscosity()

template<int dim>
virtual double aspect::MaterialModel::DiffusionDislocation< dim >::reference_viscosity ( ) const
virtual

Return a reference value typical of the viscosities that appear in this model. This value is not actually used in the material description itself, but is used in scaling variables to the same numerical order of magnitude when solving linear systems. Specifically, the reference viscosity appears in the factor scaling the pressure against the velocity. It is also used in computing dimension-less quantities. You may want to take a look at the Kronbichler, Heister, Bangerth 2012 paper that describes the design of ASPECT for a description of this pressure scaling.

Note
The reference viscosity should take into account the complete constitutive relationship, defined as the scalar viscosity times the constitutive tensor. In most cases, the constitutive tensor will simply be the identity tensor (this is the default case), but this may become important for material models with anisotropic viscosities, if the constitutive tensor is not normalized.

Implements aspect::MaterialModel::Interface< dim >.

§ declare_parameters()

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

§ parse_parameters()

template<int dim>
virtual void aspect::MaterialModel::DiffusionDislocation< dim >::parse_parameters ( ParameterHandler prm)
virtual

Read the parameters this class declares from the parameter file. The default implementation of this function does not read any parameters. Consequently, derived classes do not have to overload this function if they do not take any runtime parameters.

Reimplemented from aspect::MaterialModel::Interface< dim >.

§ calculate_isostrain_viscosities()

template<int dim>
std::vector<double> aspect::MaterialModel::DiffusionDislocation< dim >::calculate_isostrain_viscosities ( const std::vector< double > &  volume_fractions,
const double &  pressure,
const double &  temperature,
const SymmetricTensor< 2, dim > &  strain_rate 
) const
private

Member Data Documentation

§ reference_T

template<int dim>
double aspect::MaterialModel::DiffusionDislocation< dim >::reference_T
private

Definition at line 111 of file diffusion_dislocation.h.

§ min_strain_rate

template<int dim>
double aspect::MaterialModel::DiffusionDislocation< dim >::min_strain_rate
private

Defining a minimum strain rate stabilizes the viscosity calculation, which involves a division by the strain rate. Units: $1/s$.

Definition at line 117 of file diffusion_dislocation.h.

§ min_visc

template<int dim>
double aspect::MaterialModel::DiffusionDislocation< dim >::min_visc
private

Definition at line 118 of file diffusion_dislocation.h.

§ max_visc

template<int dim>
double aspect::MaterialModel::DiffusionDislocation< dim >::max_visc
private

Definition at line 119 of file diffusion_dislocation.h.

§ veff_coefficient

template<int dim>
double aspect::MaterialModel::DiffusionDislocation< dim >::veff_coefficient
private

Definition at line 120 of file diffusion_dislocation.h.

§ ref_visc

template<int dim>
double aspect::MaterialModel::DiffusionDislocation< dim >::ref_visc
private

Definition at line 121 of file diffusion_dislocation.h.

§ strain_rate_residual_threshold

template<int dim>
double aspect::MaterialModel::DiffusionDislocation< dim >::strain_rate_residual_threshold
private

Definition at line 123 of file diffusion_dislocation.h.

§ stress_max_iteration_number

template<int dim>
unsigned int aspect::MaterialModel::DiffusionDislocation< dim >::stress_max_iteration_number
private

Definition at line 124 of file diffusion_dislocation.h.

§ thermal_diffusivity

template<int dim>
double aspect::MaterialModel::DiffusionDislocation< dim >::thermal_diffusivity
private

Definition at line 126 of file diffusion_dislocation.h.

§ heat_capacity

template<int dim>
double aspect::MaterialModel::DiffusionDislocation< dim >::heat_capacity
private

Definition at line 127 of file diffusion_dislocation.h.

§ grain_size

template<int dim>
double aspect::MaterialModel::DiffusionDislocation< dim >::grain_size
private

Definition at line 128 of file diffusion_dislocation.h.

§ densities

template<int dim>
std::vector<double> aspect::MaterialModel::DiffusionDislocation< dim >::densities
private

Definition at line 130 of file diffusion_dislocation.h.

§ thermal_expansivities

template<int dim>
std::vector<double> aspect::MaterialModel::DiffusionDislocation< dim >::thermal_expansivities
private

Definition at line 131 of file diffusion_dislocation.h.

§ viscosity_averaging

Definition at line 133 of file diffusion_dislocation.h.

§ prefactors_diffusion

template<int dim>
std::vector<double> aspect::MaterialModel::DiffusionDislocation< dim >::prefactors_diffusion
private

Definition at line 142 of file diffusion_dislocation.h.

§ stress_exponents_diffusion

template<int dim>
std::vector<double> aspect::MaterialModel::DiffusionDislocation< dim >::stress_exponents_diffusion
private

Definition at line 143 of file diffusion_dislocation.h.

§ grain_size_exponents_diffusion

template<int dim>
std::vector<double> aspect::MaterialModel::DiffusionDislocation< dim >::grain_size_exponents_diffusion
private

Definition at line 144 of file diffusion_dislocation.h.

§ activation_energies_diffusion

template<int dim>
std::vector<double> aspect::MaterialModel::DiffusionDislocation< dim >::activation_energies_diffusion
private

Definition at line 145 of file diffusion_dislocation.h.

§ activation_volumes_diffusion

template<int dim>
std::vector<double> aspect::MaterialModel::DiffusionDislocation< dim >::activation_volumes_diffusion
private

Definition at line 146 of file diffusion_dislocation.h.

§ prefactors_dislocation

template<int dim>
std::vector<double> aspect::MaterialModel::DiffusionDislocation< dim >::prefactors_dislocation
private

Definition at line 148 of file diffusion_dislocation.h.

§ stress_exponents_dislocation

template<int dim>
std::vector<double> aspect::MaterialModel::DiffusionDislocation< dim >::stress_exponents_dislocation
private

Definition at line 149 of file diffusion_dislocation.h.

§ activation_energies_dislocation

template<int dim>
std::vector<double> aspect::MaterialModel::DiffusionDislocation< dim >::activation_energies_dislocation
private

Definition at line 150 of file diffusion_dislocation.h.

§ activation_volumes_dislocation

template<int dim>
std::vector<double> aspect::MaterialModel::DiffusionDislocation< dim >::activation_volumes_dislocation
private

Definition at line 151 of file diffusion_dislocation.h.


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