Inheritance diagram for aspect::MaterialModel::DruckerPrager< dim >:

[legend]

Public Member Functions
Physical parameters used in the basic equations
void	evaluate (const MaterialModel::MaterialModelInputs< dim > &in, MaterialModel::MaterialModelOutputs< dim > &out) const override

Qualitative properties one can ask a material model
bool	is_compressible () const override

Public Member Functions inherited from aspect::MaterialModel::Interface< dim >
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::ModelDependence &	get_model_dependence () const

Public Member Functions inherited from aspect::Plugins::InterfaceBase
virtual	~InterfaceBase ()=default

virtual void	initialize ()

virtual void	update ()

virtual void	save (std::map< std::string, std::string > &status_strings) const

virtual void	load (const std::map< std::string, std::string > &status_strings)

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)

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

TimerOutput &	get_computing_timer () const

const ConditionalOStream &	get_pcout () const

double	get_time () const

double	get_timestep () const

double	get_old_timestep () const

unsigned int	get_timestep_number () const

const TimeStepping::Manager< dim > &	get_timestepping_manager () 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

unsigned int	get_checkpoint_id () 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

double	get_end_time () 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::BlockVector &	get_current_linearization_point () const

const LinearAlgebra::BlockVector &	get_solution () const

const LinearAlgebra::BlockVector &	get_old_solution () const

const LinearAlgebra::BlockVector &	get_old_old_solution () const

const LinearAlgebra::BlockVector &	get_reaction_vector () const

const LinearAlgebra::BlockVector &	get_mesh_velocity () const

const DoFHandler< dim > &	get_dof_handler () const

const FiniteElement< dim > &	get_fe () const

const LinearAlgebra::BlockSparseMatrix &	get_system_matrix () const

const LinearAlgebra::BlockSparseMatrix &	get_system_preconditioner_matrix () const

const MaterialModel::Interface< dim > &	get_material_model () const

const GravityModel::Interface< dim > &	get_gravity_model () const

const InitialTopographyModel::Interface< dim > &	get_initial_topography_model () const

const std::shared_ptr< const InitialTopographyModel::Interface< dim > >	get_initial_topography_model_pointer () const

const GeometryModel::Interface< dim > &	get_geometry_model () const

const AdiabaticConditions::Interface< dim > &	get_adiabatic_conditions () const

bool	has_boundary_temperature () const

const BoundaryTemperature::Manager< dim > &	get_boundary_temperature_manager () const

const BoundaryConvectiveHeating::Manager< dim > &	get_boundary_convective_heating_manager () const

const BoundaryHeatFlux::Interface< dim > &	get_boundary_heat_flux () const

bool	has_boundary_composition () const

const BoundaryComposition::Manager< dim > &	get_boundary_composition_manager () const

const BoundaryTraction::Manager< dim > &	get_boundary_traction_manager () const

std::shared_ptr< const InitialTemperature::Manager< dim > >	get_initial_temperature_manager_pointer () const

const InitialTemperature::Manager< dim > &	get_initial_temperature_manager () const

std::shared_ptr< const InitialComposition::Manager< dim > >	get_initial_composition_manager_pointer () 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_convective_heating_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

TableHandler &	get_statistics_object () const

const Postprocess::Manager< dim > &	get_postprocess_manager () const

unsigned int	n_particle_managers () const

const Particle::Manager< dim > &	get_particle_manager (const unsigned int particle_manager_index) const

Particle::Manager< dim > &	get_particle_manager (const unsigned int particle_manager_index)

bool	is_stokes_matrix_free ()

const StokesMatrixFreeHandler< dim > &	get_stokes_matrix_free () const

const PrescribedSolution::Manager< dim > &	get_prescribed_solution () const

RotationProperties< dim >	compute_net_angular_momentum (const bool use_constant_density, const LinearAlgebra::BlockVector &solution, const bool limit_to_top_faces=false) const

void	remove_nullspace (LinearAlgebra::BlockVector &solution, LinearAlgebra::BlockVector &distributed_stokes_solution) const

double	normalize_pressure (LinearAlgebra::BlockVector &vector) const

void	denormalize_pressure (const double pressure_adjustment, LinearAlgebra::BlockVector &vector) const

Private Attributes
double	reference_T

double	thermal_conductivities

EquationOfState::LinearizedIncompressible< dim >	equation_of_state

Rheology::DruckerPrager< dim >	drucker_prager_plasticity

double	angle_of_internal_friction

double	cohesion

double	minimum_viscosity

double	maximum_viscosity

double	reference_strain_rate

Functions used in dealing with run-time parameters
void	parse_parameters (ParameterHandler &prm) override

static void	declare_parameters (ParameterHandler &prm)

Additional Inherited Members
Public Types inherited from aspect::MaterialModel::Interface< dim >
using	MaterialModelInputs = MaterialModel::MaterialModelInputs< dim >

using	MaterialModelOutputs = MaterialModel::MaterialModelOutputs< dim >

Static Public Member Functions inherited from aspect::Plugins::InterfaceBase
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)

Protected Attributes inherited from aspect::MaterialModel::Interface< dim >
NonlinearDependence::ModelDependence	model_dependence

Detailed Description

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

A material model that consists of globally constant values for all material parameters except density and viscosity.

The model is considered incompressible, following the definition described in Interface::is_compressible.

