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

Classes
struct	Formulation

Public Member Functions
void	initialize () override

bool	is_compressible () const override

void	evaluate (const typename Interface< dim >::MaterialModelInputs &in, typename Interface< dim >::MaterialModelOutputs &out) const override

double	enthalpy (const double temperature, const double pressure, const std::vector< double > &compositional_fields, const Point< dim > &position) const

std::array< std::pair< double, unsigned int >, 2 >	enthalpy_derivative (const typename Interface< dim >::MaterialModelInputs &in) const

Public Member Functions inherited from aspect::MaterialModel::Interface< dim >
virtual void	evaluate (const MaterialModel::MaterialModelInputs< dim > &in, MaterialModel::MaterialModelOutputs< dim > &out) const =0

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	update ()

Public Member Functions inherited from aspect::SimulatorAccess< dim >
	SimulatorAccess ()

	SimulatorAccess (const Simulator< dim > &simulator_object)

virtual	~SimulatorAccess ()=default

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

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 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 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_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_worlds () const

const Particle::World< dim > &	get_particle_world (const unsigned int particle_world_index) const

Particle::World< dim > &	get_particle_world (const unsigned int particle_world_index)

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

Protected Types
enum	formats { perplex, hefesto }

Protected Member Functions
double	compute_partitioning_fraction (const double temperature) const

double	diffusion_viscosity (const double temperature, const double adiabatic_temperature, const double adiabatic_pressure, const double grain_size, const double second_strain_rate_invariant, const unsigned int phase_index) const

double	dislocation_viscosity (const double temperature, const double adiabatic_temperature, const double adiabatic_pressure, const SymmetricTensor< 2, dim > &strain_rate, const unsigned int phase_index, const double diffusion_viscosity, const double viscosity_guess=0) const

double	density (const double temperature, const double pressure, const std::vector< double > &compositional_fields, const Point< dim > &position) const

double	compressibility (const double temperature, const double pressure, const std::vector< double > &compositional_fields, const Point< dim > &position) const

double	specific_heat (const double temperature, const double pressure, const std::vector< double > &compositional_fields, const Point< dim > &position) const

double	thermal_expansion_coefficient (const double temperature, const double pressure, const std::vector< double > &compositional_fields, const Point< dim > &position) const

double	seismic_Vp (const double temperature, const double pressure, const std::vector< double > &compositional_fields, const Point< dim > &position) const

double	seismic_Vs (const double temperature, const double pressure, const std::vector< double > &compositional_fields, const Point< dim > &position) const

std::vector< std::vector< double > >	grain_size_change (const typename Interface< dim >::MaterialModelInputs &in, const std::vector< double > &adiabatic_pressure, const std::vector< unsigned int > &phase_indices) const

unsigned int	get_phase_index (const MaterialUtilities::PhaseFunctionInputs< dim > &in) const

Protected Attributes
double	reference_rho

double	reference_T

double	eta

double	thermal_alpha

double	reference_specific_heat

double	reference_compressibility

double	k_value

unsigned int	grain_size_index

std::vector< double >	grain_growth_activation_energy

std::vector< double >	grain_growth_activation_volume

std::vector< double >	grain_growth_rate_constant

std::vector< double >	grain_growth_exponent

double	minimum_grain_size

std::vector< double >	reciprocal_required_strain

std::vector< double >	recrystallized_grain_size

std::vector< double >	grain_boundary_energy

std::vector< double >	boundary_area_change_work_fraction

std::vector< double >	geometric_constant

Formulation::Kind	grain_size_evolution_formulation

double	grain_size_reduction_work_fraction_exponent

double	minimum_grain_size_reduction_work_fraction

double	maximum_grain_size_reduction_work_fraction

double	temperature_minimum_partitioning_power

double	temperature_maximum_partitioning_power

double	phase_distribution

double	roughness_to_grain_size

double	dislocation_viscosity_iteration_threshold

unsigned int	dislocation_viscosity_iteration_number

std::vector< double >	dislocation_creep_exponent

std::vector< double >	dislocation_activation_energy

std::vector< double >	dislocation_activation_volume

std::vector< double >	dislocation_creep_prefactor

std::vector< double >	diffusion_creep_exponent

std::vector< double >	diffusion_activation_energy

std::vector< double >	diffusion_activation_volume

