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

Public Member Functions

 ViscoPlastic ()
 
IsostrainViscosities calculate_isostrain_viscosities (const MaterialModel::MaterialModelInputs< dim > &in, const unsigned int i, const std::vector< double > &volume_fractions, 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 compute_viscosity_derivatives (const unsigned int point_index, const std::vector< double > &volume_fractions, const std::vector< double > &composition_viscosities, const MaterialModel::MaterialModelInputs< dim > &in, MaterialModel::MaterialModelOutputs< dim > &out, const std::vector< double > &phase_function_values=std::vector< double >(), const std::vector< unsigned int > &n_phases_per_composition=std::vector< unsigned int >()) const
 
ComponentMask get_volumetric_composition_mask () 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 >>())
 
void create_plastic_outputs (MaterialModel::MaterialModelOutputs< dim > &out) const
 
void fill_plastic_outputs (const unsigned int point_index, const std::vector< double > &volume_fractions, const bool plastic_yielding, const MaterialModel::MaterialModelInputs< dim > &in, MaterialModel::MaterialModelOutputs< dim > &out) 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)
 

Public Attributes

double ref_visc
 
double min_strain_rate
 
MaterialUtilities::CompositionalAveragingOperation viscosity_averaging
 
Rheology::StrainDependent< dim > strain_rheology
 
Rheology::Elasticity< dim > elastic_rheology
 
bool use_elasticity
 

Private Types

enum  ViscosityScheme { diffusion, dislocation, frank_kamenetskii, composite }
 
enum  YieldScheme { stress_limiter, drucker_prager }
 

Private Attributes

double ref_strain_rate
 
double min_visc
 
double max_visc
 
enum aspect::MaterialModel::Rheology::ViscoPlastic::ViscosityScheme viscous_flow_law
 
enum aspect::MaterialModel::Rheology::ViscoPlastic::YieldScheme yield_mechanism
 
bool allow_negative_pressures_in_plasticity
 
std::vector< double > exponents_stress_limiter
 
double adiabatic_temperature_gradient_for_viscosity
 
Rheology::DiffusionCreep< dim > diffusion_creep
 
Rheology::DislocationCreep< dim > dislocation_creep
 
std::unique_ptr< Rheology::FrankKamenetskii< dim > > frank_kamenetskii_rheology
 
bool use_peierls_creep
 
std::unique_ptr< Rheology::PeierlsCreep< dim > > peierls_creep
 
Rheology::ConstantViscosityPrefactors< dim > constant_viscosity_prefactors
 
Rheology::DruckerPrager< dim > drucker_prager_plasticity
 
Rheology::DruckerPragerParameters drucker_prager_parameters
 

Detailed Description

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

Definition at line 99 of file visco_plastic.h.

Member Enumeration Documentation

§ ViscosityScheme

Enumeration for selecting which type of viscous flow law to use. Select between diffusion, dislocation, frank_kamenetskii or composite.

Enumerator
diffusion 
dislocation 
frank_kamenetskii 
composite 

Definition at line 228 of file visco_plastic.h.

§ YieldScheme

Enumeration for selecting which type of yield mechanism to use. Select between Drucker Prager and stress limiter.

Enumerator
stress_limiter 
drucker_prager 

Definition at line 240 of file visco_plastic.h.

Constructor & Destructor Documentation

§ ViscoPlastic()

Constructor.

Member Function Documentation

§ calculate_isostrain_viscosities()

template<int dim>
IsostrainViscosities aspect::MaterialModel::Rheology::ViscoPlastic< dim >::calculate_isostrain_viscosities ( const MaterialModel::MaterialModelInputs< dim > &  in,
const unsigned int  i,
const std::vector< double > &  volume_fractions,
const std::vector< double > &  phase_function_values = std::vector< double >(),
const std::vector< unsigned int > &  n_phases_per_composition = std::vector< unsigned int >() 
) const

This function calculates viscosities assuming that all the compositional fields experience the same strain rate (isostrain).

§ compute_viscosity_derivatives()

template<int dim>
void aspect::MaterialModel::Rheology::ViscoPlastic< dim >::compute_viscosity_derivatives ( const unsigned int  point_index,
const std::vector< double > &  volume_fractions,
const std::vector< double > &  composition_viscosities,
const MaterialModel::MaterialModelInputs< dim > &  in,
MaterialModel::MaterialModelOutputs< dim > &  out,
const std::vector< double > &  phase_function_values = std::vector< double >(),
const std::vector< unsigned int > &  n_phases_per_composition = std::vector< unsigned int >() 
) const

A function that fills the viscosity derivatives in the MaterialModelOutputs object that is handed over, if they exist. Does nothing otherwise.

§ get_volumetric_composition_mask()

template<int dim>
ComponentMask aspect::MaterialModel::Rheology::ViscoPlastic< dim >::get_volumetric_composition_mask ( ) const

A function that returns a ComponentMask that represents all compositional fields that should be considered 'volumetric', that is representing a physical proportion of the material, e.g. volume fraction of peridotite (as opposed to non-volumetric quantities like the amount of finite-strain).

§ declare_parameters()

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

Declare the parameters this function takes through input files.

§ parse_parameters()

template<int dim>
void aspect::MaterialModel::Rheology::ViscoPlastic< 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 this class declares 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.

§ create_plastic_outputs()

template<int dim>
void aspect::MaterialModel::Rheology::ViscoPlastic< dim >::create_plastic_outputs ( MaterialModel::MaterialModelOutputs< dim > &  out) const

Create the additional material model outputs object that contains the plastic outputs.

§ fill_plastic_outputs()