The viscosity is computed according to the Drucker Prager frictional plasticity criterion based on a user-defined internal angle of friction \(\phi\) and cohesion \(C\). In 3D: \(\sigma_y = \frac{6 C \cos(\phi)}{\sqrt{3} (3+\sin(\phi))} + \frac{6 P \sin(\phi)}{\sqrt{3} (3+\sin(\phi))}\), where \(P\) is the pressure. See for example Zienkiewicz, O. C., Humpheson, C. and Lewis, R. W. (1975), Géotechnique 25, No. 4, 671-689. With this formulation we circumscribe instead of inscribe the Mohr Coulomb yield surface. In 2D the Drucker Prager yield surface is the same as the Mohr Coulomb surface: \(\sigma_y = P \sin(\phi) + C \cos(\phi)\). Note that in 2D for \(\phi=0\), these criteria revert to the von Mises criterion (no pressure dependence). See for example Thieulot, C. (2011), PEPI 188, 47-68.

Note that we enforce the pressure to be positive in the computation of the yield strength by replacing it with a zero value whenever it is negative to prevent negative yield strengths and viscosities. We then use the computed yield strength to scale back the viscosity on to the yield surface using the Viscosity Rescaling Method described in Kachanov, L. M. (2004), Fundamentals of the Theory of Plasticity, Dover Publications, Inc.

To avoid numerically unfavourably large (or even negative) viscosity ranges, we cut off the viscosity with a user-defined minimum and maximum viscosity: \(\eta_eff = \frac{1}{\frac{1}{\eta_min + \eta}+\\ \frac{1}{\eta_max}}\).

Note that this model uses the formulation that assumes an incompressible medium despite the fact that the density follows the law \(\rho(T)=\rho_0(1-\beta(T-T_{\text{ref}}))\).

Definition at line 79 of file drucker_prager.h.

Member Function Documentation

◆ evaluate()

template<int dim>

void aspect::MaterialModel::DruckerPrager< dim >::evaluate	(	const MaterialModel::MaterialModelInputs< dim > &	in,
		MaterialModel::MaterialModelOutputs< dim > &	out
	)		const

overridevirtual

Function to compute the material properties in out given the inputs in in.

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

◆ is_compressible()

template<int dim>

bool aspect::MaterialModel::DruckerPrager< dim >::is_compressible ( ) const

overridevirtual

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).

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

◆ declare_parameters()

template<int dim>

static void aspect::MaterialModel::DruckerPrager< dim >::declare_parameters ( ParameterHandler & prm )

static

Declare the parameters this class takes through input files.

◆ parse_parameters()

template<int dim>

void aspect::MaterialModel::DruckerPrager< dim >::parse_parameters ( ParameterHandler & prm )

overridevirtual

Read the parameters this class declares from the parameter file.

Reimplemented from aspect::Plugins::InterfaceBase.

Member Data Documentation

◆ reference_T

template<int dim>

double aspect::MaterialModel::DruckerPrager< dim >::reference_T

private

This variable is read from the parameter file through a parameter called 'Reference temperature'.

Definition at line 136 of file drucker_prager.h.

◆ thermal_conductivities

template<int dim>

double aspect::MaterialModel::DruckerPrager< dim >::thermal_conductivities

private

This variable is read from the parameter file through a parameter called 'Thermal conductivity'.

Definition at line 140 of file drucker_prager.h.

◆ equation_of_state

template<int dim>

EquationOfState::LinearizedIncompressible<dim> aspect::MaterialModel::DruckerPrager< dim >::equation_of_state

private

Definition at line 142 of file drucker_prager.h.

◆ drucker_prager_plasticity

template<int dim>

Rheology::DruckerPrager<dim> aspect::MaterialModel::DruckerPrager< dim >::drucker_prager_plasticity

private

Definition at line 147 of file drucker_prager.h.

◆ angle_of_internal_friction

template<int dim>

double aspect::MaterialModel::DruckerPrager< dim >::angle_of_internal_friction

private

The angle of internal friction

This variable is read from the parameter file through a parameter called 'Angle of internal friction'.

Definition at line 154 of file drucker_prager.h.

◆ cohesion

template<int dim>

double aspect::MaterialModel::DruckerPrager< dim >::cohesion

private

The cohesion This variable is read from the parameter file through a parameter called 'Cohesion'.

Definition at line 160 of file drucker_prager.h.

◆ minimum_viscosity

template<int dim>

double aspect::MaterialModel::DruckerPrager< dim >::minimum_viscosity

private

The applied viscosity bounds This variable is read from the parameter file through a parameter called 'Minimum viscosity'.

Definition at line 166 of file drucker_prager.h.

◆ maximum_viscosity

template<int dim>

double aspect::MaterialModel::DruckerPrager< dim >::maximum_viscosity

private

This variable is read from the parameter file through a parameter called 'Maximum viscosity'.

Definition at line 170 of file drucker_prager.h.

◆ reference_strain_rate

template<int dim>

double aspect::MaterialModel::DruckerPrager< dim >::reference_strain_rate

private

The reference strain rate used as a first estimate

This variable is read from the parameter file through a parameter called 'Reference strain rate'.

Definition at line 177 of file drucker_prager.h.

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

/home/docs/checkouts/readthedocs.org/user_builds/aspect-documentation/checkouts/latest/include/aspect/material_model/drucker_prager.h

Public Member Functions

Private Attributes

Functions used in dealing with run-time parameters

Additional Inherited Members

Detailed Description

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

Member Function Documentation

◆ evaluate()

◆ is_compressible()

◆ declare_parameters()

◆ parse_parameters()

Member Data Documentation

◆ reference_T

◆ thermal_conductivities

◆ equation_of_state

◆ drucker_prager_plasticity

◆ angle_of_internal_friction

◆ cohesion

◆ minimum_viscosity

◆ maximum_viscosity

◆ reference_strain_rate

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