std::vector< double >	diffusion_creep_prefactor

std::vector< double >	diffusion_creep_grain_size_exponent

double	max_temperature_dependence_of_eta

double	min_eta

double	max_eta

double	min_specific_heat

double	max_specific_heat

double	min_thermal_expansivity

double	max_thermal_expansivity

unsigned int	max_latent_heat_substeps

double	min_grain_size

unsigned int	n_phase_transitions

MaterialUtilities::PhaseFunction< dim >	phase_function

std::string	datadirectory

std::vector< std::string >	material_file_names

std::vector< std::string >	derivatives_file_names

unsigned int	n_material_data

bool	use_table_properties

bool	use_enthalpy

bool	use_bilinear_interpolation

enum aspect::MaterialModel::GrainSize::formats	material_file_format

std::vector< std::unique_ptr< MaterialModel::MaterialUtilities::Lookup::MaterialLookup > >	material_lookup

std::unique_ptr< FEPointEvaluation< 1, dim > >	temperature_evaluator

std::unique_ptr< FEPointEvaluation< 1, dim > >	pressure_evaluator

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

Private Attributes
bool	enable_drucker_prager_rheology

bool	use_adiabatic_pressure_for_yielding

Rheology::DruckerPrager< dim >	drucker_prager_plasticity

Rheology::DruckerPragerParameters	drucker_prager_parameters

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

void	create_additional_named_outputs (MaterialModel::MaterialModelOutputs< dim > &out) const 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)

Detailed Description

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

A material model that relies on compositional fields that stand for average grain sizes of a mineral phase and source terms for them that determine the grain size evolution in dependence of the strain rate, temperature, phase transitions, and the creep regime. This material model only works if a compositional field named 'grain_size' is present. In the diffusion creep regime, the viscosity depends on this grain size. We use the grain size evolution laws described in Behn et al., 2009. Implications of grain size evolution on the seismic structure of the oceanic upper mantle, Earth Planet. Sci. Letters, 282, 178–189. Other material parameters are either prescribed similar to the 'simple' material model, or read from data files that were generated by the Perplex or Hefesto software. The material model is described in more detail in Dannberg, J., Z. Eilon, U. Faul, R. Gassmöller, P. Moulik, and R. Myhill (2017), The importance of grain size to mantle dynamics and seismological observations, Geochem. Geophys. Geosyst., 18, 3034–3061, doi:10.1002/2017GC006944., which is the canonical reference for this material model.

Definition at line 93 of file grain_size.h.

Member Enumeration Documentation

§ formats

template<int dim>

enum aspect::MaterialModel::GrainSize::formats

protected

The format of the provided material files. Currently we support the PERPLEX and HeFESTo data formats.

Enumerator
perplex
hefesto

Definition at line 454 of file grain_size.h.

Member Function Documentation

§ initialize()

template<int dim>

void aspect::MaterialModel::GrainSize< dim >::initialize ( )

overridevirtual

Initialization function. Loads the material data and sets up pointers.

Reimplemented from aspect::Plugins::InterfaceBase.

§ is_compressible()

template<int dim>

bool aspect::MaterialModel::GrainSize< 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 >.

§ evaluate()

template<int dim>

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

override

§ declare_parameters()

template<int dim>

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

static

Declare the parameters this class takes through input files.

§ parse_parameters()

template<int dim>

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

overridevirtual

Read the parameters this class declares from the parameter file.

Reimplemented from aspect::Plugins::InterfaceBase.

§ create_additional_named_outputs()

template<int dim>

void aspect::MaterialModel::GrainSize< dim >::create_additional_named_outputs ( MaterialModel::MaterialModelOutputs< dim > & outputs ) const

overridevirtual

If this material model can produce additional named outputs that are derived from NamedAdditionalOutputs, create them in here. By default, this does nothing.

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

§ enthalpy()

template<int dim>

double aspect::MaterialModel::GrainSize< dim >::enthalpy	(	const double	temperature,
		const double	pressure,
		const std::vector< double > &	compositional_fields,
		const Point< dim > &	position
	)		const

Returns the enthalpy as calculated by HeFESTo.

§ enthalpy_derivative()

template<int dim>