template<int dim>
void aspect::MaterialModel::Rheology::ViscoPlastic< dim >::fill_plastic_outputs ( const unsigned int  point_index,
const std::vector< double > &  volume_fractions,
const bool  plastic_yielding,
const MaterialModel::MaterialModelInputs< dim > &  in,
MaterialModel::MaterialModelOutputs< dim > &  out 
) const

A function that fills the plastic additional output in the MaterialModelOutputs object that is handed over, if it exists. Does nothing otherwise.

Member Data Documentation

§ ref_visc

template<int dim>
double aspect::MaterialModel::Rheology::ViscoPlastic< dim >::ref_visc

Reference viscosity used by material models using this rheology.

Definition at line 181 of file visco_plastic.h.

§ min_strain_rate

template<int dim>
double aspect::MaterialModel::Rheology::ViscoPlastic< dim >::min_strain_rate

Minimum strain rate used to stabilize the strain rate dependent rheology.

Definition at line 186 of file visco_plastic.h.

§ viscosity_averaging

Enumeration for selecting which viscosity averaging scheme to use.

Definition at line 191 of file visco_plastic.h.

§ strain_rheology

template<int dim>
Rheology::StrainDependent<dim> aspect::MaterialModel::Rheology::ViscoPlastic< dim >::strain_rheology

Object for computing the strain dependence of the rheology model.

Definition at line 196 of file visco_plastic.h.

§ elastic_rheology

template<int dim>
Rheology::Elasticity<dim> aspect::MaterialModel::Rheology::ViscoPlastic< dim >::elastic_rheology

Object for computing viscoelastic viscosities and stresses.

Definition at line 201 of file visco_plastic.h.

§ use_elasticity

template<int dim>
bool aspect::MaterialModel::Rheology::ViscoPlastic< dim >::use_elasticity

Whether to include viscoelasticity in the constitutive formulation.

Definition at line 206 of file visco_plastic.h.

§ ref_strain_rate

template<int dim>
double aspect::MaterialModel::Rheology::ViscoPlastic< dim >::ref_strain_rate
private

Reference strain rate for the first non-linear iteration in the first time step.

Definition at line 215 of file visco_plastic.h.

§ min_visc

template<int dim>
double aspect::MaterialModel::Rheology::ViscoPlastic< dim >::min_visc
private

Minimum and maximum viscosities used to improve the stability of the rheology model.

Definition at line 221 of file visco_plastic.h.

§ max_visc

template<int dim>
double aspect::MaterialModel::Rheology::ViscoPlastic< dim >::max_visc
private

Definition at line 222 of file visco_plastic.h.

§ viscous_flow_law

§ yield_mechanism

§ allow_negative_pressures_in_plasticity

template<int dim>
bool aspect::MaterialModel::Rheology::ViscoPlastic< dim >::allow_negative_pressures_in_plasticity
private

Whether to allow negative pressures to be used in the computation of plastic yield stresses and viscosities. If false, the minimum pressure in the plasticity formulation will be set to zero.

Definition at line 251 of file visco_plastic.h.

§ exponents_stress_limiter

template<int dim>
std::vector<double> aspect::MaterialModel::Rheology::ViscoPlastic< dim >::exponents_stress_limiter
private

List of exponents controlling the behaviour of the stress limiter yielding mechanism.

Definition at line 257 of file visco_plastic.h.

§ adiabatic_temperature_gradient_for_viscosity

template<int dim>
double aspect::MaterialModel::Rheology::ViscoPlastic< dim >::adiabatic_temperature_gradient_for_viscosity
private

Temperature gradient added to temperature used in the flow law.

Definition at line 262 of file visco_plastic.h.

§ diffusion_creep

template<int dim>
Rheology::DiffusionCreep<dim> aspect::MaterialModel::Rheology::ViscoPlastic< dim >::diffusion_creep
private

Objects for computing viscous creep viscosities.

Definition at line 267 of file visco_plastic.h.

§ dislocation_creep

template<int dim>
Rheology::DislocationCreep<dim> aspect::MaterialModel::Rheology::ViscoPlastic< dim >::dislocation_creep
private

Definition at line 268 of file visco_plastic.h.

§ frank_kamenetskii_rheology

template<int dim>
std::unique_ptr<Rheology::FrankKamenetskii<dim> > aspect::MaterialModel::Rheology::ViscoPlastic< dim >::frank_kamenetskii_rheology
private

Definition at line 269 of file visco_plastic.h.

§ use_peierls_creep

template<int dim>
bool aspect::MaterialModel::Rheology::ViscoPlastic< dim >::use_peierls_creep
private

Whether to include Peierls creep in the constitutive formulation.

Definition at line 274 of file visco_plastic.h.

§ peierls_creep

template<int dim>
std::unique_ptr<Rheology::PeierlsCreep<dim> > aspect::MaterialModel::Rheology::ViscoPlastic< dim >::peierls_creep
private

Object for computing Peierls creep viscosities.

Definition at line 279 of file visco_plastic.h.

§ constant_viscosity_prefactors

template<int dim>
Rheology::ConstantViscosityPrefactors<dim> aspect::MaterialModel::Rheology::ViscoPlastic< dim >::constant_viscosity_prefactors
private

Object for computing the viscosity multiplied by a constant prefactor. This multiplication step is done just prior to calculating the effective viscoelastic viscosity or plastic viscosity.

Definition at line 286 of file visco_plastic.h.

§ drucker_prager_plasticity

template<int dim>
Rheology::DruckerPrager<dim> aspect::MaterialModel::Rheology::ViscoPlastic< dim >::drucker_prager_plasticity
private

Definition at line 291 of file visco_plastic.h.

§ drucker_prager_parameters

template<int dim>
Rheology::DruckerPragerParameters aspect::MaterialModel::Rheology::ViscoPlastic< dim >::drucker_prager_parameters
private

Definition at line 296 of file visco_plastic.h.


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