std::array<std::pair<double, unsigned int>,2> aspect::MaterialModel::GrainSize< dim >::enthalpy_derivative ( const typename Interface< dim >::MaterialModelInputs & in ) const

Returns the cell-wise averaged enthalpy derivatives for the evaluate function and postprocessors. The function returns two pairs, the first one represents the temperature derivative, the second one the pressure derivative. The first member of each pair is the derivative, the second one the number of vertex combinations the function could use to compute the derivative. The second member is useful to handle the case no suitable combination of vertices could be found (e.g. if the temperature and pressure on all vertices of the current cell is identical.

§ compute_partitioning_fraction()

template<int dim>

double aspect::MaterialModel::GrainSize< dim >::compute_partitioning_fraction ( const double temperature ) const

protected

This function returns the fraction of shear heating energy partitioned into grain damage using the implementation by Mulyukova and Bercovici (2018) Collapse of passive margins by lithospheric damage and plunging grain size. Earth and Planetary Science Letters, 484, 341-352.

§ diffusion_viscosity()

template<int dim>

double aspect::MaterialModel::GrainSize< dim >::diffusion_viscosity	(	const double	temperature,
		const double	adiabatic_temperature,
		const double	adiabatic_pressure,
		const double	grain_size,
		const double	second_strain_rate_invariant,
		const unsigned int	phase_index
	)		const

protected

§ dislocation_viscosity()

template<int dim>

double aspect::MaterialModel::GrainSize< dim >::dislocation_viscosity	(	const double	temperature,
		const double	adiabatic_temperature,
		const double	adiabatic_pressure,
		const SymmetricTensor< 2, dim > &	strain_rate,
		const unsigned int	phase_index,
		const double	diffusion_viscosity,
		const double	viscosity_guess = `0`
	)		const

protected

This function calculates the dislocation viscosity. For this purpose we need the dislocation component of the strain rate, which we can only compute by knowing the dislocation viscosity. Therefore, we iteratively solve for the dislocation viscosity and update the dislocation strain rate in each iteration using the new value obtained for the dislocation viscosity. The iteration is started with a dislocation viscosity calculated for the whole strain rate unless a guess for the viscosity is provided, which can reduce the number of iterations significantly.

§ density()

template<int dim>

double aspect::MaterialModel::GrainSize< dim >::density	(	const double	temperature,
		const double	pressure,
		const std::vector< double > &	compositional_fields,
		const Point< dim > &	position
	)		const

protected

§ compressibility()

template<int dim>

double aspect::MaterialModel::GrainSize< dim >::compressibility	(	const double	temperature,
		const double	pressure,
		const std::vector< double > &	compositional_fields,
		const Point< dim > &	position
	)		const

protected

§ specific_heat()

template<int dim>

double aspect::MaterialModel::GrainSize< dim >::specific_heat	(	const double	temperature,
		const double	pressure,
		const std::vector< double > &	compositional_fields,
		const Point< dim > &	position
	)		const

protected

§ thermal_expansion_coefficient()

template<int dim>

double aspect::MaterialModel::GrainSize< dim >::thermal_expansion_coefficient	(	const double	temperature,
		const double	pressure,
		const std::vector< double > &	compositional_fields,
		const Point< dim > &	position
	)		const

protected

§ seismic_Vp()

template<int dim>

double aspect::MaterialModel::GrainSize< dim >::seismic_Vp	(	const double	temperature,
		const double	pressure,
		const std::vector< double > &	compositional_fields,
		const Point< dim > &	position
	)		const

protected

Returns the p-wave velocity as calculated by HeFESTo.

§ seismic_Vs()

template<int dim>

double aspect::MaterialModel::GrainSize< dim >::seismic_Vs	(	const double	temperature,
		const double	pressure,
		const std::vector< double > &	compositional_fields,
		const Point< dim > &	position
	)		const

protected

Returns the s-wave velocity as calculated by HeFESTo.

§ grain_size_change()

template<int dim>

std::vector<std::vector<double> > aspect::MaterialModel::GrainSize< dim >::grain_size_change	(	const typename Interface< dim >::MaterialModelInputs &	in,
		const std::vector< double > &	adiabatic_pressure,
		const std::vector< unsigned int > &	phase_indices
	)		const

protected

Rate of grain size growth (Ostwald ripening) or reduction (due to dynamic recrystallization and phase transformations) in dependence on temperature, pressure, strain rate, mineral phase and creep regime. We use the grain size growth laws as for example described in Behn, M. D., Hirth, G., & Elsenbeck, J. R. (2009). Implications of grain size evolution on the seismic structure of the oceanic upper mantle. Earth and Planetary Science Letters, 282(1), 178-189.

For the rate of grain size reduction due to dynamic crystallization there is the choice between the paleowattmeter (Austins and Evans, 2007) and the paleopiezometer (Hall and Parmentier, 2003) as described in the parameter use_paleowattmeter.

§ get_phase_index()

template<int dim>

unsigned int aspect::MaterialModel::GrainSize< dim >::get_phase_index ( const MaterialUtilities::PhaseFunctionInputs< dim > & in ) const

protected

Function that returns the phase for a given temperature, depth, pressure, and density gradient (which are all contained in the in argument). Because the function returns just the dominant phase, phase transitions are discrete in this material model (they have a zero width).

Member Data Documentation

§ reference_rho

template<int dim>

double aspect::MaterialModel::GrainSize< dim >::reference_rho

protected

Definition at line 164 of file grain_size.h.

§ reference_T

template<int dim>

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

protected

Definition at line 165 of file grain_size.h.

§ eta

template<int dim>

double aspect::MaterialModel::GrainSize< dim >::eta

protected

Definition at line 166 of file grain_size.h.

§ thermal_alpha

template<int dim>

double aspect::MaterialModel::GrainSize< dim >::thermal_alpha

protected

Definition at line 167 of file grain_size.h.

§ reference_specific_heat

template<int dim>

double aspect::MaterialModel::GrainSize< dim >::reference_specific_heat

protected

Definition at line 168 of file grain_size.h.

§ reference_compressibility

template<int dim>

double aspect::MaterialModel::GrainSize< dim >::reference_compressibility

protected

The constant compressibility.

Definition at line 173 of file grain_size.h.

§ k_value

template<int dim>

double aspect::MaterialModel::GrainSize< dim >::k_value

protected

The thermal conductivity.

Definition at line 178 of file grain_size.h.

§ grain_size_index

template<int dim>

unsigned int aspect::MaterialModel::GrainSize< dim >::grain_size_index

protected

The index of the compositional field that represents the grain size.

Definition at line 183 of file grain_size.h.

§ grain_growth_activation_energy

template<int dim>

std::vector<double> aspect::MaterialModel::GrainSize< dim >::grain_growth_activation_energy

protected

Parameters controlling the grain size evolution.

Definition at line 188 of file grain_size.h.

§ grain_growth_activation_volume

template<int dim>

std::vector<double> aspect::MaterialModel::GrainSize< dim >::grain_growth_activation_volume

protected

Definition at line 189 of file grain_size.h.

§ grain_growth_rate_constant

template<int dim>

std::vector<double> aspect::MaterialModel::GrainSize< dim >::grain_growth_rate_constant

protected

Definition at line 190 of file grain_size.h.

§ grain_growth_exponent

template<int dim>

std::vector<double> aspect::MaterialModel::GrainSize< dim >::grain_growth_exponent

protected

Definition at line 191 of file grain_size.h.

§ minimum_grain_size

template<int dim>

double aspect::MaterialModel::GrainSize< dim >::minimum_grain_size

protected

Definition at line 192 of file grain_size.h.

§ reciprocal_required_strain

template<int dim>

std::vector<double> aspect::MaterialModel::GrainSize< dim >::reciprocal_required_strain

protected

Definition at line 193 of file grain_size.h.

§ recrystallized_grain_size

template<int dim>

std::vector<double> aspect::MaterialModel::GrainSize< dim >::recrystallized_grain_size

protected

Definition at line 194 of file grain_size.h.

§ grain_boundary_energy

template<int dim>

std::vector<double> aspect::MaterialModel::GrainSize< dim >::grain_boundary_energy

protected

Parameters controlling the dynamic grain recrystallization.

Definition at line 199 of file grain_size.h.

§ boundary_area_change_work_fraction

template<int dim>

std::vector<double> aspect::MaterialModel::GrainSize< dim >::boundary_area_change_work_fraction

protected

Definition at line 200 of file grain_size.h.

§ geometric_constant

template<int dim>

std::vector<double> aspect::MaterialModel::GrainSize< dim >::geometric_constant

protected

Definition at line 201 of file grain_size.h.

§ grain_size_evolution_formulation

template<int dim>

Formulation::Kind aspect::MaterialModel::GrainSize< dim >::grain_size_evolution_formulation

protected

A variable that records the formulation of how to evolve grain size. See the type of this variable for a description of available options.

Definition at line 261 of file grain_size.h.

§ grain_size_reduction_work_fraction_exponent

template<int dim>

double aspect::MaterialModel::GrainSize< dim >::grain_size_reduction_work_fraction_exponent

protected

Parameters controlling the partitioning of energy into grain damage in the pinned state.

Definition at line 275 of file grain_size.h.

§ minimum_grain_size_reduction_work_fraction

template<int dim>

double aspect::MaterialModel::GrainSize< dim >::minimum_grain_size_reduction_work_fraction

protected

Definition at line 276 of file grain_size.h.

§ maximum_grain_size_reduction_work_fraction

template<int dim>

double aspect::MaterialModel::GrainSize< dim >::maximum_grain_size_reduction_work_fraction

protected

Definition at line 277 of file grain_size.h.

§ temperature_minimum_partitioning_power

template<int dim>

double aspect::MaterialModel::GrainSize< dim >::temperature_minimum_partitioning_power

protected

Definition at line 278 of file grain_size.h.

§ temperature_maximum_partitioning_power

template<int dim>

double aspect::MaterialModel::GrainSize< dim >::temperature_maximum_partitioning_power

protected

Definition at line 279 of file grain_size.h.

§ phase_distribution

template<int dim>

double aspect::MaterialModel::GrainSize< dim >::phase_distribution

protected

Functions and parameters controlling conversion from interface roughness to grain size, used in pinned state formulation of grain damage. This conversion depends on the proportion of the two mineral phases.

A detailed description of this approach can be found in Appendix H.1, in Equation (8) in the main manuscript, and in equation (F.28) of Bercovici, David, and Yanick Ricard (2012). Mechanisms for the generation of plate tectonics by two-phase grain-damage and pinning. Physics of the Earth and Planetary Interiors 202 (2012): 27-55.

Definition at line 291 of file grain_size.h.

§ roughness_to_grain_size

template<int dim>

double aspect::MaterialModel::GrainSize< dim >::roughness_to_grain_size

protected

The factor used to convert roughness into the equivalent mean grain size for a given volume fraction of a mineral in the two-phase damage model.

Definition at line 297 of file grain_size.h.

§ dislocation_viscosity_iteration_threshold

template<int dim>

double aspect::MaterialModel::GrainSize< dim >::dislocation_viscosity_iteration_threshold

protected

Parameters controlling the viscosity.

Definition at line 302 of file grain_size.h.

§ dislocation_viscosity_iteration_number

template<int dim>

unsigned int aspect::MaterialModel::GrainSize< dim >::dislocation_viscosity_iteration_number

protected

Definition at line 303 of file grain_size.h.

§ dislocation_creep_exponent

template<int dim>

std::vector<double> aspect::MaterialModel::GrainSize< dim >::dislocation_creep_exponent

protected

Definition at line 304 of file grain_size.h.

§ dislocation_activation_energy

template<int dim>

std::vector<double> aspect::MaterialModel::GrainSize< dim >::dislocation_activation_energy

protected

Definition at line 305 of file grain_size.h.

§ dislocation_activation_volume

template<int dim>

std::vector<double> aspect::MaterialModel::GrainSize< dim >::dislocation_activation_volume

protected

Definition at line 306 of file grain_size.h.

§ dislocation_creep_prefactor

template<int dim>

std::vector<double> aspect::MaterialModel::GrainSize< dim >::dislocation_creep_prefactor

protected

Definition at line 307 of file grain_size.h.

§ diffusion_creep_exponent

template<int dim>

std::vector<double> aspect::MaterialModel::GrainSize< dim >::diffusion_creep_exponent

protected

Definition at line 308 of file grain_size.h.

§ diffusion_activation_energy

template<int dim>

std::vector<double> aspect::MaterialModel::GrainSize< dim >::diffusion_activation_energy

protected

Definition at line 309 of file grain_size.h.

§ diffusion_activation_volume

template<int dim>

std::vector<double> aspect::MaterialModel::GrainSize< dim >::diffusion_activation_volume

protected

Definition at line 310 of file grain_size.h.

§ diffusion_creep_prefactor

template<int dim>

std::vector<double> aspect::MaterialModel::GrainSize< dim >::diffusion_creep_prefactor

protected

Definition at line 311 of file grain_size.h.

§ diffusion_creep_grain_size_exponent

template<int dim>

std::vector<double> aspect::MaterialModel::GrainSize< dim >::diffusion_creep_grain_size_exponent

protected

Definition at line 312 of file grain_size.h.

§ max_temperature_dependence_of_eta

template<int dim>

double aspect::MaterialModel::GrainSize< dim >::max_temperature_dependence_of_eta

protected

Because of the nonlinear nature of this material model many parameters need to be kept within bounds to ensure stability of the solution. These bounds can be adjusted as input parameters.

Definition at line 319 of file grain_size.h.

§ min_eta

template<int dim>

double aspect::MaterialModel::GrainSize< dim >::min_eta

protected

Definition at line 320 of file grain_size.h.

§ max_eta

template<int dim>

double aspect::MaterialModel::GrainSize< dim >::max_eta

protected

Definition at line 321 of file grain_size.h.

§ min_specific_heat

template<int dim>

double aspect::MaterialModel::GrainSize< dim >::min_specific_heat

protected

Definition at line 322 of file grain_size.h.

§ max_specific_heat

template<int dim>

double aspect::MaterialModel::GrainSize< dim >::max_specific_heat

protected

Definition at line 323 of file grain_size.h.

§ min_thermal_expansivity

template<int dim>

double aspect::MaterialModel::GrainSize< dim >::min_thermal_expansivity

protected

Definition at line 324 of file grain_size.h.

§ max_thermal_expansivity

template<int dim>

double aspect::MaterialModel::GrainSize< dim >::max_thermal_expansivity

protected

Definition at line 325 of file grain_size.h.

§ max_latent_heat_substeps

template<int dim>

unsigned int aspect::MaterialModel::GrainSize< dim >::max_latent_heat_substeps

protected

Definition at line 326 of file grain_size.h.

§ min_grain_size

template<int dim>

double aspect::MaterialModel::GrainSize< dim >::min_grain_size

protected

Definition at line 327 of file grain_size.h.

§ n_phase_transitions

template<int dim>

unsigned int aspect::MaterialModel::GrainSize< dim >::n_phase_transitions

protected

Number of phase transitions for the one chemical composition used in this model.

Definition at line 426 of file grain_size.h.

§ phase_function

template<int dim>

MaterialUtilities::PhaseFunction<dim> aspect::MaterialModel::GrainSize< dim >::phase_function

protected

Object that handles phase transitions. Allows it to compute the phase function for each individual phase transition in the model, given the temperature, pressure, depth, and density gradient.

Definition at line 434 of file grain_size.h.

§ datadirectory

template<int dim>

std::string aspect::MaterialModel::GrainSize< dim >::datadirectory

protected

The following variables are properties of the material files we read in.

Definition at line 441 of file grain_size.h.

§ material_file_names

template<int dim>

std::vector<std::string> aspect::MaterialModel::GrainSize< dim >::material_file_names

protected

Definition at line 442 of file grain_size.h.

§ derivatives_file_names

template<int dim>

std::vector<std::string> aspect::MaterialModel::GrainSize< dim >::derivatives_file_names

protected

Definition at line 443 of file grain_size.h.

§ n_material_data

template<int dim>

unsigned int aspect::MaterialModel::GrainSize< dim >::n_material_data

protected

Definition at line 444 of file grain_size.h.

§ use_table_properties

template<int dim>

bool aspect::MaterialModel::GrainSize< dim >::use_table_properties

protected

Definition at line 445 of file grain_size.h.

§ use_enthalpy

template<int dim>

bool aspect::MaterialModel::GrainSize< dim >::use_enthalpy

protected

Definition at line 446 of file grain_size.h.

§ use_bilinear_interpolation

template<int dim>

bool aspect::MaterialModel::GrainSize< dim >::use_bilinear_interpolation

protected

Definition at line 447 of file grain_size.h.

§ material_file_format

template<int dim>

enum aspect::MaterialModel::GrainSize::formats aspect::MaterialModel::GrainSize< dim >::material_file_format

protected

§ material_lookup

template<int dim>

std::vector<std::unique_ptr<MaterialModel::MaterialUtilities::Lookup::MaterialLookup> > aspect::MaterialModel::GrainSize< dim >::material_lookup

protected

List of pointers to objects that read and process data we get from material data files. There is one pointer/object per compositional field provided.

Definition at line 465 of file grain_size.h.

§ temperature_evaluator

template<int dim>

std::unique_ptr<FEPointEvaluation<1, dim> > aspect::MaterialModel::GrainSize< dim >::temperature_evaluator

mutableprotected

We cache the evaluators that are necessary to evaluate the temperature and pressure at the vertices of the current cell. By caching the evaluators, we can avoid recreating them every time we need them.

Definition at line 473 of file grain_size.h.

§ pressure_evaluator

template<int dim>

std::unique_ptr<FEPointEvaluation<1, dim> > aspect::MaterialModel::GrainSize< dim >::pressure_evaluator

mutableprotected

Definition at line 474 of file grain_size.h.

§ enable_drucker_prager_rheology

template<int dim>

bool aspect::MaterialModel::GrainSize< dim >::enable_drucker_prager_rheology

private

Definition at line 481 of file grain_size.h.

§ use_adiabatic_pressure_for_yielding

template<int dim>

bool aspect::MaterialModel::GrainSize< dim >::use_adiabatic_pressure_for_yielding

private

Definition at line 482 of file grain_size.h.

§ drucker_prager_plasticity

template<int dim>

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

private

Definition at line 483 of file grain_size.h.

§ drucker_prager_parameters

template<int dim>

Rheology::DruckerPragerParameters aspect::MaterialModel::GrainSize< dim >::drucker_prager_parameters

private

Definition at line 484 of file grain_size.h.

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

/home/bob/source/include/aspect/material_model/grain_size.h

Classes

Public Member Functions

Protected Types

Protected Member Functions

Protected Attributes

Private Attributes

Functions used in dealing with run-time parameters

Additional Inherited Members

Detailed Description

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

Member Enumeration Documentation

§ formats

Member Function Documentation

§ initialize()

§ is_compressible()

§ evaluate()

§ declare_parameters()

§ parse_parameters()

§ create_additional_named_outputs()

§ enthalpy()

§ enthalpy_derivative()

§ compute_partitioning_fraction()

§ diffusion_viscosity()

§ dislocation_viscosity()

§ density()

§ compressibility()

§ specific_heat()

§ thermal_expansion_coefficient()

§ seismic_Vp()

§ seismic_Vs()

§ grain_size_change()

§ get_phase_index()

Member Data Documentation

§ reference_rho

§ reference_T

§ eta

§ thermal_alpha

§ reference_specific_heat

§ reference_compressibility

§ k_value

§ grain_size_index

§ grain_growth_activation_energy

§ grain_growth_activation_volume

§ grain_growth_rate_constant

§ grain_growth_exponent

§ minimum_grain_size

§ reciprocal_required_strain

§ recrystallized_grain_size

§ grain_boundary_energy

§ boundary_area_change_work_fraction

§ geometric_constant

§ grain_size_evolution_formulation

§ grain_size_reduction_work_fraction_exponent

§ minimum_grain_size_reduction_work_fraction

§ maximum_grain_size_reduction_work_fraction

§ temperature_minimum_partitioning_power

§ temperature_maximum_partitioning_power

§ phase_distribution

§ roughness_to_grain_size

§ dislocation_viscosity_iteration_threshold

§ dislocation_viscosity_iteration_number

§ dislocation_creep_exponent

§ dislocation_activation_energy

§ dislocation_activation_volume

§ dislocation_creep_prefactor

§ diffusion_creep_exponent

§ diffusion_activation_energy

§ diffusion_activation_volume

§ diffusion_creep_prefactor

§ diffusion_creep_grain_size_exponent

§ max_temperature_dependence_of_eta

§ min_eta

§ max_eta

§ min_specific_heat

§ max_specific_heat

§ min_thermal_expansivity

§ max_thermal_expansivity

§ max_latent_heat_substeps

§ min_grain_size

§ n_phase_transitions

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